UiPath Documentation
uipath-cli
latest
false
UiPath CLI ユーザー ガイド
重要 :
このコンテンツは機械翻訳によって処理されています。 新しいコンテンツの翻訳は、およそ 1 ~ 2 週間で公開されます。

UIP 管理者による監査

「uip admin audit」の構文とオプション。組織とテナントの範囲で UiPath 管理者監査イベントをクエリしてエクスポートし、組織の監査除外ルールを管理します。

uip admin audit UiPath 監査イベントのクエリとエクスポート — プラットフォーム レベルの管理者監査証跡です (Orchestrator エンティティの変更をカバーする uip or audit-logsとは異なります)。uip admin (概要) の一部である「UiPath 管理ツール」

2 つのスコープ サブグループは、同一の 3 動詞の読み取り図形 (sources、 events、 export) を登録します。

  • org — 組織範囲の監査 (テナントに依存しない管理者イベント)。
  • tenant — テナントを対象範囲とした監査 (アクティブなログイン、テナント、または --tenant-idを対象としたイベント)。

orgサブグループには、一致イベントの記録を停止するルールを管理するexclusionsサブグループもあります。テナント範囲の exclusions サブグループはありません。ルールは、それが適用されるテナントに --exclude-tenantで名前を付けます。

一般的なワークフロー: audit <scope> sources (ソース ID の検出) → audit <scope> events --source <guid> --from-date … --to-date … (行の検索) → audit <scope> export --from-date … --to-date … --output-path … (行のダウンロード)。

概要​

uip admin audit org sources [--login-validity <minutes>]
uip admin audit org events [--from-date <iso>] [--to-date <iso>] [--source <guid>...] [--target <guid>...] [--type <guid>...] [--user-id <guid>...] [--search <term>] [--status Success|Failure] [--limit <n>]
uip admin audit org export --from-date <iso> --to-date <iso> --output-path <dir> [--file-format json|csv]

uip admin audit tenant sources [--tenant-id <guid>] [--login-validity <minutes>]
uip admin audit tenant events [--tenant-id <guid>] [... same filters as org events]
uip admin audit tenant export [--tenant-id <guid>] --from-date <iso> --to-date <iso> --output-path <dir> [--file-format json|csv]

uip admin audit org exclusions list
uip admin audit org exclusions get <rule>
uip admin audit org exclusions create --name <name> [--exclude-tenant <guid>...] [--source <guid>...] [--target <guid>...] [--type <guid>...] [--status Success|Failure] [--inactive]
uip admin audit org exclusions create --file <path>
uip admin audit org exclusions update <rule> --name <name> [selector flags as for create] [--inactive]
uip admin audit org exclusions update <rule> --file <path>
uip admin audit org exclusions delete <rule>
uip admin audit org sources [--login-validity <minutes>]
uip admin audit org events [--from-date <iso>] [--to-date <iso>] [--source <guid>...] [--target <guid>...] [--type <guid>...] [--user-id <guid>...] [--search <term>] [--status Success|Failure] [--limit <n>]
uip admin audit org export --from-date <iso> --to-date <iso> --output-path <dir> [--file-format json|csv]

uip admin audit tenant sources [--tenant-id <guid>] [--login-validity <minutes>]
uip admin audit tenant events [--tenant-id <guid>] [... same filters as org events]
uip admin audit tenant export [--tenant-id <guid>] --from-date <iso> --to-date <iso> --output-path <dir> [--file-format json|csv]

uip admin audit org exclusions list
uip admin audit org exclusions get <rule>
uip admin audit org exclusions create --name <name> [--exclude-tenant <guid>...] [--source <guid>...] [--target <guid>...] [--type <guid>...] [--status Success|Failure] [--inactive]
uip admin audit org exclusions create --file <path>
uip admin audit org exclusions update <rule> --name <name> [selector flags as for create] [--inactive]
uip admin audit org exclusions update <rule> --file <path>
uip admin audit org exclusions delete <rule>

tenant 動詞はさらに、ログイン コンテキストからテナントを上書きする --tenant-id <guid> を受け入れます。 org 動詞はそうしません (組織の範囲には上書きするテナントがありません)。

[UIP 管理者監査] 組織のソース/[UIP 管理者監査] のテナントのソース​

このスコープに表示される監査イベント ソースを一覧表示します。各ソースは最上位のイベント カテゴリです (例: Identity、 Tenant、 Robot)。返された Id 値は events --source <guid>とします。

オプション​

長押し値 (Value)説明
--tenant-id <guid>GUID(tenant スコープのみ)ログイン コンテキストからテナントを上書きします。
--login-validity <minutes>integerこの呼び出しの対話型ログイン トークンの有効期間を上書きします。必要になることはほとんどありません。
uip admin audit org sources
uip admin audit org sources

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

{
  "Code": "AuditOrgSources",
  "Data": [
    { "Id": "11111111-1111-1111-1111-111111111111", "Name": "Identity", "EventTargets": [] }
  ]
}
{
  "Code": "AuditOrgSources",
  "Data": [
    { "Id": "11111111-1111-1111-1111-111111111111", "Name": "Identity", "EventTargets": [] }
  ]
}

Codeは tenantでAuditTenantSourcesされています。

[UIP 管理者監査] 組織イベント/[UIP 管理者監査テナント イベント]​

このスコープで監査イベントをページ分割してクエリを実行します。{ AuditEvents, Next, Previous }を返します。ベア配列ではありません。カーソルの名前は時系列です。 Next は新しいイベントで、 Previous 古いイベントです。--limitが 200 を超えると、サーバーは各呼び出しを 200 行にクランプするため、CLI は内部的に (古いイベント カーソルに従って) ページネーションを行います。

オプション​

長押し値 (Value)説明
--from-date <iso>ISO8601認証取得間隔の開始。包括的。
--to-date <iso>ISO8601認証取得間隔の終了包括的。
--source <guid>GUID、繰り返し可能イベント ソース ID でフィルター処理します。sourcesで発見する
--target <guid>GUID、繰り返し可能イベント ターゲット ID でフィルター処理します。
--type <guid>GUID、繰り返し可能イベントの種類の ID でフィルター処理します。
--user-id <guid>GUID、繰り返し可能動作するユーザー ID でフィルター処理します。
--search <term>stringサーバー側の部分文字列検索。
--status <status>Success | Failure大文字と小文字を区別しないイベント ステータス フィルターです。
--limit <n>integer返される予定の合計 (1 から 10000)200 を超える値は、クライアント側でページ分割されます (サーバーは各呼び出しを 200 にクランプします)。
--tenant-id <guid>GUID(tenant スコープのみ)ログイン コンテキストからテナントを上書きします。
--login-validity <minutes>integerこの呼び出しの対話型ログイン トークンの有効期間を上書きします。必要になることはほとんどありません。
# Fetch the latest 50 org audit events
uip admin audit org events --limit 50
# Fetch the latest 50 org audit events
uip admin audit org events --limit 50
# Filter by source and a 7-day window
uip admin audit tenant events --source 11111111-1111-1111-1111-111111111111 \
  --from-date 2026-04-22T00:00:00Z --to-date 2026-04-29T00:00:00Z
# Filter by source and a 7-day window
uip admin audit tenant events --source 11111111-1111-1111-1111-111111111111 \
  --from-date 2026-04-22T00:00:00Z --to-date 2026-04-29T00:00:00Z

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

{
  "Code": "AuditOrgEvents",
  "Data": { "AuditEvents": [], "Next": null, "Previous": null }
}
{
  "Code": "AuditOrgEvents",
  "Data": { "AuditEvents": [], "Next": null, "Previous": null }
}

Codeは tenantでAuditTenantEventsされています。

[UIP 管理者監査] 組織のエクスポート / [UIP 管理者監査] テナントのエクスポート​

長期ストアから監査イベントをエクスポートします。[--from-date, --to-date]内で UTC 日ごとに 1 つの HTTP 呼び出しを発行し、何かを書き出す前に結果をメモリに集約します — ウィンドウ全体が最初に取得され、1 日失敗するとエクスポートはアトミックに中止されます (何も書き込まれず、失敗した日に名前が付けられます)。

--output-path はファイル パスではなく ベース ディレクトリです。フォルダーを渡すと、CLI はその中に一意の名前の付いた出力を生成し、ウィンドウと生成時刻がスタンプされます (例:audit_2026-01-01_2026-02-01_20260617T112630)、同じウィンドウを繰り返しエクスポートしても競合しないようにします。

  • --file-format json (既定) — UTC 日ごとに 1 つの JSON ファイルのフォルダー。
  • --file-format csv — すべてのイベントが共有ヘッダーの下に結合された 1 つの CSV ファイルです。

オプション​

長押し値 (Value)Required説明
--from-date <iso>ISO8601認証取得○間隔の開始。
--to-date <iso>ISO8601認証取得○間隔の終了
--output-path <dir>パス条件付きエクスポートのベース ディレクトリです (存在しない場合は作成されます)。ディレクトリのみを渡し、ファイル名は渡しません。CLI によって出力に名前が付けられます。代わりに --output-file (非推奨のエイリアス) を渡さない限り、必須です。
--output-file <dir>パス×--output-pathのエイリアスは非推奨です。名前にもかかわらず、引き続きベース ディレクトリとして扱われます。両方が合格すると、 --output-path が優先され、非推奨化の警告がログに記録されます。
--file-format <format>json | csv×出力図形。既定 jsonです。
--tenant-id <guid>GUID×(tenant スコープのみ)ログイン コンテキストからテナントを上書きします。
--login-validity <minutes>integer×この呼び出しの対話型ログイン トークンの有効期間を上書きします。必要になることはほとんどありません。
# JSON export — a timestamped folder of day-wise JSON files is created under the base dir
uip admin audit org export --from-date 2026-01-01 --to-date 2026-02-01 --output-path ./audit-exports
# JSON export — a timestamped folder of day-wise JSON files is created under the base dir
uip admin audit org export --from-date 2026-01-01 --to-date 2026-02-01 --output-path ./audit-exports
# CSV export — a single uniquely-named .csv file under the base dir
uip admin audit tenant export --from-date 2026-01-01 --to-date 2026-02-01 \
  --file-format csv --output-path ./audit-exports
# CSV export — a single uniquely-named .csv file under the base dir
uip admin audit tenant export --from-date 2026-01-01 --to-date 2026-02-01 \
  --file-format csv --output-path ./audit-exports

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

JSON 形式:

{
  "Code": "AuditOrgExport",
  "Data": {
    "Path": "./audit-exports/audit_2026-01-01_2026-02-01_20260617T112630",
    "Format": "json",
    "Files": 27,
    "Bytes": 12345,
    "Days": 31,
    "NonEmptyDays": 27,
    "GeneratedAt": "2026-06-17T11:26:30.000Z"
  }
}
{
  "Code": "AuditOrgExport",
  "Data": {
    "Path": "./audit-exports/audit_2026-01-01_2026-02-01_20260617T112630",
    "Format": "json",
    "Files": 27,
    "Bytes": 12345,
    "Days": 31,
    "NonEmptyDays": 27,
    "GeneratedAt": "2026-06-17T11:26:30.000Z"
  }
}

CSV 形式では、 の代わりに Events カウントが追加されますFiles

{
  "Code": "AuditOrgExport",
  "Data": {
    "Path": "./audit-exports/audit_2026-01-01_2026-02-01_20260617T112630.csv",
    "Format": "csv",
    "Bytes": 98765,
    "Days": 31,
    "NonEmptyDays": 27,
    "Events": 1234,
    "GeneratedAt": "2026-06-17T11:26:30.000Z"
  }
}
{
  "Code": "AuditOrgExport",
  "Data": {
    "Path": "./audit-exports/audit_2026-01-01_2026-02-01_20260617T112630.csv",
    "Format": "csv",
    "Bytes": 98765,
    "Days": 31,
    "NonEmptyDays": 27,
    "Events": 1234,
    "GeneratedAt": "2026-06-17T11:26:30.000Z"
  }
}

Codeは tenantでAuditTenantExportされています。

UIP 管理者による監査による組織の除外​

組織の監査除外ルールを管理する。このルールは、監査証跡によって記録を停止するイベントを定義します。

ルールは、ディメンションあたり最大で 1 つのセレクター ( Tenant、 EventSource、 EventTarget、 EventType、 Status) を持ちます。セレクター内の値は OR で、セレクターは AND で処理されます。 --type A --type B --status Success 、種類 A または種類 B の成功したイベントは除外されます。セレクターのないルールは、すべてのイベントを除外するため、拒否されます。

除外はルールがアクティブになったときに開始され、過去にさかのぼることはありません。すでにトレイルにあるイベントはそこにとどまり、ルールの一致セットを広げると、その除外の開始時刻がリセットされます。非アクティブなルールでは何も除外されないため、置換されるルールの横に置換をステージングできます。

UiPath 独自の監視イベントや監査の設定の変更 (除外ルール自体の変更を含む) は、決して除外することはできません。

get、 update、および delete は、ルールの名前またはポリシー ID という <rule> 位置を取ります。名前は、アクティブなルール間でのみ一意です。非アクティブなルールが名前を共有する場合、CLI はポリシー ID を選択するのではなく、ポリシー ID を要求します。GUID の形をしたルール名は拒否されます。

ルールを読み取るには、監査読み取り権限が必要です。ルールを作成、更新、削除するには、ID が Administrators グループに属するユーザー トークンが必要です。サービス間トークンは書き込み時に拒否されます。

書き込みオプション (作成および更新)​

create と update は同じオプションを受け入れます。--file フラグまたはインライン フラグのいずれかを渡します。両方を渡すことはできません。

長押し値 (Value)説明
--name <name>string組織のアクティブなルールの中で一意のルール名です。最大 256 文字です。--fileが合格しない限り必須です。
--exclude-tenant <guid...>GUID、繰り返し可能Tenant セレクター: これらのテナントのイベントのみから除外します。組織外のテナントは受け入れられますが、一致するものは何もありません。
--source <guid...>GUID、繰り返し可能EventSource セレクター。uip admin audit org sourcesで ID を検出します。
--target <guid...>GUID、繰り返し可能EventTarget セレクター。uip admin audit org sourcesで ID を検出します。
--type <guid...>GUID、繰り返し可能EventType セレクター。uip admin audit org sourcesで ID を検出します。
--status <status>Success | FailureStatus セレクター、大文字と小文字を区別しません。0 と 1 も受け入れられます。単一値です。
--inactiveフラグルールをアクティブ化せずに保存します。非アクティブなルールは何も除外せず、アクティブなルールの名前または一致セットを再利用できます。
--file <path>パスルール本文全体を保持する JSON ファイルです。上記のフラグと相互に排他的です。
--login-validity <minutes>integerこの呼び出しの対話型ログイン トークンの有効期間を上書きします。必要になることはほとんどありません。

少なくとも 1 つのセレクター フラグを渡します。セレクターの値は GUID です ( --statusを除く)。

--file本文で使用できるのは、name、enforcement、isActive、selectors キーのみです。各セレクターは、 type (ディメンション名の 1 つ) と空ではない values 配列を持ちます。enforcement の既定値は Excludeのみで、 isActive 既定値は trueです。policyIdやタイムスタンプなど、サーバーが所有するフィールドは拒否されます。本文では Camelcase (キャメルケース) のフィールド名が使用されますが、 get と list では PascalCase (パスカルケース) キーが出力されるため、読み取ったルールから本文を作成するときは、フィールドの大文字と小文字を変更してください。

{
  "name": "Mute successful robot logins",
  "isActive": true,
  "selectors": [
    { "type": "EventType", "values": ["0f54d68a-15fd-427d-a86a-2812bb7fbb28"] },
    { "type": "Status", "values": ["Success"] }
  ]
}
{
  "name": "Mute successful robot logins",
  "isActive": true,
  "selectors": [
    { "type": "EventType", "values": ["0f54d68a-15fd-427d-a86a-2812bb7fbb28"] },
    { "type": "Status", "values": ["Success"] }
  ]
}

リスト (List)​

組織内のすべての除外ルールを名前順に一覧表示します。結果はページ分割されません。格納された定義を解析できないルールは、空の Selectors 配列でリストされるため、削除してもかまいません。

uip admin audit org exclusions list
uip admin audit org exclusions list

データ図形 (--output json):

{
  "Code": "AuditOrgExclusionsList",
  "Data": [
    {
      "PolicyId": "3f6b1d84-9a1e-4c2b-8e71-2f9c5d0a7b13",
      "Name": "Mute successful robot logins",
      "Enforcement": "Exclude",
      "IsActive": true,
      "ActivatedOn": "2026-09-17T09:14:22.000Z",
      "Selectors": [
        { "Type": "EventType", "Values": ["0f54d68a-15fd-427d-a86a-2812bb7fbb28"] },
        { "Type": "Status", "Values": ["Success"] }
      ],
      "CreatedOn": "2026-09-17T09:14:22.000Z",
      "LastModifiedOn": "2026-09-17T09:14:22.000Z"
    }
  ]
}
{
  "Code": "AuditOrgExclusionsList",
  "Data": [
    {
      "PolicyId": "3f6b1d84-9a1e-4c2b-8e71-2f9c5d0a7b13",
      "Name": "Mute successful robot logins",
      "Enforcement": "Exclude",
      "IsActive": true,
      "ActivatedOn": "2026-09-17T09:14:22.000Z",
      "Selectors": [
        { "Type": "EventType", "Values": ["0f54d68a-15fd-427d-a86a-2812bb7fbb28"] },
        { "Type": "Status", "Values": ["Success"] }
      ],
      "CreatedOn": "2026-09-17T09:14:22.000Z",
      "LastModifiedOn": "2026-09-17T09:14:22.000Z"
    }
  ]
}

除外ルールを 1 つ名前またはポリシー ID で読み取ります。

引数説明
<rule>ルール名、またはそのポリシー ID。
uip admin audit org exclusions get "Mute successful robot logins"
uip admin audit org exclusions get 3f6b1d84-9a1e-4c2b-8e71-2f9c5d0a7b13
uip admin audit org exclusions get "Mute successful robot logins"
uip admin audit org exclusions get 3f6b1d84-9a1e-4c2b-8e71-2f9c5d0a7b13

Dataの下に 1 つのルール オブジェクトを持つCode: AuditOrgExclusionsGetを、list エントリと同じ形式で返します。

作成​

除外ルールを作成します。渡さない限り、ルールはアクティブになります --inactive。別のアクティブなルールの名前が同じである場合、または新しいルールですでにすべてのイベントが除外されている場合、アクティブなルールは拒否されます。

# Stop recording successful events of one event type
uip admin audit org exclusions create --name "Mute successful robot logins" \
  --type 0f54d68a-15fd-427d-a86a-2812bb7fbb28 --status Success

# Stage a rule without activating it
uip admin audit org exclusions create --name "Staged" \
  --source 3f6b1d84-9a1e-4c2b-8e71-2f9c5d0a7b13 --inactive

# Create the rule from a JSON body
uip admin audit org exclusions create --file ./rule.json
# Stop recording successful events of one event type
uip admin audit org exclusions create --name "Mute successful robot logins" \
  --type 0f54d68a-15fd-427d-a86a-2812bb7fbb28 --status Success

# Stage a rule without activating it
uip admin audit org exclusions create --name "Staged" \
  --source 3f6b1d84-9a1e-4c2b-8e71-2f9c5d0a7b13 --inactive

# Create the rule from a JSON body
uip admin audit org exclusions create --file ./rule.json

Dataの下に作成されたルールでCode: AuditOrgExclusionsCreatedを返します。--inactive で作成したルールには、 IsActive: false と ActivatedOn: nullがあります。

更新​

除外ルールを完全に置き換える省略したセレクターはすべて削除されるため、ルールで保持されているすべてのフラグを再送信してください。最初に でルールを読み exclusions get。を --inactiveしないと、ルールは更新前に非アクティブであった場合でもアクティブとして保存されます。

ルールの名前を変更しても、そのルールの除外開始時刻は維持されます。一致するイベントを変更すると、その時刻がリセットされます。

引数説明
<rule>ルール名、またはそのポリシー ID。セレクター フラグの前に渡す: これらのフラグはリストを受け取るため、フラグの後に書き込まれた値は別のセレクター値として読み取られます。
uip admin audit org exclusions update "Mute successful robot logins" \
  --name "Mute successful robot logins" \
  --type 0f54d68a-15fd-427d-a86a-2812bb7fbb28 --status Success
uip admin audit org exclusions update "Mute successful robot logins" \
  --name "Mute successful robot logins" \
  --type 0f54d68a-15fd-427d-a86a-2812bb7fbb28 --status Success

置換されたルールとともに Code: AuditOrgExclusionsUpdated を Dataの下に返します。

削除​

除外ルールを削除します。ルールで除外されていたイベントは、その時点から再度記録されます。ルールがアクティブな間に抑制されたイベントは復元されません。

引数説明
<rule>ルール名、またはそのポリシー ID。
uip admin audit org exclusions delete "Mute successful robot logins"
uip admin audit org exclusions delete "Mute successful robot logins"

データ図形 (--output json):

{ "Code": "AuditOrgExclusionsDeleted", "Data": {} }
{ "Code": "AuditOrgExclusionsDeleted", "Data": {} }

トラブルシューティング​

  • HTTP 401 — トークンにAudit.Readスコープがない可能性があります。uip logout && uip loginを実行して、新しいトークンを鋳造します。
  • HTTP 403 — ログインしているユーザーには、このテナントに対する監査読み取り権限がありません。Automation Cloud でロールの割り当てを確認する。
  • Tenant ID required (テナント スコープ) — --tenant-id <guid>渡すか、最初にログインしてテナントを選択します。
  • エクスポート時にHTTP 504、または「<date>の監査エクスポートが失敗しました」 — 1 日分のチャンクがタイムアウトしました。再実行 — エクスポートはべき等です。問題が解決しない場合は、 --from-date/--to-date を絞り込んで失敗した日をスキップします。
  • "resolves outside the output folder" / エクスポート時に安全でないファイル名 — サーバーの応答の形式が正しくないことを示します。再実行し、問題が解決しない場合は報告してください。
  • uip admin — uip adminツール全体の概要です。
  • uip or audit-logs — Orchestrator エンティティの監査証跡です。この管理者レベルの監査とは異なる画面です。

参照​

このページは役に立ちましたか?

接続

ヘルプ リソース サポート(opens in new window)

学習する UiPath アカデミー(opens in new window)

質問する UiPath フォーラム(opens in new window)

最新情報を取得