Remove-AmsRoleAuthorizationRule

SYNOPSIS

Removes a role authorization rule

SYNTAX

Remove-AmsRoleAuthorizationRule [-Id <String>] [-Force] [<CommonParameters>]

DESCRIPTION

This cmdlet permanently removes a role authorization rule from the server

EXAMPLES

Example 1

PS C:\> Remove-AmsRoleAuthorizationRule -Id '6d34b2f3-dd28-4dc6-893f-f64f4d099bd6'

Removes a role by its known ID

Example 2

PS C:\> Get-AmsRoleAuthorizationRule -Name "My custom role" | Remove-AmsRoleAuthorizationRule

Get a role authorization rule by name and removes it

PARAMETERS

-Force

Removes the rule without prompting for confirmation

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Id

The unique ID of the rule

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
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.

INPUTS

System.String

OUTPUTS

System.Void

NOTES

Use of this cmdlet requires an Enterprise Edition license.

RELATED LINKS