Delen via

Remove-AzRoleDefinition

Module:
Az.Resources Module

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.

Syntax

RoleDefinitionIdParameterSet (Standaard) 

Remove-AzRoleDefinition
    -Id <Guid>
    [-Scope <String>]
    [-SkipClientSideScopeValidation]
    [-Force]
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

RoleDefinitionNameParameterSet 

Remove-AzRoleDefinition
    [-Name] <String>
    [-Scope <String>]
    [-SkipClientSideScopeValidation]
    [-Force]
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectParameterSet 

Remove-AzRoleDefinition
    -InputObject <PSRoleDefinition>
    [-SkipClientSideScopeValidation]
    [-Force]
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

De cmdlet Remove-AzRoleDefinition verwijdert een aangepaste rol in Azure Role-Based Toegangsbeheer. Geef de id-parameter van een bestaande aangepaste rol op om die aangepaste rol te verwijderen. Standaard wordt u Remove-AzRoleDefinition om bevestiging gevraagd. 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

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DefaultProfile

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

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzContext, AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Force

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Id

Id van de roldefinitie die moet worden verwijderd

Parametereigenschappen

Type:Guid
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

RoleDefinitionIdParameterSet
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-InputObject

Het object dat de roldefinitie vertegenwoordigt die moet worden verwijderd.

Parametereigenschappen

Type:PSRoleDefinition
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

InputObjectParameterSet
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Name

Naam van de roldefinitie die moet worden verwijderd.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

RoleDefinitionNameParameterSet
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-PassThru

De cmdlet Remove-AzRoleDefinition verwijdert een aangepaste rol in Azure Role-Based Toegangsbeheer. Geef de id-parameter van een bestaande aangepaste rol op om die aangepaste rol te verwijderen. Standaard wordt u Remove-AzRoleDefinition om bevestiging gevraagd. 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.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Scope

Bereik van roldefinitie.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

RoleDefinitionIdParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False
RoleDefinitionNameParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-SkipClientSideScopeValidation

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-WhatIf

De cmdlet Remove-AzRoleDefinition verwijdert een aangepaste rol in Azure Role-Based Toegangsbeheer. Geef de id-parameter van een bestaande aangepaste rol op om die aangepaste rol te verwijderen. Standaard wordt u Remove-AzRoleDefinition om bevestiging gevraagd. 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.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

Guid

String

PSRoleDefinition

Uitvoerwaarden

Boolean

Notities

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