> For the complete documentation index, see [llms.txt](https://docs.keeper.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.keeper.io/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/keeperpam-commands/pam-workflow-commands.md). # PAM Workflowコマンド PAMリソース向けのジャストインタイム (JIT) 特権アクセスワークフローを管理します。ワークフローは承認ベースのアクセス制御を適用し、 必要に応じて貸出/返却、MFA認証、時間帯によるアクセス制限を設定できます。 **サブコマンド** * 構成 * [作成](#pam-workflow-create) * [参照](#pam-workflow-read) * [更新](#pam-workflow-update) * [削除](#pam-workflow-delete) * [承認者の追加](#pam-workflow-add-approver) * [承認者の削除](#pam-workflow-remove-approver) * 承認者による操作 * [保留中リクエスト一覧](#pam-workflow-pending) * [承認](#pam-workflow-approve) * [拒否](#pam-workflow-deny) * リクエスト側の操作 * [リクエスト](#pam-workflow-request) * [開始 (貸出)](#pam-workflow-start) * [終了 (返却)](#pam-workflow-end) * 状態確認 * [状態](#pam-workflow-state) * [自分のアクセス状況](#pam-workflow-my-access) ## PAM Workflow createコマンド PAMレコードのワークフロー設定を作成します。承認が必要な場合は、少なくとも1人の承認者を追加する必要があります。
DotNet CLI **コマンド**: `pam-workflow create` **別名**: `pam-wf c` **パラメーター**:
パラメーター説明
<record>レコードのUIDまたはレコード名/タイトル。必須。
-n, --approvals-needed <int>アクセスが許可されるまでに必要な承認数。デフォルト: 1。0以上を指定 (0の場合は承認不要)。
--checkoutフラグ。貸出/返却を必須にします (セッションを明示的に貸出し、後で返却する必要があります)。
--start-on-approvalフラグ。ユーザーが貸出を行うタイミングではなく、リクエストが承認されたタイミングでアクセスタイマーを開始します。
--require-reasonフラグ。アクセスをリクエストする際に、リクエスト者へ理由の入力を必須にします。
--require-ticketフラグ。リクエスト者に外部チケット/参照番号の入力を必須にします。
--require-mfaフラグ。アクセスが許可される前にMFA認証を必須にします。
-d, --duration <string>アクセス期間。例: "2h"、"30m"、"1d"。単位のない数値は分として扱われます。デフォルト: "1d"。
--allowed-days <string>アクセスを許可する曜日をコンマ区切りで指定します。例: "mon,tue,wed,thu,fri"。アクセス可能な曜日を制限します。
--time-range <string>同日内で許可する時間帯をHH:MM-HH:MM形式で指定します。例: "09:00-17:00"。終了時刻は開始時刻より後である必要があります。
-u, --user <email>承認者のメールアドレス。複数の承認者を指定する場合は複数回指定できます。
--approver <email>承認者メールアドレス用の--userの別名 (-u/--userと同様に使用可能)。複数回指定できます。
--format <table|json>出力形式。デフォルト: table。
**例**: {% code expandable="true" %} ```csharp My Vault> pam-workflow create 0bEtV6M9nah78at9UicRzH2gSS7A --checkout --approvals-needed 1 --approver demo@example.com Workflow created successfully Record: Dotnet-Gateway-14thJuly - VNC Machine (0bEtV6M9nah78at9UicRzH2gSS7A ) Approvals needed: 1 Check-in/out: Yes Duration: 1 day Approvers: demo@example.com ``` {% endcode %}
DotNet SDK **関数**: {% code expandable="true" %} ```csharp public static async Task CreateWorkflowConfigAsync(IAuthentication auth, WorkflowParameters parameters) { if (parameters == null) { throw new ArgumentNullException(nameof(parameters)); } await PostToRouterAsync(auth, CreateWorkflowConfigPath, parameters); } ``` {% endcode %}
Power Commander **コマンド**: `New-KeeperPamWorkflow` **別名**: `pam-workflow-new` **パラメーター**:
パラメーター説明
-Record, -rPAMリソースレコードのUIDまたはタイトル
-ApprovalsNeeded, -n必要な承認数。承認者が不要な場合は0を指定します。デフォルトは1です。
-Checkout, -coシングルユーザーの貸出/返却モードを有効にします。
-StartOnApproval, -saリソースが貸出されたタイミングではなく、承認が完了したタイミングでアクセスタイマーを開始します。
-RequireReason, -rrリクエスト者に理由の入力を必須にします。
-RequireTicket, -rtリクエスト者にチケット番号の入力を必須にします。
-RequireMfa, -rmMFA認証を必須にします。
-Duration, -dアクセス期間。例: 30m、2h、1d。デフォルトは1dです。
-AllowedDays曜日をコンマ区切りで指定: mon,tue,wed,thu,fri,sat,sun。
-TimeRange同日内の時間帯をHH:MM-HH:MM形式で指定。
-User, -u承認者として追加するユーザーのメールアドレス。
-Approver承認者メールアドレス用の互換オプション。繰り返し指定できます。
-Team, -t承認者として追加するチームのUIDまたは一意のチーム名。
-Format出力形式: tableまたはjson。
-Help, -hコマンドのヘルプを表示します。
**例**: {% code expandable="true" %} ```powershell PS > New-KeeperPamWorkflow ` -Record "OZiyGTEO_KrBxG8mvMJNWw" ` -Approver "approver@mail.com" ` -ApprovalsNeeded 1 ` -Checkout ` -StartOnApproval ` -RequireReason ` -RequireTicket ` -RequireMfa ` -Duration "1d" ` -AllowedDays "mon,tue,wed,thu,fri" ` -TimeRange "09:00-17:00" ``` {% endcode %}
Python CLI **コマンド: 近日公開**
Python SDK **コマンド: 近日公開**
## PAM Workflow updateコマンド 指定した項目のみワークフロー設定を更新し、指定しなかった項目は既存の値のまま保持します。
DotNet CLI **コマンド**: `pam-workflow update` **別名**: `pam-wf u` **パラメーター**:
パラメーター説明
<record>レコードのUIDまたはレコード名/タイトル。必須。対象のワークフローが既に存在している必要があります。
-n, --approvals-needed <int>新しい必要承認数。0以上を指定してください。
--checkout <true|false>貸出/返却の要否を有効/無効にします。
--start-on-approval <true|false>アクセスタイマーを承認時点で開始するか、貸出時点で開始するかを切り替えます。
--require-reason <true|false>アクセスリクエスト時の理由入力の要否を切り替えます。
--require-ticket <true|false>アクセスリクエスト時のチケット番号入力の要否を切り替えます。
--require-mfa <true|false>MFA認証の要否を切り替えます。
-d, --duration <string>新しいアクセス期間。例: "2h"、"30m"、"1d"。
--allowed-days <string>新しい許可曜日 (コンマ区切り)。
--time-range <string>新しい許可時間帯 (HH:MM-HH:MM)。
--format <table|json>出力形式。デフォルト: table。
**例**: {% code expandable="true" %} ```csharp My Vault> pam-workflow update 0bEtV6nah65142M9t9UicRzH2gSS7A --checkout --approvals-needed 2 Workflow updated successfully Record: Dotnet-Gateway-14thJuly - VNC Machine (0bEtV6nah65142M9t9UicRzH2gSS7A ) ``` {% endcode %}
DotNet SDK **関数**: {% code expandable="true" %} ```csharp public static async Task UpdateWorkflowConfigAsync(IAuthentication auth, WorkflowParameters parameters) { if (parameters == null) { throw new ArgumentNullException(nameof(parameters)); } await PostToRouterAsync(auth, UpdateWorkflowConfigPath, parameters); } ``` {% endcode %}
Power Commander **コマンド**: `Update-KeeperPamWorkflow` **別名**: `pam-workflow-edit` **パラメーター**:
パラメーター説明
-Record, -rPAMリソースレコードのUIDまたはタイトル。
-ApprovalsNeeded, -n必要な承認数。承認者が不要な場合は0を指定します。
-Checkout, -co貸出/返却モードを有効または無効にします。
-StartOnApproval, -saタイマーを承認時点で開始するかどうかを制御します。
-RequireReason, -rr理由入力の要否を切り替えます。
-RequireTicket, -rtチケット番号入力の要否を切り替えます。
-RequireMfa, -rmMFA認証の要否を切り替えます。
-Duration, -dアクセス期間。例: 30m、2h、1d。
-AllowedDays許可曜日 (コンマ区切り)。
-TimeRange同日内の時間帯 (HH:MM-HH:MM形式)。
-Format出力形式: tableまたはjson。
**例**: {% code expandable="true" %} ```powershell PS > Update-KeeperPamWorkflow ` -Record "OZiyGTrf_KrBxG8mvMJNWw" ` -ApprovalsNeeded 2 ` -Checkout $true ` -StartOnApproval $true ` -RequireReason $true ` -RequireTicket $true ` -RequireMfa $true ` -Duration "2h" ``` {% endcode %}
Python CLI **コマンド: 近日公開**
Python SDK **コマンド: 近日公開**
## PAM Workflow readコマンド PAMリソースレコードのワークフロー設定を参照します。
DotNet CLI **コマンド**: `pam-workflow read` **別名:** `pam-wf r` **パラメーター**: | パラメーター | 説明 | | ------------------------ | ------------------------- | | `` | レコードのUIDまたはレコード名/タイトル。必須。 | | `--format ` | 出力形式。デフォルト: `table`。 | **例**: {% code expandable="true" %} ``` My Vault> pam-workflow read 0bEtV6M9t9nahyt6a7wUicRzH2gSS7A--format json { "record_uid": "0bEtV6M9t9nahyt6a7wUicRzH2gSS7A", "record_name": "Dotnet-Gateway-14thJuly - VNC Machine", "parameters": { "approvals_needed": 2, "checkout_needed": true, "start_access_on_approval": false, "require_reason": false, "require_ticket": false, "require_mfa": false, "access_duration": "1 day", "allowed_times": null }, "approvers": [ { "escalation": false, "type": "user", "email": "demo@example.com" } ] } ``` {% endcode %}
DotNet SDK **関数**: {% code expandable="true" %} ```csharp public static async Task ReadWorkflowConfigAsync( IAuthentication auth, string recordUid, string recordName = null) { var refMsg = CreateRecordRef(recordUid, recordName); var config = await auth.ExecuteRouter(ReadWorkflowConfigPath, refMsg); if (config == null || (config.Parameters == null && config.Approvers.Count == 0 && config.CreatedOn == 0)) { return null; } return config; } ``` {% endcode %}
Power Commander **コマンド**: `Get-KeeperPamWorkflow` **別名**: `pam-workflow-read` **パラメーター**:
パラメーター説明
-Record, -rPAMリソースレコードのUIDまたはタイトル。
-Format出力形式: tableまたはjson。
**例**: {% code expandable="true" %} ```powershell PS > Get-KeeperPamWorkflow ` -Record "OZirfTEO_KrBxG8mvMJNWw" ``` {% endcode %}
Python CLI **コマンド: 近日公開**
Python SDK **コマンド: 近日公開**
## PAM Workflow deleteコマンド PAMリソースレコードからワークフロー設定を削除します。
DotNet CLI **コマンド**: `pam-workflow delete` **別名:** `pam-wf d` **パラメーター**: | パラメーター | 説明 | | ------------------------ | ------------------------- | | `` | レコードのUIDまたはレコード名/タイトル。必須。 | | `--format ` | 出力形式。デフォルト: `table`。 | **例:** {% code expandable="true" %} ```cs My Vault> pam-wf d 0bEtV6M9nahu78791t9UicRzH2gSS7A Workflow deleted successfully Record: Dotnet-Gateway-14thJuly - VNC Machine (0bEtV6M9nahu78791t9UicRzH2gSS7A) ``` {% endcode %}
DotNet SDK **関数**: {% code expandable="true" %} ```csharp public static async Task DeleteWorkflowConfigAsync( IAuthentication auth, string recordUid, string recordName = null) { var refMsg = CreateRecordRef(recordUid, recordName); await PostToRouterAsync(auth, DeleteWorkflowConfigPath, refMsg); } ``` {% endcode %}
Power Commander **コマンド**: `Remove-KeeperPamWorkflow` **別名**: `pam-workflow-delete` **パラメーター**:
パラメーター説明
-Record, -rPAMリソースレコードのUIDまたはタイトル。
-Format出力形式: tableまたはjson。
-Confirm対話式の確認プロンプトを表示せずに削除を確定します。
**例**: {% code expandable="true" %} ```powershell PS > Remove-KeeperPamWorkflow ` -Record "OZfgGTEO_KrBxG8mvMJNWw" ` -Confirm:$false ``` {% endcode %}
Python CLI **コマンド: 近日公開**
Python SDK **コマンド: 近日公開**
## PAM Workflow add-approverコマンド ユーザーまたはチームをワークフローの承認者として追加します。
DotNet CLI **コマンド**: `pam-workflow add-approver` **別名:** `pam-wf aa` **パラメーター**:
パラメーター説明
<record>レコードのUIDまたはレコード名/タイトル。必須。
-u, --user <email>承認者として追加するユーザーのメールアドレス。繰り返し指定可能。
--approver <email>--userの別名。繰り返し指定可能。
-t, --team <name|uid>承認者として追加するチーム名またはチームUID。繰り返し指定可能。
-e, --escalationフラグ。追加する承認者をエスカレーション承認者として設定します (主承認フローがエスカレーションされた場合のみ呼び出されます)。
--escalation-after <string>この承認者へのエスカレーションが発生するまでの時間。例: "30m"、"1h"。要 --escalation。
--format <table|json>出力形式。デフォルト: table。
*(`--user`*`/`\_`--approver` \_または`_`--team\`*のいずれかが必須です。)* **例:** {% code expandable="true" %} ```csharp My Vault> pam-wf aa 0bEtV6M9tanhqy679UicRzH2gSS7A --approver demo@example.com Approvers added successfully Record: Dotnet-Gateway-14thJuly - VNC Machine (0bEtV6M9tanhqy679UicRzH2gSS7A ) Added 1 approver(s)c# ```
DotNet SDK **関数**: {% code expandable="true" %} ```csharp public static async Task AddWorkflowApproversAsync( IAuthentication auth, string recordUid, string recordName, IEnumerable users = null, IEnumerable teamUids = null, bool isEscalation = false, long escalationAfterMs = 0) { var config = BuildApproverConfig(recordUid, recordName, users, teamUids, isEscalation, escalationAfterMs); if (config.Approvers.Count == 0) { return; } await PostToRouterAsync(auth, AddWorkflowApproversPath, config); } ``` {% endcode %}
Power Commander **コマンド**: `Add-KeeperPamWorkflowApprover` **別名**: `pam-workflow-add-approver` **パラメーター**:
パラメーター説明
-Record, -rPAMリソースレコードのUIDまたはタイトル。
-User, -u承認者として追加するユーザーのメールアドレス。繰り返し指定可能。
-Approver承認者メールアドレス用の互換オプション。
-Team, -tチームUIDまたは一意のチーム名。繰り返し指定可能。
-Escalation, -e指定した承認者をエスカレーション承認者として設定します。
-EscalationAfterエスカレーションまでの遅延時間。例: 30m、2h、1d。-Escalationの指定が必要です。
-Format出力形式: tableまたはjson。
**例**: {% code expandable="true" %} ```powershell PS > Add-KeeperPamWorkflowApprover ` -Record "OZiyGTEO_KffgG8mvMJNWw" ` -User "approver@mail.com" ` -Team "TestTeam" ``` {% endcode %}
Python CLI **コマンド: 近日公開**
Python SDK **コマンド: 近日公開**
## PAM Workflow remove-approverコマンド ワークフローの承認者リストからユーザーまたはチームを削除します。
DotNet CLI **コマンド**: `pam-workflow remove-approver` **別名:** `pam-wf ra` **パラメーター**: | パラメーター | 説明 | | ------------------------ | -------------------------------- | | `` | レコードのUIDまたはレコード名/タイトル。必須。 | | `-u, --user ` | 承認者から削除するユーザーのメールアドレス。繰り返し指定可能。 | | `--approver ` | `--user` の別名。繰り返し指定可能。 | | `-t, --team ` | 承認者から削除するチーム名またはチームUID。繰り返し指定可能。 | | `--format ` | 出力形式。デフォルト: `table`。 | *(`--user`*`/`\_`--approver` \_または`_`--team\`*のいずれかが必須です。)* **例***:* {% code expandable="true" %} ```csharp My Vault> pam-wf ra 0bEtV6M9t9Unah87icRzH2gSS7A --approver demo@example.com Approvers removed successfully Record: Dotnet-Gateway-14thJuly - VNC Machine (0bEtV6M9t9Unah87icRzH2gSS7A ) Removed 1 approver(s) ```
DotNet SDK **関数:** {% code expandable="true" %} ```csharp public static async Task DeleteWorkflowApproversAsync( IAuthentication auth, string recordUid, string recordName, IEnumerable users = null, IEnumerable teamUids = null) { var config = BuildApproverConfig(recordUid, recordName, users, teamUids); if (config.Approvers.Count == 0) { return; } await PostToRouterAsync(auth, DeleteWorkflowApproversPath, config); } ``` {% endcode %}
Power Commander **コマンド**: `Remove-KeeperPamWorkflowApprover` **別名**: `pam-workflow-remove-approver` **パラメーター**:
パラメーター説明
-Record, -rPAMリソースレコードのUIDまたはタイトル。
-User, -u削除するユーザーのメールアドレス。繰り返し指定可能。
-Approver承認者メールアドレス用の互換オプション。
-Team, -t削除するチームUIDまたは一意のチーム名。
-Format出力形式: tableまたはjson。
**例**: {% code expandable="true" %} ```powershell PS > Remove-KeeperPamWorkflowApprover ` -Record "OZiyGrfO_KrBxG8mvMJNWw" ` -User "approver@mail.com" ``` {% endcode %}
Python CLI **コマンド: 近日公開**
Python SDK **コマンド: 近日公開**
## PAM Workflow pendingコマンド 現在のユーザーに割り当てられている、承認待ちのワークフローリクエストを一覧表示します。
DotNet CLI **コマンド**: `pam-workflow pending` **別名:** `pam-wf p` **パラメーター**: | パラメーター | 説明 | | ------------------------ | -------------------- | | `--format ` | 出力形式。デフォルト: `table`。 | **例**: {% code expandable="true" %} ```csharp My Vault> pam-wf p 0bEtV6M9tnajaut9UicRzH2gSS7A Record Name Record UID Flow UID Requested By Reason Ticket Started Expires Duration ------------------------------------- ---------------------- ---------------------- -------------------------------------- ------ ------ ------- ------- -------- Dotnet-Gateway-14thJuly - RDP Machine 0nahay67wd7s9NnujjRMyGA v2UD_gpdAW_HJvEN57SH2g demo1@example.com ``` {% endcode %}
DotNet SDK **関数**: {% code expandable="true" %} ```csharp public static async Task GetApprovalRequestsAsync(IAuthentication auth) { return await auth.ExecuteRouter(GetApprovalRequestsPath); } ``` {% endcode %}
Power Commander **コマンド**: `Get-KeeperPamWorkflowPending` **別名:** `pam-workflow-pending` **例:** {% code expandable="true" %} ```powershell PS > Get-KeeperPamWorkflowPending PS > pam-workflow-pending ``` {% endcode %}
Python CLI **コマンド: 近日公開**
Python SDK **コマンド: 近日公開**
## PAM Workflow approveコマンド `pending` コマンドで取得したフローUIDを使用して、保留中のワークフローアクセスリクエストを承認します。
DotNet CLI **コマンド**: `pam-workflow approve` **別名:** `pam-wf a` **パラメーター**: | パラメーター | 説明 | | ------------------------ | --------------------------------------- | | `` | 保留中リクエストのフローUID (`pending` コマンドで取得)。必須。 | | `--format ` | 出力形式。デフォルト: `table`。 | **例**: {% code expandable="true" %} ```c# My Vault> pam-wf a v2UD_gpdAW_HJvEN5nahudyr7SH2g Access request approved Flow UID: v2UD_gpdAW_HJvEN5nahudyr7SH2g ``` {% endcode %}
DotNet SDK **関数**: {% code expandable="true" %} ```csharp public static async Task ApproveWorkflowAccessAsync(IAuthentication auth, byte[] flowUidBytes) { await ApproveOrDenyWorkflowAccessAsync(auth, flowUidBytes, deny: false, denialReasonEncrypted: null); } ``` {% endcode %}
Power Commander **コマンド**: `Approve-KeeperPamWorkflowAccess` **別名:** `pam-workflow-approve` **パラメーター:** | パラメーター | 説明 | | ------------------- | ----------------------------------------------------------------- | | `-FlowUid ` | 保留中リクエストのフローUID (`Get-KeeperPamWorkflowPending` で取得)。必須、位置引数 (0)。 | **例:** {% code expandable="true" %} ```ps PS > Approve-KeeperPamWorkflowAccess -FlowUid "" PS > pam-workflow-approve "" ``` {% endcode %}
Python CLI **コマンド: 近日公開**
Python SDK **コマンド: 近日公開**
## PAM Workflow denyコマンド 保留中のワークフローアクセスリクエストを拒否します。
DotNet CLI **コマンド**: `pam-workflow deny` **別名:** `pam-wf dn` **パラメーター**: | パラメーター | 説明 | | ------------------------ | ----------------------------------------------------------------- | | `` | 保留中リクエストのフローUID。必須。 | | `-r, --reason ` | 拒否理由 (任意)。暗号化に成功した場合はリクエスト者に表示されます。暗号化に失敗した場合は、理由を表示せずに拒否が実行されます。 | | `--format ` | 出力形式。デフォルト: `table`。 | **例**: {% code expandable="true" %} ``` My Vault> pam-wf dn ``` {% endcode %}
DotNet SDK **関数**: {% code expandable="true" %} ```csharp public static async Task DenyWorkflowAccessAsync( IAuthentication auth, byte[] flowUidBytes, ByteString denialReasonEncrypted = null) { await ApproveOrDenyWorkflowAccessAsync(auth, flowUidBytes, deny: true, denialReasonEncrypted); } ``` {% endcode %}
Power Commander **コマンド**: `Deny-KeeperPamWorkflowAccess` **別名:** `pam-workflow-deny` **パラメーター:** | パラメーター | 説明 | | ------------------- | ------------------------------------------------------------------------- | | `-FlowUid ` | 保留中リクエストのフローUID。必須、位置引数 (0)。 | | `-Reason ` | リクエスト者に表示する理由 (任意)。リクエスト者向けに暗号化されます。暗号化に失敗した場合は警告が表示され、理由を表示せずに拒否が実行されます。 | **例:** {% code expandable="true" %} ```powershell PS > Deny-KeeperPamWorkflowAccess -FlowUid "" -Reason "Not authorized" PS > pam-workflow-deny "" -r "Not authorized" ``` {% endcode %}
Python CLI **コマンド: 近日公開**
Python SDK **コマンド: 近日公開**
## PAM Workflow requestコマンド ワークフローで保護されたPAMリソースへのアクセスをリクエストします。保留中リクエストのエスカレーションや、実行中リクエストの取り消しにも対応しています。
DotNet CLI **コマンド**: `pam-workflow request` **別名:** `pam-wf rq` **パラメーター**: | パラメーター | 説明 | | ------------------------ | -------------------------------------------------------------------------------------------------------- | | `` | レコードのUIDまたはレコード名/タイトル。必須。 | | `-r, --reason ` | アクセスリクエストの理由。`--cancel` とは併用できません。 | | `--ticket ` | リクエストに関連付ける外部チケット/参照番号。`--cancel` とは併用できません。 | | `--escalate` | フラグ。新しいリクエストを送信する代わりに、既存の保留中リクエストをエスカレーション承認者にエスカレーションします。`--cancel` とは同時に指定できません。 | | `-c, --cancel` | フラグ。リクエストを送信する代わりに、そのレコードに対する実行中/保留中のワークフローリクエストを取り消します。`--escalate`、`--reason`、`--ticket` とは同時に指定できません。 | | `--format ` | 出力形式。デフォルト: `table`。 | **例**: {% code expandable="true" %} ```csharp My Vault> pam-workflow request 0bEtV6M9t9UnahticRzH2gSS7A Access request sent Record: Dotnet-Gateway-14thJuly - VNC Machine (0bEtV6M9najaytt9UicRzH2gSS7A) Approvers have been notified. ``` {% endcode %}
DotNet SDK **関数**: {% code expandable="true" %} ```csharp public static async Task RequestWorkflowAccessAsync( IAuthentication auth, string recordUid, string recordName, byte[] recordKey, string reason = null, string ticket = null) { var needsEncrypted = !string.IsNullOrEmpty(reason) || !string.IsNullOrEmpty(ticket); if (needsEncrypted && (recordKey == null || recordKey.Length == 0)) { throw new InvalidOperationException( "Record key not available — cannot encrypt reason/ticket. " + "You do not have sufficient access to this record to send encrypted parameters."); } var accessRequest = new WorkflowAccessRequest { Resource = CreateRecordRef(recordUid, recordName), }; if (!string.IsNullOrEmpty(reason)) { accessRequest.Reason = ByteString.CopyFrom( CryptoUtils.EncryptAesV2(System.Text.Encoding.UTF8.GetBytes(reason), recordKey)); } if (!string.IsNullOrEmpty(ticket)) { accessRequest.Ticket = ByteString.CopyFrom( CryptoUtils.EncryptAesV2(System.Text.Encoding.UTF8.GetBytes(ticket), recordKey)); } await PostToRouterAsync(auth, RequestWorkflowAccessPath, accessRequest); } ``` {% endcode %}
Power Commander **コマンド**: `Request-KeeperPamWorkflowAccess` **別名:** `pam-workflow-request` **パラメーター:** | パラメーター | 説明 | | ------------------ | ----------------------------------------------------------------------------------------- | | `-Record ` | PAMリソースレコードのUIDまたはタイトル。必須、位置引数 (0)。 | | `-Reason ` | アクセスリクエストの理由。`-Cancel` とは併用できません。 | | `-Ticket ` | 外部チケット/参照番号。`-Cancel` とは併用できません。 | | `-Escalate` | スイッチ。新しいリクエストを送信する代わりに、既存の保留中リクエストをエスカレーション承認者にエスカレーションします。`-Cancel` とは併用できません。 | | `-Cancel` | スイッチ。そのレコードに対する自分自身の保留中/実行中のワークフローリクエストを取り消します。`-Escalate`、`-Reason`、`-Ticket` とは併用できません。 | **注:** レコードの所有者および承認者はワークフローの制限が適用されないため、リクエストを送信する代わりに「対象外」というメッセージが表示されます。 **例:** {% code expandable="true" %} ```ps PS > Request-KeeperPamWorkflowAccess -Record "" -Reason "Need access to investigate an incident" PS > Request-KeeperPamWorkflowAccess -Record "" -Escalate PS > Request-KeeperPamWorkflowAccess -Record "" -Cancel PS > pam-workflow-request "" -re "reason text" ``` {% endcode %}
Python CLI **コマンド: 近日公開**
Python SDK **コマンド: 近日公開**
## PAM Workflow startコマンド ワークフローセッションを開始します (貸出)。貸出/返却が有効な場合、リソースに接続する前にこの操作が必要です。
DotNet CLI **コマンド**: `pam-workflow start` **別名:** `pam-wf s` **パラメーター**: | パラメーター | 説明 | | ------------------------ | ----------------------------------------- | | `` | レコードのUID/名前。ローカルでレコードを解決できない場合はフローUID。必須。 | | `--format ` | 出力形式。デフォルト: `table`。 | **例**: {% code expandable="true" %} ```csharp My Vault> pam-wf start 0bEtV6M9t9UicRzH2gSS7A Workflow started (checked out) Record: Dotnet-Gateway-14thJuly - VNC Machine (0bEtV6M9t9UicRzH2gSS7A) ``` {% endcode %}
DotNet SDK **関数**: {% code expandable="true" %} ```csharp public static async Task StartWorkflowAsync(IAuthentication auth, WorkflowState state) { if (state == null) { throw new ArgumentNullException(nameof(state)); } await PostToRouterAsync(auth, StartWorkflowPath, state); } ``` {% endcode %}
Power Commander **コマンド**: `Start-KeeperPamWorkflow` **別名:** `pam-workflow-start` **パラメーター:** | パラメーター | 説明 | | --------------- | ----------------------------------------------------------------------- | | `-Uid ` | レコードのUID、レコードタイトル、またはフローUID。必須、位置引数 (0)。レコードとして解決できない場合はフローUIDとして扱われます。 | **例**: {% code expandable="true" %} ```ps PS > Start-KeeperPamWorkflow -Uid "" PS > pam-workflow-start "" ``` {% endcode %}
Python CLI **コマンド: 近日公開**
Python SDK **コマンド: 近日公開**
## PAM Workflow endコマンド ワークフローセッションを終了します (返却)。返却後に認証情報がローテーションされる場合があります。
DotNet CLI **コマンド**: `pam-workflow end` **別名:** `pam-wf e` **パラメーター**: | パラメーター | 説明 | | ------------------------ | ------------------------------------------------------- | | `` | レコードのUID/名前、またはフローUID。必須。 | | `-f, --force` | フラグ。このレコード/フローで他のユーザーが使用中のセッションを強制的に返却します (管理者による強制操作)。 | | `--format ` | 出力形式。デフォルト: `table`。 | **例**: {% code expandable="true" %} ```csharp My Vault> pam-wf end 0bEtV6M9t9UicRzH2gSS7A ``` {% endcode %}
DotNet SDK **関数**: {% code expandable="true" %} ```csharp public static async Task EndWorkflowAsync(IAuthentication auth, GraphSyncRef flowOrResourceRef) { if (flowOrResourceRef == null) { throw new ArgumentNullException(nameof(flowOrResourceRef)); } await PostToRouterAsync(auth, EndWorkflowPath, flowOrResourceRef); } ``` {% endcode %}
Power Commander **コマンド**: `Stop-KeeperPamWorkflow` **別名:** `pam-workflow-end` **パラメーター:** | パラメーター | 説明 | | --------------- | ---------------------------------------------------------------------- | | `-Uid ` | レコードのUID、レコードタイトル、またはフローUID。必須、位置引数 (0)。 | | `-Force` | スイッチ。シングルユーザーの貸出が有効な場合に、他のユーザーが使用中のセッションを代わりに強制返却します (承認者または管理者権限が必要)。 | **例**: {% code expandable="true" %} ```ps PS > Stop-KeeperPamWorkflow -Uid "" PS > Stop-KeeperPamWorkflow -Uid "" -Force PS > pam-workflow-end "" ``` {% endcode %}
Python CLI **コマンド: 近日公開**
Python SDK **コマンド: 近日公開**
## PAM Workflow stateコマンド PAMリソースレコードの現在のワークフロー状態を取得します。
DotNet CLI **コマンド**: `pam-workflow state` **別名:** `pam-wf st` **パラメーター**: | パラメーター | 説明 | | ------------------------ | ------------------------- | | `` | レコードのUIDまたはレコード名/タイトル。必須。 | | `--format ` | 出力形式。デフォルト: `table`。 | **例**: {% code expandable="true" %} ```csharp My Vault> pam-wf state 0bEtV6M9t9UicRzH2gSS7A You are exempt from workflow restrictions on this record. As a record owner or approver, you can access this resource directly. ``` {% endcode %}
DotNet SDK **関数**: {% code expandable="true" %} ```csharp public static async Task GetWorkflowStateByRecordAsync( IAuthentication auth, string recordUid, string recordName = null) { var request = new WorkflowState { Resource = CreateRecordRef(recordUid, recordName), }; return await auth.ExecuteRouter(GetWorkflowStatePath, request); } ``` {% endcode %}
Power Commander **コマンド**: `Get-KeeperPamWorkflowState` **別名**: `pam-workflow-state` **パラメーター**:
パラメーター説明
-Record, -rPAMリソースレコードのUIDまたはタイトル。
-Format出力形式: tableまたはjson。
**例**: {% code expandable="true" %} ```powershell PS > Get-KeeperPamWorkflowState ` -Record "OZiyGTrf_KrBxG8mvMJNWw" ``` {% endcode %}
Python CLI **コマンド: 近日公開**
Python SDK **コマンド: 近日公開**
## PAM Workflow my-accessコマンド 現在のユーザーが持つ、有効なワークフローアクセス状態を一覧表示します。
DotNet CLI **コマンド**: `pam-workflow my-access` **別名:** `pam-wf ma` **パラメーター**: | パラメーター | 説明 | | ------------------------ | ------------------- | | `--format ` | 出力形式。デフォルト: `table` | **例**: {% code expandable="true" %} ```csharp My Vault> pam-wf my-access No active workflows ``` {% endcode %}
DotNet SDK **関数:** {% code expandable="true" %} ```csharp public static async Task GetUserAccessStateAsync(IAuthentication auth) { return await auth.ExecuteRouter(GetUserAccessStatePath); } ``` {% endcode %}
Power Commander **コマンド**: `Get-KeeperPamWorkflowMyAccess` **別名**: `pam-workflow-my-access` **パラメーター**:
パラメーター説明
-Format出力形式: tableまたはjson。
**例**: {% code expandable="true" %} ```powershell PS > Get-KeeperPamWorkflowMyAccess ``` {% endcode %}
Python CLI **コマンド: 近日公開**
Python SDK **コマンド: 近日公開**
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.keeper.io/keeperpam/jp/commander-sdk/keeper-commander-sdks/sdk-command-reference/keeperpam-commands/pam-workflow-commands.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.