uip 管理者 robot-accounts

「uip admin robot-accounts」、「uip admin pat」、「uip admin scopes」の構文とオプション — 人間以外の ID、個人用アクセス トークン、OAuth2 スコープの参照。

関連する独立した 3 つのコマンド グループ: robot-accounts (無人オートメーションに使用される人間以外のディレクトリ ID)、 pat (API 認証用の個人用アクセス トークン)、 scopes (外部アプリと PAT で利用可能なすべての OAuth2 スコープの読み取り専用参照)。

概要

uip admin robot-accounts list [--search <term>] [--sort-by <field>] [--sort-order asc|desc] [--limit <n>] [--offset <n>]
uip admin robot-accounts get <robot-account-id>
uip admin robot-accounts create <name> [--display-name <name>]
uip admin robot-accounts update <robot-account-id> --display-name <name>
uip admin robot-accounts delete <robot-account-id>

uip admin pat list [--scope all] [--search <term>] [--limit <n>] [--offset <n>]
uip admin pat create --description <text> --expiration <date> --scope <scopes>
uip admin pat revoke <id>
uip admin pat regenerate <id> --expiration <date>

uip admin scopes list

動詞

グループ	動詞	目的
robot-accounts	list	パーティション内のロボット アカウントのリストを取得します。
robot-accounts	get	ロボット アカウントの詳細を ID で取得します。
robot-accounts	create	新しいロボット アカウントを作成します。
robot-accounts	update	ロボット アカウントの表示名を更新する。
robot-accounts	delete	ロボット アカウントを ID で削除する。
pat	list	個人用アクセス トークン (自分のアクセス トークン、または組織の --scope allトークン) を一覧に含めます。
pat	create	新しい個人用アクセス トークンを作成します。
pat	revoke	トークンを取り消します。
pat	regenerate	新しい有効期限が切れたトークンを再生成します。
scopes	list	利用可能なすべての OAuth2 スコープをリソース別にグループ化して一覧にします。

uip 管理者 robot-accounts のリスト

パーティション内のロボット アカウントのリストを取得します。アカウント ID、名前、表示名、作成時刻を返します。

オプション

長押し	Short	値 (Value)	既定 (Default)	説明
--search <term>	-s	string	—	名前で検索する。
--sort-by <field>		string	—	フィールドを並べ替え (例:Nameです。
--sort-order <direction>		asc|desc	asc	並べ替え方向です。
--limit <number>	-l	integer	50	返すアイテムの数です。
--offset <number>		integer	0	スキップするアイテムの数です。

例

uip admin robot-accounts list --limit 5

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

{
  "Code": "RobotAccountList",
  "Data": [
    { "id": "a1b2c3d4-0000-0000-0000-000000000001", "name": "automation-bot", "displayName": "Automation Bot", "creationTime": "2026-01-15T10:00:00.000Z" }
  ]
}

uip admin robot-accounts get

ロボット アカウントの詳細を ID で取得します。

引数

名前	Required	目的
<robot-account-id>	○	ロボット アカウント ID (UUID)。

例

uip admin robot-accounts get a1b2c3d4-0000-0000-0000-000000000001

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

{ "Code": "RobotAccountDetails", "Data": { "id": "a1b2c3d4-0000-0000-0000-000000000001", "name": "automation-bot", "displayName": "Automation Bot", "creationTime": "2026-01-15T10:00:00.000Z", "groupIds": [] } }

uip admin robot-accounts 作成

パーティションに新しいロボット アカウントを作成します。

引数

名前	Required	目的
<name>	○	ロボット アカウント名。

オプション

長押し	値 (Value)	説明
--display-name <name>	string	表示名。省略すると既定で <name> に設定されます。

例

uip admin robot-accounts create "automation-bot" --display-name "Automation Bot"

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

{ "Code": "RobotAccountCreated", "Data": { "id": "a1b2c3d4-0000-0000-0000-000000000002", "name": "automation-bot", "displayName": "Automation Bot" } }

uip 管理者 robot - アカウントの更新

ロボット アカウントの表示名を更新する。--display-name は唯一のフィールドであり、事実上必須です。省略するとクライアント側では失敗します ("No fields to update")。

引数

名前	Required	目的
<robot-account-id>	○	ロボット アカウント ID (UUID)。

オプション

長押し	値 (Value)	Required	説明
--display-name <name>	string	○	新しい表示名。

例

uip admin robot-accounts update a1b2c3d4-0000-0000-0000-000000000001 --display-name "Updated Bot"

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

{ "Code": "RobotAccountUpdated" }

uip 管理者 robot-accounts の削除

ロボット アカウントを ID で削除する。

引数

名前	Required	目的
<robot-account-id>	○	ロボット アカウント ID (UUID)。

例

uip admin robot-accounts delete a1b2c3d4-0000-0000-0000-000000000001

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

{ "Code": "RobotAccountDeleted", "Data": { "Id": "a1b2c3d4-0000-0000-0000-000000000001", "Status": "Deleted successfully" } }

UIP 管理者の PAT リスト

個人用アクセス トークンを一覧表示します。既定では、自分のもののみが表示されます。 --scope all (管理者専用) には、組織内のすべてのトークンのリストが表示されます。

オプション

長押し	値 (Value)	説明
--scope <scope>	all	"all"のみが受け入れられます。それ以外の値は、明示的なエラーでクライアント側で失敗します。独自のトークンのみを一覧表示する場合は省略します。
--search <term>	string	ユーザーの検索語句でフィルター処理する--scopeが渡されない場合でも--scope allを意味します。
--limit <number> (-l)	integer	既定値は 50 です。返すアイテムの数です。
--offset <number>	integer	既定 0です。スキップする項目の数です。

例

uip admin pat list

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

{
  "Code": "PatList",
  "Data": [
    { "id": "a1b2c3d4-0000-0000-0000-000000000001", "description": "CI/CD token", "expiration": "2027-01-15T00:00:00.000Z", "scopes": ["OR.Folders.Read"] }
  ]
}

UIP 管理者 PAT 作成

新しい個人用アクセス トークンを作成します。トークン値は一度だけ返され、後で取得することはできません。

オプション

長押し	値 (Value)	Required	説明
--description <text>	string	○	トークンの説明です。
--expiration <date>	YYYY-MM-DD	○	有効期限。厳密に検証済み — 不正な形式の日付やカレンダーのロールオーバー (例:2027-02-30)。
--scope <scopes>	コンマ区切り	○	1 つ以上のスコープ (例:OR.Folders.Read,OR.Jobs.Readです。完全なカタログについては、 scopes list を参照してください。

例

uip admin pat create --description "CI/CD token" --expiration 2027-01-15 --scope "OR.Folders.Read,OR.Jobs.Read"

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

{ "Code": "PatCreated", "Data": { "Token": "...", "Warning": "Save this token now. It will not be shown again." } }

UIP 管理者 PAT 取り消し

個人用アクセス トークンを取り消します。

引数

名前	Required	目的
<id>	○	トークン ID (UUID)。pat listで検索する

例

uip admin pat revoke a1b2c3d4-0000-0000-0000-000000000001

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

{ "Code": "PatRevoked", "Data": { "Id": "a1b2c3d4-0000-0000-0000-000000000001", "Status": "Revoked successfully" } }

UIP 管理者 PAT 再生成

新しい有効期限を持つ個人用アクセス トークンを再生成します。createと同様に、新しいトークン値は 1 回だけ表示されます。

引数

名前	Required	目的
<id>	○	トークン ID (UUID)。

オプション

長押し	値 (Value)	Required	説明
--expiration <date>	YYYY-MM-DD	○	新しい有効期限。createと同じ厳密な検証です。

例

uip admin pat regenerate a1b2c3d4-0000-0000-0000-000000000001 --expiration 2028-01-15

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

{ "Code": "PatRegenerated", "Data": { "Id": "a1b2c3d4-0000-0000-0000-000000000001", "Token": "...", "Warning": "Save this token now. It will not be shown again." } }

[UIP 管理者スコープ] リスト

外部アプリと個人用アクセス トークンで利用可能なすべての OAuth2 スコープをリソース別にグループ化して一覧表示します。読み取り専用で、グローバルなオプション以外のオプションはありません。

例

uip admin scopes list

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

{
  "Code": "ScopesList",
  "Data": [
    {
      "name": "UiPath.Orchestrator",
      "displayName": "Orchestrator API Access",
      "scopes": [
        { "name": "OR.Folders", "displayName": "OR.Folders", "type": "user" }
      ]
    }
  ]
}

各スコープ エントリのtypeは、"user" (委任され、サインインしているユーザーが必要) または "application" (アプリ専用) です。これは、 の --user-scope/--app-scope フラグと pat createの --scope フラグexternal-apps create同じ区別です。

関連

• uip admin users — ディレクトリ ユーザーとディレクトリ グループ
• uip admin external-apps — 同じスコープ カタログを使用する OAuth2 クライアント登録。
• uip admin smtp — 組織のメールの設定です。

参照

• グローバル オプション
• 終了コード