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
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Id

ID della definizione del ruolo da eliminare

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-InputObject

Oggetto che rappresenta la definizione del ruolo da rimuovere.

Tipo:PSRoleDefinition
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Nome della definizione del ruolo da eliminare.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PassThru

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Scope

Ambito della definizione del ruolo.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-SkipClientSideScopeValidation

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Guid

String

PSRoleDefinition

Output

Boolean

Note

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