Table of Contents

Get-PnPPrivilegedIdentityManagementRole

SYNOPSIS

Required Permissions

  • Microsoft Graph: RoleManagement.Read.Directory

Retrieve the available Privileged Identity Management roles that exist within the tenant

SYNTAX

Get-PnPPrivilegedIdentityManagementRole [-Identity <PrivilegedIdentityManagementRolePipeBind>] [-Connection <PnPConnection>] 

DESCRIPTION

Retrieve the available Privileged Identity Management roles that exist within the tenant. These are the roles to which elevation can take place.

EXAMPLES

Example 1

Get-PnPPrivilegedIdentityManagementRole

Retrieves the available Privileged Identity Management roles

Example 2

Get-PnPPrivilegedIdentityManagementRole -Identity "Global Administrator"

Retrieves the Privileged Identity Management with the provided name

Example 3

Get-PnPPrivilegedIdentityManagementRole -Identity 62e90394-69f5-4237-9190-012177145e10

Retrieves the Privileged Identity Management role with the provided id

PARAMETERS

-Connection

Optional connection to be used by the cmdlet. Retrieve the value for this parameter by either specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.

Type: PnPConnection
Parameter Sets: (All)
Aliases:

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

-Identity

The name, id or instance of a Privileged Identity Management role to retrieve the details of

Type: PrivilegedIdentityManagementRolePipeBind
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: True
Accept pipeline input: True
Accept wildcard characters: False

Microsoft 365 Patterns and Practices