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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

ID della definizione del ruolo da eliminare

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-InputObject

Oggetto che rappresenta la definizione del ruolo da rimuovere.

Type:PSRoleDefinition
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Nome della definizione del ruolo da eliminare.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Scope

Ambito della definizione del ruolo.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SkipClientSideScopeValidation

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required: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