Remove-AzKeyVaultRoleDefinition
Quita una definición de rol personalizada de un HSM.
Syntax
Remove-AzKeyVaultRoleDefinition
[-HsmName] <String>
[-Scope <String>]
-RoleName <String>
[-Force]
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Remove-AzKeyVaultRoleDefinition
[-HsmName] <String>
[-Scope <String>]
-InputObject <PSKeyVaultRoleDefinition>
[-Force]
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
El Remove-AzKeyVaultRoleDefinition cmdlet elimina un rol personalizado en el control de acceso basado en rol de Azure de HSM administrado por Azure KeyVault.
Proporcione el -RoleName parámetro de un rol personalizado existente o un objeto de rol para eliminar ese rol personalizado.
De forma predeterminada, Remove-AzKeyVaultRoleDefinition le pide confirmación.
Para suprimir el símbolo del sistema, use el -Force parámetro .
Ejemplos
Ejemplo 1
Remove-AzKeyVaultRoleDefinition -HsmName myHsm -RoleName "my role"En este ejemplo se quita un rol personalizado denominado "my role".
Ejemplo 2
$role = Get-AzKeyVaultRoleDefinition -HsmName myHsm -RoleName "my role"
$role | Remove-AzKeyVaultRoleDefinition -HsmName myHsm -ForceEn este ejemplo se quita un rol personalizado denominado "mi rol" canalizando el objeto de rol. También suprime el mensaje por -Force.
Parámetros
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.
| Tipo: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
No pida confirmación.
| Tipo: | SwitchParameter |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HsmName
Nombre del HSM.
| Tipo: | String |
| Position: | 1 |
| valor predeterminado: | None |
| Requerido: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Objeto que representa la definición de rol que se va a quitar.
| Tipo: | PSKeyVaultRoleDefinition |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PassThru
Este cmdlet no devuelve un objeto de forma predeterminada. Si se especifica este modificador, devuelve true si se ejecuta correctamente.
| Tipo: | SwitchParameter |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RoleName
Nombre de la definición de roles que se va a obtener.
| Tipo: | String |
| Aliases: | RoleDefinitionName |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Scope
Ámbito en el que se aplica la asignación o definición de roles, por ejemplo, "/" o "/keys" o "/keys/{keyName}".
| Tipo: | String |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |