Share via

New-PAMRequest

  • Reference
Module:
MIMPAM

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.