Remove-AzKeyVaultRoleDefinition

Referenz

Modul:: Az.KeyVault

Entfernt eine benutzerdefinierte Rollendefinition aus einem HSM.

Syntax

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>]

Beschreibung

Das cmdlet Remove-AzKeyVaultRoleDefinition löscht eine benutzerdefinierte Rolle in Azure Role-Based Access Control of Azure KeyVault managed HSM. Stellen Sie den -RoleName Parameter einer vorhandenen benutzerdefinierten Rolle oder eines Rollenobjekts bereit, um diese benutzerdefinierte Rolle zu löschen. Standardmäßig werden Sie Remove-AzKeyVaultRoleDefinition zur Bestätigung aufgefordert. Verwenden Sie den parameter -Force, um die Eingabeaufforderung zu unterdrücken.

Beispiele

Beispiel 1

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

In diesem Beispiel wird eine benutzerdefinierte Rolle namens "meine Rolle" entfernt.

Beispiel 2

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

In diesem Beispiel wird eine benutzerdefinierte Rolle namens "meine Rolle" entfernt, indem das Rollenobjekt geleitet wird. Außerdem wird die Eingabeaufforderung durch -Forceunterdrückt.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:	SwitchParameter
Aliase:	cf
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:	IAzureContextContainer
Aliase:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Force

Bitten Sie nicht um Bestätigung.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-HsmName

Name des HSM.

Typ:	String
Position:	1
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-InputObject

Das Objekt, das die zu entfernende Rollendefinition darstellt.

Typ:	PSKeyVaultRoleDefinition
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-PassThru

Dieses Cmdlet gibt standardmäßig kein Objekt zurück. Wenn diese Option angegeben ist, wird "true" zurückgegeben, wenn die Option erfolgreich verläuft.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-RoleName

Name der abzurufenden Rollendefinition.

Typ:	String
Aliase:	RoleDefinitionName
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Scope

Bereich, für den die Rollenzuweisung oder Definition gilt, z. B. "/" oder "/keys" oder "/keys/{keyName}".

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:	SwitchParameter
Aliase:	wi
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

PSKeyVaultRoleDefinition

Ausgaben

Boolean

Freigeben über