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

Get-AzSynapseRoleAssignment

模块:

Az.Synapse

获取 Synapse Analytics 角色分配。

语法

Get-AzSynapseRoleAssignment
   -WorkspaceName <String>
   [-RoleDefinitionName <String>]
   [-SignInName <String>]
   [-ItemType <WorkspaceItemType>]
   [-Item <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzSynapseRoleAssignment
   -WorkspaceName <String>
   [-RoleDefinitionName <String>]
   [-ObjectId <String>]
   [-ItemType <WorkspaceItemType>]
   [-Item <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzSynapseRoleAssignment
   -WorkspaceName <String>
   -RoleDefinitionId <String>
   [-ObjectId <String>]
   [-ItemType <WorkspaceItemType>]
   [-Item <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzSynapseRoleAssignment
   -WorkspaceName <String>
   -RoleAssignmentId <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzSynapseRoleAssignment
   -WorkspaceName <String>
   [-RoleDefinitionName <String>]
   [-ServicePrincipalName <String>]
   [-ItemType <WorkspaceItemType>]
   [-Item <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzSynapseRoleAssignment
   -WorkspaceObject <PSSynapseWorkspace>
   [-RoleDefinitionName <String>]
   -SignInName <String>
   [-ItemType <WorkspaceItemType>]
   [-Item <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzSynapseRoleAssignment
   -WorkspaceObject <PSSynapseWorkspace>
   [-RoleDefinitionName <String>]
   [-ObjectId <String>]
   [-ItemType <WorkspaceItemType>]
   [-Item <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzSynapseRoleAssignment
   -WorkspaceObject <PSSynapseWorkspace>
   -RoleDefinitionId <String>
   [-ObjectId <String>]
   [-ItemType <WorkspaceItemType>]
   [-Item <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzSynapseRoleAssignment
   -WorkspaceObject <PSSynapseWorkspace>
   -RoleAssignmentId <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzSynapseRoleAssignment
   -WorkspaceObject <PSSynapseWorkspace>
   [-RoleDefinitionName <String>]
   -ServicePrincipalName <String>
   [-ItemType <WorkspaceItemType>]
   [-Item <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

说明

Get-AzSynapseRoleAssignment cmdlet 获取 Azure Synapse Analytics 角色分配。 如果未指定角色定义或用户主体名称，此 cmdlet 将获取所有角色分配。

该 cmdlet 可以根据输入参数调用以下 Microsoft Graph API：

• GET /users/{id}
• GET /servicePrincipals/{id}

注意

若要检索服务主体的角色分配，请传递 ObjectId 参数中主体的对象 ID。

示例

示例 1

Get-AzSynapseRoleAssignment -WorkspaceName ContosoWorkspace

此命令获取工作区下的所有角色分配。

示例 2

Get-AzSynapseRoleAssignment -WorkspaceName ContosoWorkspace -RoleDefinitionName ContosoRole

此命令获取工作区 ContosoWorkspace 下的所有角色分配，其角色名称为 ContosoRole。

示例 3

Get-AzSynapseRoleAssignment -WorkspaceName ContosoWorkspace -RoleDefinitionName ContosoRole -SignInName ContosoName

此命令在工作区 ContosoWorkspace 下获取角色分配，其角色名称为 ContosoRole 和用户主体名称 ContosoName。

示例 4

Get-AzSynapseRoleAssignment -WorkspaceName ContosoWorkspace -RoleDefinitionName ContosoRole -SignInName ContosoName -ItemType ContosoItemType

此命令获取工作区 ContosoWorkspace 下的角色分配，其角色名称为 ContosoRole、用户主体名称 ContosoName 和 itemtype ContosoItemtype。

示例 5

Get-AzSynapseRoleAssignment -WorkspaceName ContosoWorkspace -RoleDefinitionName ContosoRole -SignInName ContosoName -ItemType ContosoItemType -Item ContosoItem

此命令在工作区 ContosoWorkspace 下获取角色分配，其角色名称为 ContosoRole、用户主体名称 ContosoName、ContosoItemType 和 ContosoItem。

示例 6

$ws = Get-AzSynapseWorkspace -Name ContosoWorkspace
$ws | Get-AzSynapseRoleAssignment

此命令通过管道获取工作区下的所有角色分配。

参数

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Item

Azure Synapse 工作区的项。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ItemType

Azure Synapse 工作区的项类型。

Type:	Microsoft.Azure.Commands.Synapse.Models.SynapseConstants+WorkspaceItemType
Accepted values:	ApacheSparkPool, IntegrationRuntime, LinkedService, Credential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ObjectId

用户、组或服务主体的 Microsoft Entra ObjectId。

Type:	String
Aliases:	Id, PrincipalId
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RoleAssignmentId

角色分配的 ID。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-RoleDefinitionId

分配给主体的角色的 ID。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-RoleDefinitionName

分配给主体的角色的名称。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServicePrincipalName

服务主体的 ServicePrincipalName。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-SignInName

用户的电子邮件地址或用户主体名称。

Type:	String
Aliases:	Email, UserPrincipalName
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WorkspaceName

Synapse 工作区的名称。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WorkspaceObject

工作区输入对象，通常通过管道传递。

Type:	PSSynapseWorkspace
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

输入

PSSynapseWorkspace

输出

PSRoleAssignmentDetails