PAM Workflow Commands
Manage Just-In-Time (JIT) privileged access workflows for PAM resources. Workflows enforce approval-based access control with optional check-in/check-out, MFA verification and time-based access window
Sub Commands
Configuration
PAM Workflow create
Create a workflow configuration for a PAM record. At least one approver must be added if approvals are required.
DotNet CLI
Command: pam-workflow create
Alias: pam-wf c
Parameters:
<record>
Record UID or record name/title. Required.
-n, --approvals-needed <int>
Number of approvals required before access is granted. Default: 1. Must be >= 0; 0 means no approval required.
--checkout
Flag. Enables check-in/check-out requirement (session must be explicitly checked out and later checked in).
--start-on-approval
Flag. Starts the access timer when the request is approved, instead of when the user checks out.
--require-reason
Flag. Requires the requester to supply a reason when requesting access.
--require-ticket
Flag. Requires the requester to supply an external ticket/reference number.
--require-mfa
Flag. Requires MFA verification before access is granted.
-d, --duration <string>
Access duration, e.g. "2h", "30m", "1d". A bare number is treated as minutes. Default: "1d".
--allowed-days <string>
Comma-separated allowed days, e.g. "mon,tue,wed,thu,fri". Restricts when access can be used.
--time-range <string>
Same-day allowed time window in HH:MM-HH:MM format, e.g. "09:00-17:00". End must be after start.
-u, --user <email>
Approver's user email. Can be passed multiple times for multiple approvers.
--approver <email>
Alias of --user for approver email (used interchangeably with -u/--user). Can be passed multiple times.
--format <table|json>
Output format. Default: table.
Examples:
Power Commander
Command: New-KeeperPamWorkflow
Alias: pam-workflow-new
Parameters:
-Record, -r
PAM resource record UID or title
-ApprovalsNeeded, -n
Number of approvals required. Use 0 when no approvers are required. Default is 1.
-Checkout, -co
Enables single-user check-in/check-out mode.
-StartOnApproval, -sa
Starts the access timer when approval completes instead of when the resource is checked out.
-RequireReason, -rr
Requires the requester to provide a reason.
-RequireTicket, -rt
Requires the requester to provide a ticket number.
-RequireMfa, -rm
Requires MFA verification.
-Duration, -d
Access duration, such as 30m, 2h, or 1d. Default is 1d.
-AllowedDays
Comma-separated days: mon,tue,wed,thu,fri,sat,sun.
-TimeRange
Same-day time range in HH:MM-HH:MM format.
-User, -u
User email to add as an approver.
-Approver
Compatibility option for approver email addresses. Can be repeated.
-Team, -t
Team UID or unique team name to add as an approver.
-Format
Output format: table or json.
-Help, -h
Displays command help.
Examples:
PAM Workflow update
Updates selected workflow settings while preserving values that were not supplied.
DotNet CLI
Command: pam-workflow update
Alias: pam-wf u
Parameters:
<record>
Record UID or record name/title. Required. Workflow must already exist.
-n, --approvals-needed <int>
New number of approvals required. Must be >= 0.
--checkout <true|false>
Enable/disable check-in/check-out requirement.
--start-on-approval <true|false>
Toggle whether the access timer starts on approval vs. on check-out.
--require-reason <true|false>
Toggle requirement for a reason on access requests.
--require-ticket <true|false>
Toggle requirement for a ticket number on access requests.
--require-mfa <true|false>
Toggle requirement for MFA verification.
-d, --duration <string>
New access duration, e.g. "2h", "30m", "1d".
--allowed-days <string>
New comma-separated allowed days.
--time-range <string>
New allowed time window (HH:MM-HH:MM).
--format <table|json>
Output format. Default: table.
Examples:
Power Commander
Command: Update-KeeperPamWorkflow
Alias: pam-workflow-edit
Parameters:
-Record, -r
PAM resource record UID or title.
-ApprovalsNeeded, -n
Number of approvals required. Use 0 when no approvers are required.
-Checkout, -co
Enables or disables check-in/check-out mode.
-StartOnApproval, -sa
Controls whether the timer starts on approval.
-RequireReason, -rr
Enables or disables the reason requirement.
-RequireTicket, -rt
Enables or disables the ticket requirement.
-RequireMfa, -rm
Enables or disables MFA verification.
-Duration, -d
Access duration, such as 30m, 2h, or 1d.
-AllowedDays
Comma-separated allowed days.
-TimeRange
Same-day time range in HH:MM-HH:MM format.
-Format
Output format: table or json.
Examples:
PAM Workflow read
Reads the workflow configuration for a PAM resource record.
DotNet CLI
Command: pam-workflow read
Alias: pam-wf r
Parameters:
<record>
Record UID or record name/title. Required.
--format <table|json>
Output format. Default: table.
Example:
Power Commander
Command: Get-KeeperPamWorkflow
Alias: pam-workflow-read
Parameters:
-Record, -r
PAM resource record UID or title.
-Format
Output format: table or json.
Examples:
PAM Workflow delete
Deletes the workflow configuration from a PAM resource record.
DotNet CLI
Command: pam-workflow delete
Alias: pam-wf d
Parameters:
<record>
Record UID or record name/title. Required.
--format <table|json>
Output format. Default: table.
Example:
Power Commander
Command: Remove-KeeperPamWorkflow
Alias: pam-workflow-delete
Parameters:
-Record, -r
PAM resource record UID or title.
-Format
Output format: table or json.
-Confirm
Confirms deletion without an interactive prompt.
Examples:
PAM Workflow add-approver
Adds users or teams as workflow approvers.
DotNet CLI
Command: pam-workflow add-approver
Alias: pam-wf aa
Parameters:
<record>
Record UID or record name/title. Required.
-u, --user <email>
User email to add as an approver. Repeatable.
--approver <email>
Alias of --user. Repeatable.
-t, --team <name|uid>
Team name or team UID to add as an approver. Repeatable.
-e, --escalation
Flag. Marks the added approver(s) as escalation approvers (only invoked if the primary approval flow is escalated).
--escalation-after <string>
Time before this approver's escalation kicks in, e.g. "30m", "1h". Requires --escalation.
--format <table|json>
Output format. Default: table.
(At least one of --user/--approver or --team is required.)
Example:
Power Commander
Command: Add-KeeperPamWorkflowApprover
Alias: pam-workflow-add-approver
Parameters:
-Record, -r
PAM resource record UID or title.
-User, -u
User email to add as an approver. Can be repeated.
-Approver
Compatibility option for approver email addresses.
-Team, -t
Team UID or unique team name. Can be repeated.
-Escalation, -e
Marks the supplied approvers as escalation approvers.
-EscalationAfter
Escalation delay, such as 30m, 2h, or 1d. Requires -Escalation.
-Format
Output format: table or json.
Examples:
PAM Workflow remove-approver
Removes users or teams from the workflow approver list.
DotNet CLI
Command: pam-workflow remove-approver
Alias: pam-wf ra
Parameters:
<record>
Record UID or record name/title. Required.
-u, --user <email>
User email to remove from approvers. Repeatable.
--approver <email>
Alias of --user. Repeatable.
-t, --team <name|uid>
Team name or team UID to remove from approvers. Repeatable.
--format <table|json>
Output format. Default: table.
(At least one of --user/--approver or --team is required.)
Example:
Power Commander
Command: Remove-KeeperPamWorkflowApprover
Alias: pam-workflow-remove-approver
Parameters:
-Record, -r
PAM resource record UID or title.
-User, -u
User email to remove. Can be repeated.
-Approver
Compatibility option for approver email addresses.
-Team, -t
Team UID or unique team name to remove.
-Format
Output format: table or json.
Examples:
PAM Workflow pending
List all pending workflow approval requests assigned to the current user.
DotNet CLI
Command: pam-workflow pending
Alias: pam-wf p
Parameters:
--format <table|json>
Output format. Default: table.
Example:
PAM Workflow approve
Approve a pending workflow access request using the flow UID from the pending command.
DotNet CLI
Command: pam-workflow approve
Alias: pam-wf a
Parameters:
<flow_uid>
The flow UID of the pending request (obtained from pending). Required.
--format <table|json>
Output format. Default: table.
Example:
Power Commander
Command: Approve-KeeperPamWorkflowAccess
Alias: pam-workflow-approve
Parameters:
-FlowUid <string>
Flow UID of the pending request (obtained from Get-KeeperPamWorkflowPending). Mandatory, positional (0).
Examples:
PAM Workflow deny
Deny a pending workflow access request
DotNet CLI
Command: pam-workflow deny
Alias: pam-wf dn
Parameters:
<flow_uid>
The flow UID of the pending request. Required.
-r, --reason <string>
Optional reason for denial. Encrypted and shown to the requester if encryption succeeds; otherwise the denial proceeds without a visible reason.
--format <table|json>
Output format. Default: table.
Example:
Power Commander
Command: Deny-KeeperPamWorkflowAccess
Alias: pam-workflow-deny
Parameters:
-FlowUid <string>
Flow UID of the pending request. Mandatory, positional (0).
-Reason <string>
Optional reason shown to the requester. Encrypted for the requester; if encryption fails, a warning is shown and the denial proceeds without a visible reason.
Examples:
PAM Workflow request
Request access to a workflow-protected PAM resource. Supports escalation of pending requests and cancellation of active requests.
DotNet CLI
Command: pam-workflow request
Alias: pam-wf rq
Parameters:
<record>
Record UID or record name/title. Required.
-r, --reason <string>
Reason for the access request. Cannot be combined with --cancel.
--ticket <string>
External ticket/reference number tied to the request. Cannot be combined with --cancel.
--escalate
Flag. Escalates an existing pending request to escalation approvers, instead of submitting a new request. Mutually exclusive with --cancel.
-c, --cancel
Flag. Cancels an active/pending workflow request for the record instead of submitting one. Mutually exclusive with --escalate, --reason, --ticket.
--format <table|json>
Output format. Default: table.
Example:
Power Commander
Command: Request-KeeperPamWorkflowAccess
Alias: pam-workflow-request
Parameters:
-Record <string>
PAM resource record UID or title. Mandatory, positional (0).
-Reason <string>
Reason for the access request. Cannot be combined with -Cancel.
-Ticket <string>
External ticket/reference number. Cannot be combined with -Cancel.
-Escalate
Switch. Escalates an already-pending request to escalation approvers instead of submitting a new request. Cannot be combined with -Cancel.
-Cancel
Switch. Cancels your own pending/active workflow request for the record. Cannot be combined with -Escalate, -Reason, or -Ticket.
Notes: Record owners and approvers are exempt from workflow restrictions and get an "exempt" message instead of submitting a request.
Example:
PAM Workflow start
Start a workflow session (check-out). This is required before connecting to the resource when check-in/check-out is enabled.
DotNet CLI
Command: pam-workflow start
Alias: pam-wf s
Parameters:
<record_or_flow_uid>
Record UID/name, or a flow UID if the record isn't resolvable locally. Required.
--format <table|json>
Output format. Default: table.
Example:
Power Commander
Command: Start-KeeperPamWorkflow
Alias: pam-workflow-start
Parameters:
-Uid <string>
Record UID, record title, or Flow UID. Mandatory, positional (0). If not resolvable as a record, it's treated as a flow UID.
Example:
PAM Workflow end
End a workflow session (check-in). Credentials may be rotated after check-in.
DotNet CLI
Command: pam-workflow end
Alias: pam-wf e
Parameters:
<record_or_flow_uid>
Record UID/name, or flow UID. Required.
-f, --force
Flag. Force checks-in another user's active session for this record/flow (administrative override).
--format <table|json>
Output format. Default: table.
Example:
Power Commander
Command: Stop-KeeperPamWorkflow
Alias: pam-workflow-end
Parameters:
-Uid <string>
Record UID, record title, or Flow UID. Mandatory, positional (0).
-Force
Switch. Force checks-in another user's active session on behalf of another user when single-user checkout is enabled (requires approver/admin rights).
Example:
PAM Workflow state
Returns the current workflow state for a PAM resource record.
DotNet CLI
Command: pam-workflow state
Alias: pam-wf st
Parameters:
<record>
Record UID or record name/title. Required.
--format <table|json>
Output format. Default: table.
Example:
Power Commander
Command: Get-KeeperPamWorkflowState
Alias: pam-workflow-state
Parameters:
-Record, -r
PAM resource record UID or title.
-Format
Output format: table or json.
Examples:
PAM Workflow my-access
Lists the current user’s active workflow access states.
DotNet CLI
Command: pam-workflow my-access
Alias: pam-wf ma
Parameters:
--format <table|json>
Output format. Default: table
Example:
Last updated
Was this helpful?

