New-RDMPamCheckoutRequestInformation

Synopsis

Autofill the next PAM checkout request information

Syntax

Duration

New-RDMPamCheckoutRequestInformation [-Duration] <int> [[-ApproverID] <guid>] [[-Reason] <string>]
 [<CommonParameters>]

TimeRange

New-RDMPamCheckoutRequestInformation [-EndTime] <datetime> [[-ApproverID] <guid>]
 [[-Reason] <string>] [[-StartTime] <datetime>] [<CommonParameters>]

Description

Autofill the next PAM checkout request information. By default, a standard PAM checkout request is submitted. If possible, it is self-approved; otherwise, it is assigned to a random approver. The default duration is 60 minutes. This cmdlet allows you to modify the parameters of the next request, including approval routing and duration.

Examples

PS C:\> New-RDMPamCheckoutRequestInformation -Duration 15 -Reason 'Execute system information report from entry named MySystemInformationReportEntry'
PS C:\> Get-RDMEntry -Name 'MySystemInformationReportEntry' | New-RDMSystemInformationReport

The entry MySystemInformationReportEntry is linked to a privileged account, so a PAM checkout is required. Use New-RDMPamCheckoutRequestInformation before calling New-RDMSystemInformationReport to limit the session to 15 minutes and to provide a reason for access.

Parameters

-ApproverID

Approver's ID. If not specified, it will be either self-approved, if possible, or send to a random approver.

Type: System.Nullable`1[System.Guid]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 1
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Duration

Duration in minutes for the pam checkout request

Type: System.Int32
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: Duration
  Position: 0
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-EndTime

When the checkout ends

Type: System.DateTime
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: TimeRange
  Position: 0
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Reason

Reason of the pam checkout request

Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 2
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-StartTime

Checkout occurs immediately by default, unless otherwise specified

Type: System.Nullable`1[System.DateTime]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: TimeRange
  Position: 3
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Notes

For more information, type "Get-Help New-RDMPamCheckoutRequestInformation -detailed". For technical information, type "Get-Help New-RDMPamCheckoutRequestInformation -full".