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 Remove-AzKeyVaultRoleDefinition Cmdlet löscht eine benutzerdefinierte Rolle in azure Role-Based Access Control of Azure KeyVault managed HSM. Geben Sie den -RoleName Parameter einer vorhandenen benutzerdefinierten Rolle oder eines Rollenobjekts an, um diese benutzerdefinierte Rolle zu löschen. Fordert Sie standardmäßig Remove-AzKeyVaultRoleDefinition zur Bestätigung auf. Verwenden Sie den -Force Parameter, 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. Sie unterdrückt auch die Eingabeaufforderung von -Force.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

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

-Force

Bitten Sie nicht um Bestätigung.

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

-HsmName

Name des HSM.

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

-InputObject

Das Objekt, das die zu entfernende Rollendefinition darstellt.

Type:	PSKeyVaultRoleDefinition
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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.

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

-RoleName

Name der abzurufenden Rollendefinition.

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

-Scope

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

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

-WhatIf

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

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

Eingaben

PSKeyVaultRoleDefinition

Ausgaben

Boolean

Share via