你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Get-AzKeyVaultRoleAssignment

参考

模块:: Az.KeyVault

获取或列出托管 HSM 的角色分配。使用相应的参数列出特定用户或角色定义的分配。

语法

Get-AzKeyVaultRoleAssignment
   [-HsmName] <String>
   [-Scope <String>]
   [-RoleDefinitionName <String>]
   [-RoleDefinitionId <String>]
   [-ObjectId <String>]
   [-SignInName <String>]
   [-ApplicationId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzKeyVaultRoleAssignment
   [-HsmName] <String>
   [-Scope <String>]
   -RoleAssignmentName <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

说明

使用 Get-AzKeyVaultRoleAssignment 命令列出在范围上生效的所有角色分配。如果没有任何参数，此命令将返回在托管 HSM 下执行的所有角色分配。可以使用主体、角色和范围的筛选参数筛选此列表。必须指定工作分配的主题。若要指定用户，请使用 SignInName 或 Microsoft Entra ObjectId 参数。若要指定安全组，请使用 Microsoft Entra ObjectId 参数。若要指定 Microsoft Entra 应用程序，请使用 ApplicationId 或 ObjectId 参数。必须使用 RoleDefinitionName 或 RoleDefinitionId 参数指定所分配的角色。可以指定授予访问权限的范围。默认为“/”。

cmdlet 可以根据输入参数调用以下Microsoft图形 API：

GET /directoryObjects/{id}
GET /users/{id}
GET /servicePrincipals/{id}
GET /groups/{id}

示例

示例 1

Get-AzKeyVaultRoleAssignment -HsmName myHsm

RoleDefinitionName         DisplayName                      ObjectType Scope
------------------         -----------                      ---------- -----
Managed HSM Administrator  User 1 (user1@microsoft.com)     User       /
Managed HSM Crypto Auditor User 2 (user2@microsoft.com)     User       /keys
Managed HSM Backup         User 2 (user2@microsoft.com)     User       /
Managed HSM Administrator  User 2 (user2@microsoft.com)     User       /

此示例列出所有作用域上“myHsm”的所有角色分配。

示例 2

Get-AzKeyVaultRoleAssignment -HsmName myHsm -SignInName user1@microsoft.com -Scope "/keys"

RoleDefinitionName         DisplayName                      ObjectType Scope
------------------         -----------                      ---------- -----
Managed HSM Crypto Auditor User 1 (user1@microsoft.com)     User       /keys
Managed HSM Backup         User 1 (user1@microsoft.com)     User       /keys

此示例列出“/keys”范围上“myHsm”的所有角色分配，并按用户登录名称筛选结果。

参数

-ApplicationId

应用 SPN。

类型:	String
别名:	SPN, ServicePrincipalName
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:	IAzureContextContainer
别名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-HsmName

HSM 的名称。

类型:	String
Position:	1
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ObjectId

用户或组对象 ID。

类型:	String
别名:	Id, PrincipalId
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RoleAssignmentName

角色分配的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-RoleDefinitionId

将主体分配到的角色 ID。

类型:	String
别名:	RoleId
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RoleDefinitionName

要为其分配主体的 RBAC 角色的名称。

类型:	String
别名:	RoleName
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Scope

角色分配或定义应用于的范围，例如“/”或“/keys”或“/keys/{keyName}”。省略时使用“/”。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SignInName

用户 SignInName。

类型:	String
别名:	Email, UserPrincipalName
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

None

输出

PSKeyVaultRoleAssignment

通过