Delen via

Remove-AzRoleDefinition

  • Referentie
Module:
Az.Resources

Hiermee verwijdert u een aangepaste rol in Azure RBAC. De te verwijderen rol wordt opgegeven met behulp van de id-eigenschap van de rol. Verwijderen mislukt als er bestaande roltoewijzingen zijn gemaakt voor de aangepaste rol.

Syntaxis

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

Description

De cmdlet Remove-AzRoleDefinition verwijdert een aangepaste rol in op rollen gebaseerd toegangsbeheer van Azure. Geef de id-parameter van een bestaande aangepaste rol op om die aangepaste rol te verwijderen. Standaard vraagt Remove-AzRoleDefinition u om bevestiging. Gebruik de parameter Force om de prompt te onderdrukken. Als er bestaande roltoewijzingen zijn gemaakt voor de aangepaste rol die moet worden verwijderd, mislukt het verwijderen.

Voorbeelden

Voorbeeld 1

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

Voorbeeld 2

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

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

Als deze optie is ingesteld, wordt er geen bevestiging gevraagd voordat u de aangepaste rol verwijdert

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Id

Id van de roldefinitie die moet worden verwijderd

Type:Guid
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-InputObject

Het object dat de roldefinitie vertegenwoordigt die moet worden verwijderd.

Type:PSRoleDefinition
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Naam van de roldefinitie die moet worden verwijderd.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-PassThru

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Scope

Bereik van roldefinitie.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SkipClientSideScopeValidation

Als u dit hebt opgegeven, slaat u de validatie van het bereik aan de clientzijde over.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

Guid

String

PSRoleDefinition

Uitvoerwaarden

Boolean

Notities

Trefwoorden: azure, azurerm, arm, resource, beheer, manager, resource, groep, sjabloon, implementatie