Delen via

Remove-AzureRmRoleDefinition

  • Referentie
Module:
AzureRM.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.

Waarschuwing

De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.

Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.

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

Description

De cmdlet Remove-AzureRmRoleDefinition 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. Met Remove-AzureRmRoleDefinition wordt u standaard 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-AzureRmRoleDefinition -Name "Virtual Machine Operator" | Remove-AzureRmRoleDefinition

Voorbeeld 2

Remove-AzureRmRoleDefinition -Id "52a6cc13-ff92-47a8-a39b-2a8205c3087e"

Parameters

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Id van de roldefinitie die moet worden verwijderd

Type:Guid
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

-InputObject

Het object dat de roldefinitie vertegenwoordigt die moet worden verwijderd.

Type:PSRoleDefinition
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Naam van de roldefinitie die moet worden verwijderd.

Type:String
Position:0
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Type:SwitchParameter
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-Scope

Bereik van roldefinitie.

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Type:SwitchParameter
Aliases:wi
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

Guid

String

PSRoleDefinition

Parameters: InputObject (ByValue)

Uitvoerwaarden

Boolean

Notities

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