Condividi tramite

Remove-AzRoleDefinition

  • Riferimento
Modulo:
Az.Resources

Elimina un ruolo personalizzato nel controllo degli accessi in base al ruolo di Azure. Il ruolo da eliminare viene specificato utilizzando la proprietà Id del ruolo. L'eliminazione avrà esito negativo se sono presenti assegnazioni di ruolo esistenti al ruolo personalizzato.

Sintassi

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

Descrizione

Il cmdlet Remove-AzRoleDefinition elimina un ruolo personalizzato nella Controllo di accesso basata su ruoli di Azure. Specificare il parametro ID di un ruolo personalizzato esistente per eliminare tale ruolo personalizzato. Per impostazione predefinita, Remove-AzRoleDefinition richiede la conferma. Per eliminare il prompt, usare il parametro Force. Se sono presenti assegnazioni di ruolo esistenti al ruolo personalizzato da eliminare, l'eliminazione avrà esito negativo.

Esempio

Esempio 1

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

Esempio 2

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

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
valore predefinito:None
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
valore predefinito:None
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Se impostato, non richiede una conferma prima di eliminare il ruolo personalizzato

Tipo:SwitchParameter
Position:Named
valore predefinito:None
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

ID della definizione del ruolo da eliminare

Tipo:Guid
Position:Named
valore predefinito:None
Necessario:True
Accept pipeline input:True
Accept wildcard characters:False

-InputObject

Oggetto che rappresenta la definizione del ruolo da rimuovere.

Tipo:PSRoleDefinition
Position:Named
valore predefinito:None
Necessario:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Nome della definizione del ruolo da eliminare.

Tipo:String
Position:0
valore predefinito:None
Necessario:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Tipo:SwitchParameter
Position:Named
valore predefinito:None
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-Scope

Ambito della definizione del ruolo.

Tipo:String
Position:Named
valore predefinito:None
Necessario:False
Accept pipeline input:True
Accept wildcard characters:False

-SkipClientSideScopeValidation

Se specificato, ignorare la convalida dell'ambito lato client.

Tipo:SwitchParameter
Position:Named
valore predefinito:None
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Tipo:SwitchParameter
Aliases:wi
Position:Named
valore predefinito:None
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

Input

Guid

String

PSRoleDefinition

Output

Boolean

Note

Parole chiave: azure, azurerm, arm, resource, management, manager, resource, group, template, deployment