Get-AzSynapseRoleAssignment

Referenz

Modul:: Az.Synapse

Ruft eine Synapse Analytics-Rollenzuweisung ab.

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>]

Beschreibung

Das cmdlet Get-AzSynapseRoleAssignment ruft eine Azure Synapse Analytics-Rollenzuweisung ab. Wenn Sie keine Rollendefinition oder einen Benutzerprinzipalnamen angeben, ruft dieses Cmdlet alle Rollenzuweisungen ab.

Das Cmdlet kann unter der Microsoft Graph-API gemäß eingabeparametern aufgerufen werden:

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

Anmerkung

Um eine Rollenzuweisung für einen Dienstprinzipal abzurufen, übergeben Sie die Objekt-ID des Prinzipals im ObjectId-Parameter.

Beispiele

Beispiel 1

Get-AzSynapseRoleAssignment -WorkspaceName ContosoWorkspace

Dieser Befehl ruft alle Rollenzuweisungen unter einem Arbeitsbereich ab.

Beispiel 2

Get-AzSynapseRoleAssignment -WorkspaceName ContosoWorkspace -RoleDefinitionName ContosoRole

Dieser Befehl ruft alle Rollenzuweisungen unter dem Arbeitsbereich ContosoWorkspace mit dem Rollennamen ContosoRole ab.

Beispiel 3

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

Dieser Befehl ruft eine Rollenzuweisung unter dem Arbeitsbereich ContosoWorkspace mit dem Rollennamen ContosoRole und dem Benutzerprinzipalnamen ContosoName ab.

Beispiel 4

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

Dieser Befehl ruft Rollenzuweisungen unter dem Arbeitsbereich ContosoWorkspace mit dem Rollennamen ContosoRole, dem Benutzerprinzipalnamen "ContosoName" und unter dem Elementtyp "ContosoItemtype" ab.

Beispiel 5

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

Dieser Befehl ruft eine Rollenzuweisung unter dem Arbeitsbereich ContosoWorkspace mit dem Rollennamen ContosoRole, dem Benutzerprinzipalnamen ContosoName, ContosoItemType und ContosoItem ab.

Beispiel 6

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

Dieser Befehl ruft alle Rollenzuweisungen unter einem Arbeitsbereich über die Pipeline ab.

Parameter

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:	IAzureContextContainer
Aliase:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Item

Das Element des Azure Synapse-Arbeitsbereichs.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ItemType

Der Elementtyp des Azure Synapse-Arbeitsbereichs.

Typ:	Microsoft.Azure.Commands.Synapse.Models.SynapseConstants+WorkspaceItemType
Zulässige Werte:	ApacheSparkPool, IntegrationRuntime, LinkedService, Credential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ObjectId

Die Microsoft Entra-Objekt-ID des Benutzers, der Gruppe oder des Dienstprinzipals.

Typ:	String
Aliase:	Id, PrincipalId
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-RoleAssignmentId

Die ID der Rollenzuweisung.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-RoleDefinitionId

ID der Rolle, die dem Prinzipal zugewiesen ist.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-RoleDefinitionName

Der Name der Rolle, die dem Prinzipal zugewiesen ist.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ServicePrincipalName

Der ServicePrincipalName des Dienstprinzipals.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-SignInName

Die E-Mail-Adresse oder der Benutzerprinzipalname des Benutzers.

Typ:	String
Aliase:	Email, UserPrincipalName
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-WorkspaceName

Name des Synapse-Arbeitsbereichs.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-WorkspaceObject

Arbeitsbereichseingabeobjekt, in der Regel durch die Pipeline übergeben.

Typ:	PSSynapseWorkspace
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

Eingaben

PSSynapseWorkspace

Ausgaben

PSRoleAssignmentDetails

Freigeben über