uip or processes

「uip or processes」の構文とオプション - Orchestrator内の実行可能なプロセスへのパッケージのフォルダー バインドを管理します。

uip or processes は、パッケージの実行可能なフォルダーへのバインド (Orchestrator の内部では「リリース」) を管理します。プロセスは、uip or jobs startが目標とするものです。パッケージは、基になる.nupkg成果物です (uip or packagesを参照)。

概要

uip or processes <verb> [options]

動詞

動詞	目的
list	フォルダー内のプロセスのリストを取得します。
get	引数スキーマと保持期間を含むキーで 1 つのプロセスを取得する
resources	List package resources (queues, assets, buckets, connections) required by a process.
version-history	List the chronological package-version history for a process.
create	パッケージを新しいプロセスとしてフォルダーにバインドします。
update-version	1 つ以上のプロセスを最新の (または特定の) パッケージ バージョンにバンプします。
update (alias edit)	Update process settings (PATCH semantics on selected fields).
delete	Delete a process binding by key (does not delete the package).
rollback	プロセスを以前のパッケージ バージョンにロールバックします。

uip or processes list

フォルダー内のプロセスのリストを取得します。--folder-path または --folder-keyが必要です。プロセス キー (GUID)、名前、バージョン、および基本メタデータを返します。

オプション

Short	長押し	値 (Value)	既定 (Default)	説明
—	--folder-path	パス	—	パスによるターゲット フォルダー
—	--folder-key	GUID	—	キーによるターゲット フォルダー。
—	--all-folders	フラグ	無効	Tenant-wide listing. Mutually exclusive with --folder-path/--folder-key.
-n	--name	text	—	プロセス名に一致する値を含む。
—	--process-type	ENUM	—	Process、 Agent、 Flow、 TestAutomationProcess、 WebApp、 Api、 MCPServer、 BusinessRules、 CaseManagement、 Function。
—	--all-fields	フラグ	無効	完全な API ペイロードを返します。
-l	--limit	Number	50	ページ サイズ
—	--offset	Number	0	カウントをスキップします。
—	--sort-by	フィールド	Id desc	OData の並べ替え。

例

uip or processes list --folder-path "Shared"
uip or processes list --folder-path "Shared" --process-type Agent
uip or processes list --folder-path "Shared" \
    --output-filter 'Data[].{key:Key, name:Name, v:ProcessVersion}'

# Tenant-wide audit across every folder
uip or processes list --all-folders --name "Invoice"

データシェイプ(--output json)

{
  "Code": "ProcessList",
  "Data": [
    {
      "Key": "c3d4e5f6-0000-0000-0000-000000000001",
      "Name": "InvoiceProcessing",
      "ProcessKey": "InvoiceProcessing",
      "ProcessVersion": "1.0.2",
      "Description": "",
      "IsLatestVersion": true,
      "RetentionPeriod": 30,
      "RetentionAction": "Delete"
    }
  ],
  "Pagination": { "Returned": 1, "Limit": 50, "Offset": 0, "HasMore": false }
}

FolderId is added to each row only when --all-folders is used.

uip or processes get

GUID キーで 1 つのプロセスを取得します。バージョン、エントリ ポイント、入力/出力引数のスキーマ、プロセスの種類、および設定を返します。フォルダー コンテキストは不要 — キーはフォルダーをまたいで解決されます。

引数

名前	Required	目的
<process-key>	○	プロセス キー (GUID)。[ processes list] で検索します。

オプション

Short	長押し	値 (Value)	既定 (Default)	説明
—	--all-fields	フラグ	無効	完全な API ペイロードを返します。

例

uip or processes get c3d4e5f6-0000-0000-0000-000000000001
uip or processes get c3d4e5f6-0000-0000-0000-000000000001 --all-fields
uip or processes get c3d4e5f6-0000-0000-0000-000000000001 \
    --output-filter 'Data.InputArguments'

データシェイプ(--output json)

{
  "Code": "ProcessGet",
  "Data": {
    "Key": "c3d4e5f6-0000-0000-0000-000000000001",
    "Name": "InvoiceProcessing",
    "ProcessKey": "InvoiceProcessing",
    "ProcessVersion": "1.0.2",
    "Description": "Processes vendor invoices",
    "IsLatestVersion": true,
    "ProcessType": "Process",
    "EntryPointPath": "Main.xaml",
    "InputArguments": "{\"invoicePath\":\"String\"}",
    "FolderKey": "a1b2c3d4-0000-0000-0000-000000000001",
    "FolderPath": "Shared",
    "AutoUpdate": false,
    "TargetFramework": "Windows",
    "JobPriority": "Normal",
    "SpecificPriorityValue": 50,
    "RetentionPeriod": 30,
    "RetentionAction": "Delete",
    "StaleRetentionPeriod": 0,
    "StaleRetentionAction": "None",
    "HiddenForAttendedUser": false,
    "AutoCreateConnectedTriggers": false
  }
}

uip or processes resources

List package resources — queues, assets, buckets, connections, and other package requirements — referenced by a process. Resolves the process's folder automatically; no folder flag needed.

引数

名前	Required	目的
<process-key>	○	プロセス キー (GUID)。[ processes list] で検索します。

オプション

Short	長押し	値 (Value)	既定 (Default)	説明
—	--all-fields	フラグ	無効	選定された概要ではなく、完全な API ペイロードを返します。

例

uip or processes resources c3d4e5f6-0000-0000-0000-000000000001
uip or processes resources c3d4e5f6-0000-0000-0000-000000000001 --all-fields

データシェイプ(--output json)

{
  "Code": "ProcessResources",
  "Data": [
    {
      "ResourceType": "Queue",
      "ResourceName": "InvoiceQueue",
      "FolderPath": "Shared",
      "ValidationResult": "Success",
      "ValidationError": "",
      "IsOverwritable": true,
      "ResourceKey": "InvoiceQueue",
      "ResourceId": "123456",
      "Id": 0
    }
  ]
}

uip or processes version-history

List the chronological package-version history associated with a process. Folder is optional — if not provided, it is inferred from the process key.

引数

名前	Required	目的
<process-key>	○	プロセス キー (GUID)。

オプション

Short	長押し	値 (Value)	既定 (Default)	説明
—	--folder-path	パス	推論	自動検出をスキップしてこのフォルダーを使用します。
—	--folder-key	GUID	推論	自動検出をスキップしてこのフォルダーを使用します。
—	--all-fields	フラグ	無効	選定された概要ではなく、完全な API ペイロードを返します。

例

uip or processes version-history c3d4e5f6-0000-0000-0000-000000000001

データシェイプ(--output json)

{
  "Code": "ProcessVersionHistory",
  "Data": [
    {
      "Version": "1.0.0",
      "CreatedAt": "2024-01-10T08:30:00.000Z",
      "ReleaseName": "InvoiceProcessing",
      "ReleaseId": 101,
      "Id": 1001
    },
    {
      "Version": "1.0.2",
      "CreatedAt": "2024-01-15T09:45:00.000Z",
      "ReleaseName": "InvoiceProcessing",
      "ReleaseId": 101,
      "Id": 1002
    }
  ]
}

uip or processes create

パッケージをプロセスとしてフォルダーにバインドします。--folder-path または --folder-key 個と、3 つの必須パッケージ オプションが必要です。パッケージ キーには [ uip or packages list ] を使用し、利用可能なバージョンには [ uip or packages versions ] を使用します。

オプション

Required

Short	長押し	値 (Value)	既定 (Default)	説明
—	--name	text	—	フォルダー内のプロセス名。
—	--package-key	text	—	パッケージ キー (packages listPackageId) です。
—	--package-version	version	—	パッケージ バージョン (例: 1.0.0

ID とスコープ

Short	長押し	値 (Value)	既定 (Default)	説明
—	--folder-path	パス	—	パスによるターゲット フォルダー
—	--folder-key	GUID	—	キーによるターゲット フォルダー。

プロセスの設定

Short	長押し	値 (Value)	既定 (Default)	説明
—	--description	text	—	プロセスの説明。
—	--entry-point	パス	—	エントリ ポイントのワークフロー パス (マルチエントリ ポイント パッケージの場合)
—	--input-arguments	JSON	—	既定の入力引数は JSON です。
—	--job-priority	ENUM	—	Low、 Normal、 Highです。--specific-priorityと相互に排他的です。
—	--specific-priority	1–100	—	優先度の数値。--job-priorityと相互に排他的です。
—	--robot-size	ENUM	—	Cloud ロボットのサイズ: Small、Standard、Medium、Large
—	--tags	CSV	—	コンマ区切りのタグ名。
—	--environment-variables	text	—	Environment variables as newline-separated KEY=VALUE pairs (not JSON), e.g. $'FOO=bar\nBAZ=qux'.
—	--auto-update / --no-auto-update	フラグ	—	最新のパッケージ バージョンへの自動更新を有効化/無効化します。
—	--hidden-for-attended / --visible-for-attended	フラグ	—	有人オートメーションのユーザーに表示しないでほしい相互に排他的です。
—	--auto-create-triggers / --no-auto-create-triggers	フラグ	—	デプロイ時に接続トリガーを自動作成

retention

Short	長押し	値 (Value)	既定 (Default)	説明
—	--retention-period	日(1〜180)	30	ジョブの保持期間。
—	--retention-action	ENUM	Delete	Delete、 Archive、または Noneのいずれかです。
—	--retention-bucket	バケット ID	—	ストレージ バケット ID。--retention-action Archive時に必須です。
—	--stale-retention-period	日	—	古いジョブの保持期間。
—	--stale-retention-action	ENUM	—	Delete、 Archive、または Noneのいずれかです。

例

uip or processes create --folder-path "Shared" \
    --name "InvoiceProcessing" \
    --package-key InvoiceProcessing --package-version 1.0.2

uip or processes create --folder-path "Production/EU" \
    --name "InvoiceProcessing" --package-key InvoiceProcessing --package-version 1.0.2 \
    --job-priority High --auto-update --tags "finance,eu"

uip or processes create --folder-path "Shared" \
    --name "InvoiceProcessing" --package-key InvoiceProcessing --package-version 1.0.2 \
    --output-filter 'Data.Key'

データシェイプ(--output json)

{
  "Code": "ProcessCreated",
  "Data": {
    "Key": "c3d4e5f6-0000-0000-0000-000000000010",
    "Name": "InvoiceProcessing",
    "ProcessKey": "InvoiceProcessing",
    "ProcessVersion": "1.0.2",
    "Description": "",
    "IsLatestVersion": true,
    "RetentionPeriod": 30,
    "RetentionAction": "Delete"
  }
}

uip or processes update-version

1 つ以上のプロセスを最新のパッケージ バージョンに更新するか、 --package-versionを使用して特定のバージョンに更新します。フォルダーは任意です — 指定しない場合は、最初のプロセス キーから推論されます。

• 1 つのキー + --package-version →なし、最新に更新 (単一の API 呼び出し)。
• 1 つのキー + --package-version → つのバージョンへの更新 (単一の API 呼び出し)。
• 複数のキー + --package-version →なし、最新の状態に一括更新。
• 複数のキー + --package-version →拒否 (検証エラー)

実行中のジョブは影響を受けません。更新されたバージョンを使用するのは新しいジョブのみです。

引数

名前	Required	目的
<process-keys...>	○	1 つ以上のプロセス キー (GUID)。

オプション

Short	長押し	値 (Value)	既定 (Default)	説明
—	--folder-path	パス	推論	自動検出をスキップしてこのフォルダーを使用します。
—	--folder-key	GUID	推論	自動検出をスキップしてこのフォルダーを使用します。
—	--package-version	version	—	特定のバージョン。単一のキーでのみ有効です。

例

uip or processes update-version c3d4e5f6-0000-0000-0000-000000000001

uip or processes update-version c3d4e5f6-0000-0000-0000-000000000001 \
    --package-version 1.0.3

uip or processes update-version \
    c3d4e5f6-0000-0000-0000-000000000001 \
    c3d4e5f6-0000-0000-0000-000000000002 \
    --output-filter 'Data.Version'

データシェイプ(--output json)

シングルキー:

{
  "Code": "ProcessVersionUpdated",
  "Data": { "ProcessKey": "c3d4e5f6-…-000001", "Version": "latest" }
}

一括処理は、ProcessKeys、Version、および API からエコーされた Result オブジェクトを含むCode: "ProcessVersionsUpdated"を返します。

uip or processes update

Update process settings by key. Reads current values, applies the PATCH fields provided, and saves. Only provided fields are changed; fields omitted on the CLI are preserved from the current state. No folder flag needed — the key resolves cross-folder.

edit is a registered alias for this verb — uip or processes edit works identically to uip or processes update.

引数

名前	Required	目的
<process-key>	○	プロセス キー (GUID)。

オプション

processes create つの必須パッケージ オプションとスコープ フラグ以外はフィールドと同じです。相互排除ルールと検証ルールが一致している create (--job-priority と --specific-priorityの比較、 --hidden-for-attended と --visible-for-attended、保持期間 Archive --retention-bucket)。

Short	長押し	値 (Value)	既定 (Default)	説明
-n	--name	text	—	新しい表示名。
-d	--description	text	—	新しい説明。
—	--entry-point	パス	—	新しいエントリ ポイント パス。
—	--input-arguments	JSON	—	既定の入力引数です。
—	--environment-variables	text	—	Newline-separated KEY=VALUE pairs (not JSON). Pass '' to clear them.
—	--job-priority	ENUM	—	Low、 Normal、 Highです。
—	--specific-priority	1–100	—	優先度の数値。
—	--auto-update / --no-auto-update	フラグ	—	自動更新を切り替えます。
—	--hidden-for-attended / --visible-for-attended	フラグ	—	有人シナリオの表示。
—	--auto-create-triggers / --no-auto-create-triggers	フラグ	—	接続トリガーによる自動作成
—	--healing-agent / --no-healing-agent	フラグ	—	Enable or disable Healing Agent (Autopilot for Robots) for this process. Future jobs use it by default once enabled; tenant-level Autopilot must already be on.
—	--retention-period	日(1〜180)	—	ジョブの保持期間。
—	--retention-action	ENUM	—	Delete、 Archive、 Noneです。
—	--retention-bucket	バケット ID	—	--retention-action Archive時に必須です。
—	--stale-retention-period	日	—	古いジョブの保持期間。
—	--stale-retention-action	ENUM	—	Delete、 Archive、 Noneです。

例

uip or processes update c3d4e5f6-0000-0000-0000-000000000001 \
    --description "Monthly invoice batch"

uip or processes update c3d4e5f6-0000-0000-0000-000000000001 \
    --job-priority High --retention-period 60

uip or processes update c3d4e5f6-0000-0000-0000-000000000001 \
    --auto-update --output-filter 'Data.Status'

データシェイプ(--output json)

{
  "Code": "ProcessUpdated",
  "Data": {
    "Key": "c3d4e5f6-0000-0000-0000-000000000001",
    "Name": "InvoiceProcessing",
    "Status": "Updated successfully"
  }
}

uip or processes delete

Delete a process binding by key. This removes the release binding from its folder — it does not delete the underlying package.

引数

名前	Required	目的
<process-key>	○	プロセス キー (GUID)。[ processes list] で検索します。

オプション

Short	長押し	値 (Value)	既定 (Default)	説明
-y	--yes	フラグ	—	Required. Confirms this irreversible operation — the CLI never prompts.

例

uip or processes delete c3d4e5f6-0000-0000-0000-000000000001 --yes

データシェイプ(--output json)

{
  "Code": "ProcessDeleted",
  "Data": {
    "Key": "c3d4e5f6-0000-0000-0000-000000000001",
    "Name": "InvoiceProcessing",
    "ProcessKey": "InvoiceProcessing",
    "Status": "Deleted successfully"
  }
}

uip or processes rollback

プロセスを以前のパッケージ バージョンにロールバックします。フォルダーは任意です — 指定しない場合は、プロセス キーから推測されます。

引数

名前	Required	目的
<process-key>	○	プロセス キー (GUID)。

オプション

Short	長押し	値 (Value)	既定 (Default)	説明
—	--folder-path	パス	推論	自動検出をスキップします。
—	--folder-key	GUID	推論	自動検出をスキップします。

例

uip or processes rollback c3d4e5f6-0000-0000-0000-000000000001
uip or processes rollback c3d4e5f6-0000-0000-0000-000000000001 \
    --folder-path "Shared"
uip or processes rollback c3d4e5f6-0000-0000-0000-000000000001 \
    --output-filter 'Data.Status'

データシェイプ(--output json)

{
  "Code": "ProcessRolledBack",
  "Data": {
    "ProcessKey": "c3d4e5f6-0000-0000-0000-000000000001",
    "Status": "Rolled back to previous version"
  }
}

終了コード

「終了コード」を参照してください。標準の検証エラーを超える動詞固有のオーバーライドはありません。

関連コマンド

• uip or packages — processes createを呼び出す前に、パッケージキー ( 、packages list)、 バージョン ( 、packages versions)、およびエントリポイント (packages entry-points) を検索します。
• uip or jobs — 特に jobs startはプロセス キーを受け取ります。
• uip or folders — バインドする前にターゲット フォルダーを作成または検索します。

参照

• グローバル オプション。
• セッション。