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

The New-PAMRequest cmdlet creates a Privileged Access Management (PAM) activation request in the Microsoft Identity Manager (MIM) Service. You must specify a role, using either the Role or RoleDisplayName parameters that indicates the security groups to which the user is requesting to be added.

Examples

Example 1: Create a new request for a PAM role

PS C:\> New-PAMRequest -role $Role

This command creates a new request for a PAM role. The variable Role is assumed to have been set by a previous use of the cmdlet Get-PAMRoleForRequest.

Optional Parameters

-Justification

Specifies an optional text parameter to be included in the activation request.

Type:String
Position:2
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RequestedTTL

Specifies an optional override of the time to live (TTL) for the activation request. If you don't specify this parameter, then the role default TTL is used instead.

Type:TimeSpan
Position:3
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RequestedTime

Specifies an optional delayed start time for the activation.

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Role

Specifies the PAM role in the MIM Service being requested, returned by Get-PAMRoleForRequest.

Type:PAMRoleForRequest
Position:1
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-RoleDisplayName

Specifies the display name of the PAM role in the MIM Service being requested.

Type:String
Position:1
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False

Outputs

Microsoft.IdentityManagement.PamCmdlets.Model.PAMRequest