Get-PAMRequest

Retrieves PAM Requests from the MIM Service.

Syntax

Get-PAMRequest
   [-User] <PAMUser[]>
   [-Active]
   [-Expired]
   [-Rejected]
   [-Pending]
   [-Closed]
   [-All]
   [[-Filter] <String>]
   [-CreatedFrom <DateTime>]
   [<CommonParameters>]
Get-PAMRequest
   [-User] <PAMUser[]>
   [[-Filter] <String>]
   [-Extended]
   [-CreatedFrom <DateTime>]
   [<CommonParameters>]

Description

This cmdlet returns activation requests that have been requested by a particular user with the user object as a mandatory parameter which can be retrieved by Get-PAMUser.

Examples

EXAMPLE 1

Get-PAMRequest -User (Get-PAMUser -PrivDisplayName "contoso.jen")

Description


This command retrieves requests from a user that are stored in the MIM Service.

EXAMPLE 2

Get-PAMRequest -User (Get-PAMUser -PrivDisplayName "contoso.jen") -Extended

Description


This command retrieves requests with extended properties

Parameters

-Active

Filters the returned request objects to be only those activation requests which are currently active.

Type:SwitchParameter
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-All

Return all requests.

Type:SwitchParameter
Position:7
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Closed

Return requests that are closed.

Type:SwitchParameter
Position:6
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CreatedFrom

{{Fill CreatedFrom Description}}

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

-Expired

Return requests which have expired.

Type:SwitchParameter
Position:3
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Extended

Return requests with all the extended properties.

Type:SwitchParameter
Position:9
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Filter

Specifies a clause to use in the filter when searching in the MIM Service.

Type:String
Position:8
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Pending

Only return requests which are pending.

Type:SwitchParameter
Position:5
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Rejected

Return requests which were pending approval and were rejected.

Type:SwitchParameter
Position:4
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-User

The user (or users) whose requests are to be returned, obtained from an earlier call to Get-PAMUser.

Type:PAMUser[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Outputs

Microsoft.IdentityManagement.PamCmdlets.Model.PAMRequest

The output is all the requests from a specific user which match the parameter filters.