Get-AzKeyVaultRoleDefinition

Moduł:

Az.KeyVault

Wyświetlanie listy definicji ról danego zarządzanego modułu HSM w danym zakresie.

Składnia

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>]

Opis

Wyświetlanie listy definicji ról danego zarządzanego modułu HSM w danym zakresie.

Przykłady

Przykład 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)

W przykładzie wymieniono wszystkie role w zakresie "/keys".

Przykład 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

Przykład pobiera rolę "Zarządzana kopia zapasowa modułu HSM" i sprawdza jego uprawnienia.

Przykład 3

Get-AzKeyVaultRoleDefinition -HsmName myHsm -Custom

W tym przykładzie wymieniono wszystkie definicje ról niestandardowych należące do "myHsm".

Parametry

-Custom

Jeśli zostanie określony, w katalogu są wyświetlane tylko niestandardowe utworzone role.

Typ:	SwitchParameter
Position:	Named
wartość domyślna:	None
Wymagane:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HsmName

Nazwa modułu HSM.

Typ:	String
Position:	1
wartość domyślna:	None
Wymagane:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-RoleDefinitionName

Nazwa definicji roli do pobrania.

Typ:	String
Aliases:	RoleName
Position:	Named
wartość domyślna:	None
Wymagane:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Scope

Zakres, w którym przypisanie lub definicja roli ma zastosowanie, np. "/" lub "/keys" lub "/keys/{keyName}". Element "/" jest używany w przypadku pominięcia.

Typ:	String
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Dane wejściowe

None

Dane wyjściowe

PSKeyVaultRoleDefinition