다음을 통해 공유


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 Graph API 아래에서 호출할 수 있습니다.

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

참고 항목

서비스 주체에 대한 역할 할당을 검색하려면 ObjectId 매개 변수에서 보안 주체의 개체 ID를 전달합니다.

예제

예 1

Get-AzSynapseRoleAssignment -WorkspaceName ContosoWorkspace

이 명령은 작업 영역 아래의 모든 역할 할당을 가져옵니다.

예제 2

Get-AzSynapseRoleAssignment -WorkspaceName ContosoWorkspace -RoleDefinitionName ContosoRole

이 명령은 ContosoRole이라는 역할 이름을 가진 작업 영역 ContosoWorkspace에서 모든 역할 할당을 가져옵니다.

예제 3

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

이 명령은 ContosoRole 역할 이름 및 사용자 계정 이름 ContosoName이 있는 작업 영역 ContosoWorkspace에서 역할 할당을 가져옵니다.

예시 4

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

이 명령은 ContosoRole, 사용자 계정 이름 ContosoName 및 itemtype ContosoItemtype 아래의 작업 영역 ContosoWorkspace에서 역할 할당을 가져옵니다.

예시 5

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

이 명령은 역할 이름 ContosoRole, 사용자 계정 이름 ContosoName, ContosoItemType 및 ContosoItem이 있는 작업 영역 ContosoWorkspace에서 역할 할당을 가져옵니다.

예제 6

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

이 명령은 파이프라인을 통해 작업 영역 아래의 모든 역할 할당을 가져옵니다.

매개 변수

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

형식:IAzureContextContainer
별칭:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Item

Azure Synapse 작업 영역의 항목입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ItemType

Azure Synapse 작업 영역의 항목 유형입니다.

형식:Microsoft.Azure.Commands.Synapse.Models.SynapseConstants+WorkspaceItemType
허용되는 값:ApacheSparkPool, IntegrationRuntime, LinkedService, Credential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ObjectId

사용자, 그룹 또는 서비스 주체의 Microsoft Entra ObjectId입니다.

형식:String
별칭:Id, PrincipalId
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RoleAssignmentId

역할 할당의 ID입니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RoleDefinitionId

보안 주체에 할당된 역할의 ID입니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RoleDefinitionName

보안 주체에 할당된 역할의 이름입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ServicePrincipalName

서비스 주체의 ServicePrincipalName입니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SignInName

사용자의 전자 메일 주소 또는 사용자 계정 이름입니다.

형식:String
별칭:Email, UserPrincipalName
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WorkspaceName

Synapse 작업 영역의 이름입니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WorkspaceObject

일반적으로 파이프라인을 통해 전달되는 작업 영역 입력 개체입니다.

형식:PSSynapseWorkspace
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

입력

PSSynapseWorkspace

출력

PSRoleAssignmentDetails