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.