Get-PnPRoleDefinition
SYNOPSIS
Retrieves a Role Definitions of a site
SYNTAX
Get-PnPRoleDefinition [[-Identity] <RoleDefinitionPipeBind>] [-Connection <PnPConnection>] [<CommonParameters>]
DESCRIPTION
Allows to retrieve Role Definitions of a site.
EXAMPLES
EXAMPLE 1
Get-PnPRoleDefinition
Retrieves the Role Definitions (Permission Levels) settings of the current site
EXAMPLE 2
Get-PnPRoleDefinition -Identity Read
Retrieves the specified Role Definition (Permission Level) settings of the current site
EXAMPLE 3
Get-PnPRoleDefinition | Where-Object { $_.RoleTypeKind -eq "Administrator" }
Retrieves the Role Definition (Permission Level) settings with the Administrator type, regardless of its name
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)
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Identity
The name of a role definition to retrieve.
Type: RoleDefinitionPipeBind
Parameter Sets: (All)
Required: False
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False