Remove-AzRoleDefinition
Elimina un ruolo personalizzato in Azure controllo degli accessi in base al ruolo. 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
RoleDefinitionIdParameterSet (Impostazione predefinita)
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>]
Descrizione
Il cmdlet Remove-AzRoleDefinition elimina un ruolo personalizzato in Azure Role-Based Controllo di accesso. 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.
Quando si usa il parametro -PassThru, il cmdlet restituisce l'oggetto PSRoleDefinition eliminato. L'oggetto restituito contiene un insieme Permissions con Actions, NotActions, DataActions, NotDataActions ed eventuali condizioni di Attribute-Based Controllo di accesso (ABAC) (Condizione e ConditionVersion) per ogni voce di autorizzazione.
Esempio
Esempio 1: Rimuovere un ruolo personalizzato tramite pipe da Get-AzRoleDefinition
Get-AzRoleDefinition -Name "Virtual Machine Operator" | Remove-AzRoleDefinition
Recupera il ruolo personalizzato "Operatore macchina virtuale" e lo invia tramite pipe a Remove-AzRoleDefinition per l'eliminazione. Verrà richiesta la conferma prima dell'eliminazione del ruolo.
Esempio 2: Rimuovere un ruolo personalizzato in base all'ID
Remove-AzRoleDefinition -Id "00001111-aaaa-2222-bbbb-3333cccc4444"
Elimina il ruolo personalizzato con l'ID specificato. Verrà richiesto di confermare.
Esempio 3: Rimuovere un ruolo personalizzato senza conferma
Remove-AzRoleDefinition -Name "Custom Reader Role" -Force
Elimina il ruolo personalizzato denominato "Ruolo lettore personalizzato" senza richiedere conferma.
Esempio 4: Rimuovere e restituire la definizione di ruolo eliminata
$deletedRole = Remove-AzRoleDefinition -Name "Custom Writer Role" -Force -PassThru
$deletedRole.Permissions[0].Actions
Elimina il ruolo e restituisce l'oggetto PSRoleDefinition, quindi visualizza le azioni dalla prima voce di autorizzazione.
Parametri
-Confirm
Richiede conferma prima di eseguire il cmdlet.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | cfr |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-DefaultProfile
Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure
Proprietà dei parametri
| Tipo: | IAzureContextContainer |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | AzContext, AzureRmContext, AzureCredential |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Force
Se impostato, non richiede una conferma prima di eliminare il ruolo personalizzato
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Id
ID della definizione del ruolo da eliminare
Proprietà dei parametri
| Tipo: | Guid |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
RoleDefinitionIdParameterSet
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-InputObject
Oggetto che rappresenta la definizione del ruolo da rimuovere.
Proprietà dei parametri
| Tipo: | PSRoleDefinition |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
InputObjectParameterSet
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Name
Nome della definizione del ruolo da eliminare.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
RoleDefinitionNameParameterSet
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-PassThru
Il cmdlet Remove-AzRoleDefinition elimina un ruolo personalizzato in Azure Role-Based Controllo di accesso. 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.
Quando si usa il parametro -PassThru, il cmdlet restituisce l'oggetto PSRoleDefinition eliminato. L'oggetto restituito contiene un insieme Permissions con Actions, NotActions, DataActions, NotDataActions ed eventuali condizioni di Attribute-Based Controllo di accesso (ABAC) (Condizione e ConditionVersion) per ogni voce di autorizzazione.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Scope
Ambito della definizione del ruolo.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
RoleDefinitionIdParameterSet
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
RoleDefinitionNameParameterSet
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-SkipClientSideScopeValidation
Se specificato, ignorare la convalida dell'ambito lato client.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Il cmdlet Remove-AzRoleDefinition elimina un ruolo personalizzato in Azure Role-Based Controllo di accesso. 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.
Quando si usa il parametro -PassThru, il cmdlet restituisce l'oggetto PSRoleDefinition eliminato. L'oggetto restituito contiene un insieme Permissions con Actions, NotActions, DataActions, NotDataActions ed eventuali condizioni di Attribute-Based Controllo di accesso (ABAC) (Condizione e ConditionVersion) per ogni voce di autorizzazione.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Wi |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Input
Guid
String
PSRoleDefinition
Output
Boolean
Note
Parole chiave: azure, azurerm, arm, resource, management, manager, resource, group, template, deployment
