New-PAMRequest
Creates a PAM activation request in the MIM Service.
Syntax
New-PAMRequest
[[-Role] <PAMRoleForRequest>]
[[-Justification] <String>]
[[-RequestedTTL] <TimeSpan>]
[-RequestedTime <DateTime>]
[<CommonParameters>]
New-PAMRequest
[[-RoleDisplayName] <String>]
[[-Justification] <String>]
[[-RequestedTTL] <TimeSpan>]
[-RequestedTime <DateTime>]
[<CommonParameters>]
Description
This cmdlet creates a new PAM activation request in the MIM Service. A role must be specified, using either the Role or RoleDisplayName parameters, which indicates the security groups to which the user is requesting to be added.
Examples
EXAMPLE 1
$s = New-PAMRequest -role $r
Description
This command creates a new request for a PAM Role. The variable r is assumed to have been set by a previous use of the cmdlet Get-PAMRoleForRequest.
Parameters
-Justification
An optional text parameter to be included in the activation request.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequestedTime
Optional delayed start time for the activation.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequestedTTL
An optional override of the time to live for the activation request once started. If not specified, then the role default TTL is used instead.
Type: | TimeSpan |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Role
The PAM role in MIM Service being requested, returned by Get-PAMRoleForRequest.
Type: | PAMRoleForRequest |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RoleDisplayName
The display name of PAM role in the MIM Service being requested.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Outputs
Microsoft.IdentityManagement.PamCmdlets.Model.PAMRequest
The newly created PAMRequest object.