Sdílet prostřednictvím


Get-AzSynapseRoleAssignment

Získá přiřazení role Synapse Analytics.

Syntax

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

Rutina Get-AzSynapseRoleAssignment získá přiřazení role Azure Synapse Analytics. Pokud nezadáte definici role nebo hlavní název uživatele, získá tato rutina všechna přiřazení role.

Rutina může volat pod rozhraním Microsoft Graph API podle vstupních parametrů:

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

Poznámka:

Pokud chcete načíst přiřazení role pro instanční objekt, předejte ID objektu instančního objektu v parametru ObjectId.

Příklady

Příklad 1

Get-AzSynapseRoleAssignment -WorkspaceName ContosoWorkspace

Tento příkaz získá všechna přiřazení rolí v pracovním prostoru.

Příklad 2

Get-AzSynapseRoleAssignment -WorkspaceName ContosoWorkspace -RoleDefinitionName ContosoRole

Tento příkaz získá všechna přiřazení rolí v rámci pracovního prostoru ContosoWorkspace s názvem role ContosoRole.

Příklad 3

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

Tento příkaz získá přiřazení role v rámci pracovního prostoru ContosoWorkspace s názvem role ContosoRole a hlavním názvem uživatele ContosoName.

Příklad 4

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

Tento příkaz získá přiřazení rolí v rámci pracovního prostoru ContosoWorkspace s názvem role ContosoRole, hlavním názvem uživatele ContosoName a pod položkou ContosoItemtype.

Příklad 5

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

Tento příkaz získá přiřazení role v rámci pracovního prostoru ContosoWorkspace s názvem role ContosoRole, hlavním názvem uživatele ContosoName, ContosoItemType a ContosoItem.

Příklad 6

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

Tento příkaz získá všechna přiřazení rolí v pracovním prostoru prostřednictvím kanálu.

Parametry

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

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

-Item

Položka pracovního prostoru Azure Synapse.

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

-ItemType

Typ položky pracovního prostoru 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 uživatele, skupiny nebo instančního objektu.

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

-RoleAssignmentId

ID přiřazení role.

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

-RoleDefinitionId

ID role přiřazené k objektu zabezpečení.

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

-RoleDefinitionName

Název role přiřazené k objektu zabezpečení.

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

-ServicePrincipalName

ServicePrincipalName instančního objektu.

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

-SignInName

E-mailová adresa nebo hlavní název uživatele.

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

-WorkspaceName

Název pracovního prostoru Synapse

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

-WorkspaceObject

vstupní objekt pracovního prostoru, obvykle předávaný kanálem.

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

Vstupy

PSSynapseWorkspace

Výstupy

PSRoleAssignmentDetails