Compartir a través de

Remove-AzureRmRoleDefinition

  • Referencia
Módulo:
AzureRM.Resources

Elimina un rol personalizado en RBAC de Azure. El rol que se va a eliminar se especifica mediante la propiedad Id del rol. Se producirá un error en la eliminación si hay asignaciones de roles existentes realizadas al rol personalizado.

Advertencia

El módulo AzureRM PowerShell ha quedado oficialmente obsoleto a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no recibirá mantenimiento ni soporte técnico, lo que significa que su uso continuado queda a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Sintaxis

Remove-AzureRmRoleDefinition
      -Id <Guid>
      [-Scope <String>]
      [-Force]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureRmRoleDefinition
      [-Name] <String>
      [-Scope <String>]
      [-Force]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureRmRoleDefinition
      -InputObject <PSRoleDefinition>
      [-Force]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

El cmdlet Remove-AzureRmRoleDefinition elimina un rol personalizado en el control de acceso basado en rol de Azure. Proporcione el parámetro Id de un rol personalizado existente para eliminar ese rol personalizado. De forma predeterminada, Remove-AzureRmRoleDefinition le pide confirmación. Para suprimir el símbolo del sistema, use el parámetro Force. Si hay asignaciones de roles existentes realizadas al rol personalizado que se va a eliminar, se producirá un error en la eliminación.

Ejemplos

Ejemplo 1

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

Ejemplo 2

Remove-AzureRmRoleDefinition -Id "00001111-aaaa-2222-bbbb-3333cccc4444"

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Force

Si se establece, no solicita una confirmación antes de eliminar el rol personalizado.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Id

Identificador de la definición de rol que se va a eliminar

Tipo:Guid
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-InputObject

Objeto que representa la definición de rol que se va a quitar.

Tipo:PSRoleDefinition
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Name

Nombre de la definición de rol que se va a eliminar.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-PassThru

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Scope

Ámbito de definición de roles.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

Guid

String

PSRoleDefinition

Parámetros: InputObject (ByValue)

Salidas

Boolean

Notas

Palabras clave: azure, azurerm, arm, resource, management, manager, resource, group, template, deployment