Udostępnij za pośrednictwem

Remove-AzRoleDefinition

  • Odwołanie
Moduł:
Az.Resources

Usuwa rolę niestandardową w kontroli dostępu opartej na rolach platformy Azure. Rola, która ma zostać usunięta, jest określana przy użyciu właściwości Id roli. Usunięcie zakończy się niepowodzeniem, jeśli istnieją przypisania ról do roli niestandardowej.

Składnia

Remove-AzRoleDefinition
      -Id <Guid>
      [-Scope <String>]
      [-SkipClientSideScopeValidation]
      [-Force]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzRoleDefinition
      [-Name] <String>
      [-Scope <String>]
      [-SkipClientSideScopeValidation]
      [-Force]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzRoleDefinition
      -InputObject <PSRoleDefinition>
      [-SkipClientSideScopeValidation]
      [-Force]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Opis

Polecenie cmdlet Remove-AzRoleDefinition usuwa rolę niestandardową w kontroli dostępu opartej na rolach platformy Azure. Podaj parametr Id istniejącej roli niestandardowej, aby usunąć rolę niestandardową. Domyślnie polecenie Remove-AzRoleDefinition monituje o potwierdzenie. Aby pominąć monit, użyj parametru Force. Jeśli istnieją przypisania ról do roli niestandardowej do usunięcia, usunięcie zakończy się niepowodzeniem.

Przykłady

Przykład 1

Get-AzRoleDefinition -Name "Virtual Machine Operator" | Remove-AzRoleDefinition

Przykład 2

Remove-AzRoleDefinition -Id "52a6cc13-ff92-47a8-a39b-2a8205c3087e"

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliases:cf
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure

Typ:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

W przypadku ustawienia nie wyświetla monitu o potwierdzenie przed usunięciem roli niestandardowej

Typ:SwitchParameter
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Identyfikator definicji roli do usunięcia

Typ:Guid
Position:Named
wartość domyślna:None
Wymagane:True
Accept pipeline input:True
Accept wildcard characters:False

-InputObject

Obiekt reprezentujący definicję roli do usunięcia.

Typ:PSRoleDefinition
Position:Named
wartość domyślna:None
Wymagane:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Nazwa definicji roli, która ma zostać usunięta.

Typ:String
Position:0
wartość domyślna:None
Wymagane:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Typ:SwitchParameter
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-Scope

Zakres definicji roli.

Typ:String
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:True
Accept wildcard characters:False

-SkipClientSideScopeValidation

Jeśli zostanie określony, pomiń walidację zakresu po stronie klienta.

Typ:SwitchParameter
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Typ:SwitchParameter
Aliases:wi
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

Guid

String

PSRoleDefinition

Dane wyjściowe

Boolean

Uwagi

Słowa kluczowe: azure, azurerm, arm, resource, management, manager, resource, group, template, deployment