Get-AzSynapseRoleAssignment
取得 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>] Description
Get-AzSynapseRoleAssignment Cmdlet 會取得 Azure Synapse Analytics 角色指派。 如果您未指定角色定義或用戶主體名稱，此 Cmdlet 會取得所有角色指派。
Cmdlet 可能會根據輸入參數呼叫下列Microsoft圖形 API：
- GET /users/{id}
- GET /servicePrincipals/{id}
注意
若要擷取服務主體的角色指派，請在 ObjectId 參數中傳遞主體的物件標識符。
範例
範例 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 通訊的認證、帳戶、租用戶和訂用帳戶。
| 類型: | IAzureContextContainer |
| 別名: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Item
Azure Synapse 工作區的專案。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ItemType
Azure Synapse 工作區的 itemtype。
| 類型: | Microsoft.Azure.Commands.Synapse.Models.SynapseConstants+WorkspaceItemType |
| 接受的值: | ApacheSparkPool, IntegrationRuntime, LinkedService, Credential |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ObjectId
使用者、群組或服務主體的 Microsoft Entra ObjectId。
| 類型: | String |
| 別名: | Id, PrincipalId |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-RoleAssignmentId
角色指派的標識碼。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-RoleDefinitionId
指派給主體的角色標識碼。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-RoleDefinitionName
指派給主體的角色名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ServicePrincipalName
服務主體的 ServicePrincipalName。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SignInName
用戶的電子郵件地址或用戶主體名稱。
| 類型: | String |
| 別名: | Email, UserPrincipalName |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WorkspaceName
Synapse 工作區的名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WorkspaceObject
工作區輸入物件，通常是透過管線傳遞。
| 類型: | PSSynapseWorkspace |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
