Dela via


Get-AzSynapseRoleAssignment

Hämtar en Rolltilldelning för 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

Cmdleten Get-AzSynapseRoleAssignment hämtar en rolltilldelning för Azure Synapse Analytics. Om du inte anger någon rolldefinition eller ett huvudnamn för användaren hämtar den här cmdleten all rolltilldelning.

Cmdleten kan anropa under Microsoft Graph API enligt indataparametrar:

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

Kommentar

Om du vill hämta en rolltilldelning för ett huvudnamn för tjänsten skickar du objekt-ID:t för huvudkontot i parametern ObjectId.

Exempel

Exempel 1

Get-AzSynapseRoleAssignment -WorkspaceName ContosoWorkspace

Det här kommandot hämtar alla rolltilldelningar under en arbetsyta.

Exempel 2

Get-AzSynapseRoleAssignment -WorkspaceName ContosoWorkspace -RoleDefinitionName ContosoRole

Det här kommandot hämtar alla rolltilldelningar under arbetsytan ContosoWorkspace med rollnamnet ContosoRole.

Exempel 3

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

Det här kommandot hämtar en rolltilldelning under arbetsytan ContosoWorkspace med rollnamnet ContosoRole och användarens huvudnamn ContosoName.

Exempel 4

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

Det här kommandot hämtar rolltilldelningar under arbetsytan ContosoWorkspace med rollnamnet ContosoRole, användarens huvudnamn ContosoName och under itemtype ContosoItemtype.

Exempel 5

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

Det här kommandot hämtar en rolltilldelning under arbetsytan ContosoWorkspace med rollnamnet ContosoRole, användarens huvudnamn ContosoName, ContosoItemType och ContosoItem.

Exempel 6

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

Det här kommandot hämtar alla rolltilldelningar under en arbetsyta via pipeline.

Parametrar

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

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

-Item

Objektet för Azure Synapse-arbetsytan.

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

-ItemType

Objekttypen för Azure Synapse-arbetsytan.

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 för användaren, gruppen eller tjänstens huvudnamn.

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

-RoleAssignmentId

ID för rolltilldelningen.

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

-RoleDefinitionId

ID för rollen som är tilldelad till huvudnamnet.

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

-RoleDefinitionName

Namnet på den roll som har tilldelats till huvudnamnet.

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

-ServicePrincipalName

ServicePrincipalName för tjänstens huvudnamn.

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

-SignInName

E-postadressen eller användarens huvudnamn.

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

-WorkspaceName

Namnet på Synapse-arbetsytan.

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

-WorkspaceObject

indataobjekt för arbetsytan, som vanligtvis skickas via pipelinen.

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

Indata

PSSynapseWorkspace

Utdata

PSRoleAssignmentDetails