Remove-AzRoleDefinition
Elimina um papel personalizado no Azure RBAC. A função a ser excluída é especificada usando a propriedade Id da função. A exclusão falhará se houver atribuições de função existentes feitas para a função personalizada.
Sintaxe
RoleDefinitionIdParameterSet (Predefinição)
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>]
Description
O cmdlet Remove-AzRoleDefinition elimina um papel personalizado em Azure Role-Based Controlo de Acesso. Forneça o parâmetro Id de uma função personalizada existente para excluir essa função personalizada. Por padrão, Remove-AzRoleDefinition solicita a confirmação. Para suprimir o prompt, use o parâmetro Force. Se houver atribuições de função existentes feitas para a função personalizada a ser excluída, a exclusão falhará.
Ao usar o parâmetro -PassThru, o cmdlet devolve o objeto PSRoleDefinition eliminado. O objeto devolvido contém uma coleção de Permissões com Ações, NotAções, DataAções, NãoDataAções e quaisquer condições de Attribute-Based Controlo de Acesso (ABAC) (Condição e Condição Versão) para cada entrada de permissões.
Exemplos
Exemplo 1: Remover um papel personalizado por pipeline a partir de Get-AzRoleDefinition
Get-AzRoleDefinition -Name "Virtual Machine Operator" | Remove-AzRoleDefinition
Recupera o papel personalizado "Operador de Máquina Virtual" e encaminha-o para Remove-AzRoleDefinition para eliminação. Ser-se-á solicitado a confirmar antes de a vaga ser eliminada.
Exemplo 2: Remover um papel personalizado por Id
Remove-AzRoleDefinition -Id "00001111-aaaa-2222-bbbb-3333cccc4444"
Apaga o papel personalizado com o ID especificado. Ser-se-á solicitado a confirmação.
Exemplo 3: Remover um papel personalizado sem confirmação
Remove-AzRoleDefinition -Name "Custom Reader Role" -Force
Apaga o papel personalizado chamado "Custom Reader Role" sem pedir confirmação.
Exemplo 4: Remover e devolver a definição de papel eliminada
$deletedRole = Remove-AzRoleDefinition -Name "Custom Writer Role" -Force -PassThru
$deletedRole.Permissions[0].Actions
Elimina o papel e devolve o objeto PSRoleDefinition, depois exibe as ações da primeira entrada de permissão.
Parâmetros
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure
Propriedades dos parâmetros
| Tipo: | IAzureContextContainer |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Force
Se definido, não solicita uma confirmação antes de excluir a função personalizada
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Id
Id da definição de função a ser excluída
Propriedades dos parâmetros
| Tipo: | Guid |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
RoleDefinitionIdParameterSet
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-InputObject
O objeto que representa a definição de função a ser removida.
Propriedades dos parâmetros
| Tipo: | PSRoleDefinition |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
InputObjectParameterSet
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Name
Nome da definição de função a ser excluída.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
RoleDefinitionNameParameterSet
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-PassThru
O cmdlet Remove-AzRoleDefinition elimina um papel personalizado em Azure Role-Based Controlo de Acesso. Forneça o parâmetro Id de uma função personalizada existente para excluir essa função personalizada. Por padrão, Remove-AzRoleDefinition solicita a confirmação. Para suprimir o prompt, use o parâmetro Force. Se houver atribuições de função existentes feitas para a função personalizada a ser excluída, a exclusão falhará.
Ao usar o parâmetro -PassThru, o cmdlet devolve o objeto PSRoleDefinition eliminado. O objeto devolvido contém uma coleção de Permissões com Ações, NotAções, DataAções, NãoDataAções e quaisquer condições de Attribute-Based Controlo de Acesso (ABAC) (Condição e Condição Versão) para cada entrada de permissões.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Scope
Escopo de definição de função.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
RoleDefinitionIdParameterSet
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
RoleDefinitionNameParameterSet
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-SkipClientSideScopeValidation
Se especificado, ignore a validação do escopo do lado do cliente.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-WhatIf
O cmdlet Remove-AzRoleDefinition elimina um papel personalizado em Azure Role-Based Controlo de Acesso. Forneça o parâmetro Id de uma função personalizada existente para excluir essa função personalizada. Por padrão, Remove-AzRoleDefinition solicita a confirmação. Para suprimir o prompt, use o parâmetro Force. Se houver atribuições de função existentes feitas para a função personalizada a ser excluída, a exclusão falhará.
Ao usar o parâmetro -PassThru, o cmdlet devolve o objeto PSRoleDefinition eliminado. O objeto devolvido contém uma coleção de Permissões com Ações, NotAções, DataAções, NãoDataAções e quaisquer condições de Attribute-Based Controlo de Acesso (ABAC) (Condição e Condição Versão) para cada entrada de permissões.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
Guid
String
PSRoleDefinition
Saídas
Boolean
Notas
Palavras-chave: azure, azurerm, arm, resource, management, manager, resource, group, template, deployment
