Remove-AzKeyVaultRoleDefinition

  • Odwołanie
Moduł:
Az.KeyVault

Usuwa definicję roli niestandardowej z modułu HSM.

Składnia

Remove-AzKeyVaultRoleDefinition
      [-HsmName] <String>
      [-Scope <String>]
      -RoleName <String>
      [-Force]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzKeyVaultRoleDefinition
      [-HsmName] <String>
      [-Scope <String>]
      -InputObject <PSKeyVaultRoleDefinition>
      [-Force]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Opis

Polecenie Remove-AzKeyVaultRoleDefinition cmdlet usuwa rolę niestandardową w kontroli dostępu opartej na rolach platformy Azure zarządzanego modułu HSM usługi Azure KeyVault. -RoleName Podaj parametr istniejącej roli niestandardowej lub obiektu roli w celu usunięcia tej roli niestandardowej. Domyślnie Remove-AzKeyVaultRoleDefinition monituje o potwierdzenie. Aby pominąć monit, użyj parametru -Force .

Przykłady

Przykład 1

Remove-AzKeyVaultRoleDefinition -HsmName myHsm -RoleName "my role"

W tym przykładzie usunięto rolę niestandardową o nazwie "moja rola".

Przykład 2

$role = Get-AzKeyVaultRoleDefinition -HsmName myHsm -RoleName "my role"
$role | Remove-AzKeyVaultRoleDefinition -HsmName myHsm -Force

W tym przykładzie usunięto rolę niestandardową o nazwie "moja rola", potokując obiekt roli. Pomija również monit za pomocą polecenia -Force.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Nie pytaj o potwierdzenie.

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

-HsmName

Nazwa modułu HSM.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

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

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

-PassThru

To polecenie cmdlet domyślnie nie zwraca obiektu. Jeśli ten przełącznik zostanie określony, zwraca wartość true, jeśli operacja powiedzie się.

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

-RoleName

Nazwa definicji roli do pobrania.

Type:String
Aliases:RoleDefinitionName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Scope

Zakres, w którym przypisanie lub definicja roli ma zastosowanie, np. "/" lub "/keys" lub "/keys/{keyName}".

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

PSKeyVaultRoleDefinition

Dane wyjściowe

Boolean