Remove-IDRolePermission
SYNOPSIS
Remove an administrative permission from a role
SYNTAX
Remove-IDRolePermission [-ID] <Object> [-Path] <String> [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Revokes an administrative permission (super right) from a role, identified by its permission path. The path must match one of the values returned by `Get-IDPermission`; if it does not, a warning is written and the command stops without making the call.
EXAMPLES
Example 1
PS C:\> Remove-IDRolePermission -ID '881512ca-d441-4997-a55e-19ec5374f3b3' -Path '/Core/ManageUsers'
Remove the specified administrative permission from the role
PARAMETERS
-ID
The ID/UUID/_RowKey of the role to remove the permission from - not its display name.
Type: Object
Parameter Sets: (All)
Aliases: Uuid
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-Path
The path of the administrative permission (super right) to remove from the role. Must be one of the paths returned by `Get-IDPermission`.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Prompts you for confirmation before running the cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.