Compartir a través de


Get-AzKeyVaultRoleDefinition

Enumere las definiciones de roles de un HSM administrado determinado en un ámbito determinado.

Syntax

Get-AzKeyVaultRoleDefinition
   [-HsmName] <String>
   [-Scope <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzKeyVaultRoleDefinition
   [-HsmName] <String>
   [-Scope <String>]
   [-Custom]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzKeyVaultRoleDefinition
   [-HsmName] <String>
   [-Scope <String>]
   -RoleDefinitionName <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Enumere las definiciones de roles de un HSM administrado determinado en un ámbito determinado.

Ejemplos

Ejemplo 1

Get-AzKeyVaultRoleDefinition -HsmName myHsm -Scope "/keys"

RoleName                              Description Permissions
--------                              ----------- -----------
Managed HSM Administrator                         1 permission(s)
Managed HSM Crypto Officer                        1 permission(s)
Managed HSM Crypto User                           1 permission(s)
Managed HSM Policy Administrator                  1 permission(s)
Managed HSM Crypto Auditor                        1 permission(s)
Managed HSM Crypto Service Encryption             1 permission(s)
Managed HSM Backup                                1 permission(s)

En el ejemplo se enumeran todos los roles en el ámbito "/keys".

Ejemplo 2

$backupRole = Get-AzKeyVaultRoleDefinition -HsmName myHsm -RoleDefinitionName "Managed HSM Backup User"

$backupRole.Permissions

Actions     NotActions  DataActions NotDataActions
-------     ----------  ----------- --------------
0 action(s) 0 action(s) 3 action(s) 0 action(s)

$backupRole.Permissions.DataActions

Microsoft.KeyVault/managedHsm/backup/start/action
Microsoft.KeyVault/managedHsm/backup/status/action
Microsoft.KeyVault/managedHsm/keys/backup/action

En el ejemplo se obtiene el rol "Copia de seguridad de HSM administrada" e inspecciona sus permisos.

Ejemplo 3

Get-AzKeyVaultRoleDefinition -HsmName myHsm -Custom

En este ejemplo se enumeran todas las definiciones de roles personalizadas que pertenecen a "myHsm".

Parámetros

-Custom

Si se especifica, solo muestra los roles creados personalizados en el directorio.

Tipo:SwitchParameter
Position:Named
valor predeterminado:None
Requerido:True
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

-HsmName

Nombre del HSM.

Tipo:String
Position:1
valor predeterminado:None
Requerido:True
Accept pipeline input:False
Accept wildcard characters:False

-RoleDefinitionName

Nombre de la definición de roles que se va a obtener.

Tipo:String
Aliases:RoleName
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}". '/' se usa cuando se omite.

Tipo:String
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

None

Salidas

PSKeyVaultRoleDefinition