Get-PAMRole

Gets PAM roles from the MIM Service.

Syntax

Get-PAMRole
   [[-DisplayName] <String>]
   [[-Session] <PAMSession>]
   [-Active]
   [[-Filter] <String>]
   [<CommonParameters>]

Description

The Get-PAMRole cmdlet gets Privileged Access Management (PAM) roles from the Microsoft Identity Manager (MIM) Service.

Examples

Example 1: Retrieve a single PAM role

PS C:\> $Role = Get-PAMRole -DisplayName "IT"

This command gets a single PAM role with a specified display name from the MIM Service.

Optional Parameters

-Active

Indicates that this cmdlet gets roles with activation requests that are currently active.

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

Specifies a matching value for the DisplayName attribute of a PAM role resource in the MIM Service.

Type:String
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Filter

Specifies a clause to use as a filter.

Type:String
Position:4
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Session

Specifies a session with the PAM domain and the MIM Service.

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

Outputs

Microsoft.IdentityManagement.PamCmdlets.Model.PAMRole