Freigeben über

Remove-AzureRmRoleDefinition

  • Referenz
Modul:
AzureRM.Resources

Löscht eine benutzerdefinierte Rolle in Azure RBAC. Die zu löschende Rolle wird mithilfe der ID-Eigenschaft der Rolle angegeben. Das Löschen schlägt fehl, wenn an der benutzerdefinierten Rolle vorhandene Rollenzuweisungen vorgenommen werden.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul möglicherweise weiterhin funktioniert, wird es nicht mehr gewartet, und es wird kein Support mehr angeboten. Die weitere Nutzung erfolgt daher nach Ermessen und Risiko des Benutzers. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

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

Beschreibung

Mit dem Cmdlet Remove-AzureRmRoleDefinition wird eine benutzerdefinierte Rolle in der rollenbasierten Zugriffssteuerung von Azure gelöscht. Geben Sie den ID-Parameter einer vorhandenen benutzerdefinierten Rolle an, um diese benutzerdefinierte Rolle zu löschen. Standardmäßig werden Sie von Remove-AzureRmRoleDefinition zur Bestätigung aufgefordert. Verwenden Sie den Parameter Force, um die Eingabeaufforderung zu unterdrücken. Wenn an der benutzerdefinierten Rolle zu löschende Rollenzuweisungen vorhanden sind, schlägt die Löschung fehl.

Beispiele

Beispiel 1

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

Beispiel 2

Remove-AzureRmRoleDefinition -Id "00001111-aaaa-2222-bbbb-3333cccc4444"

Parameter

-Confirm

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

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

-DefaultProfile

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

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

-Force

Wenn festgelegt, wird vor dem Löschen der benutzerdefinierten Rolle keine Bestätigung angezeigt.

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

-Id

ID der zu löschenden Rollendefinition

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

-InputObject

Das Objekt, das die zu entfernende Rollendefinition darstellt.

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

-Name

Name der zu löschenden Rollendefinition.

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

-PassThru

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

-Scope

Rollendefinitionsbereich.

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

-WhatIf

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

Eingaben

Guid

String

PSRoleDefinition

Parameter: InputObject (ByValue)

Ausgaben

Boolean

Hinweise

Schlüsselwörter: azure, azurerm, arm, resource, management, manager, resource, group, template, deployment