Freigeben über


Get-AzSynapseRoleAssignment

Ruft eine Synapse Analytics-Rollenzuweisung ab.

Syntax

GetByWorkspaceNameAndNameParameterSet (Standard)

Get-AzSynapseRoleAssignment
    -WorkspaceName <String>
    [-RoleDefinitionName <String>]
    [-SignInName <String>]
    [-ItemType <WorkspaceItemType>]
    [-Item <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

GetByWorkspaceNameAndIdParameterSet

Get-AzSynapseRoleAssignment
    -WorkspaceName <String>
    [-RoleDefinitionName <String>]
    [-ObjectId <String>]
    [-ItemType <WorkspaceItemType>]
    [-Item <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

GetByWorkspaceNameAndRoleDefinitionIdAndObjectIdParameterSet

Get-AzSynapseRoleAssignment
    -WorkspaceName <String>
    -RoleDefinitionId <String>
    [-ObjectId <String>]
    [-ItemType <WorkspaceItemType>]
    [-Item <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

GetByWorkspaceNameAndAssignmentIdParameterSet

Get-AzSynapseRoleAssignment
    -WorkspaceName <String>
    -RoleAssignmentId <String>
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

GetByWorkspaceNameAndServicePrincipalNameParameterSet

Get-AzSynapseRoleAssignment
    -WorkspaceName <String>
    [-RoleDefinitionName <String>]
    [-ServicePrincipalName <String>]
    [-ItemType <WorkspaceItemType>]
    [-Item <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

GetByWorkspaceObjectAndNameParameterSet

Get-AzSynapseRoleAssignment
    -WorkspaceObject <PSSynapseWorkspace>
    -SignInName <String>
    [-RoleDefinitionName <String>]
    [-ItemType <WorkspaceItemType>]
    [-Item <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

GetByWorkspaceObjectAndIdParameterSet

Get-AzSynapseRoleAssignment
    -WorkspaceObject <PSSynapseWorkspace>
    [-RoleDefinitionName <String>]
    [-ObjectId <String>]
    [-ItemType <WorkspaceItemType>]
    [-Item <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

GetByWorkspaceObjectAndRoleDefinitionIdAndObjectIdParameterSet

Get-AzSynapseRoleAssignment
    -WorkspaceObject <PSSynapseWorkspace>
    -RoleDefinitionId <String>
    [-ObjectId <String>]
    [-ItemType <WorkspaceItemType>]
    [-Item <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

GetByWorkspaceObjectAndAssignmentIdParameterSet

Get-AzSynapseRoleAssignment
    -WorkspaceObject <PSSynapseWorkspace>
    -RoleAssignmentId <String>
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

GetByWorkspaceObjectAndServicePrincipalNameParameterSet

Get-AzSynapseRoleAssignment
    -WorkspaceObject <PSSynapseWorkspace>
    -ServicePrincipalName <String>
    [-RoleDefinitionName <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}

Hinweis

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

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Item

Das Element des Azure Synapse-Arbeitsbereichs.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

GetByWorkspaceNameAndNameParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
GetByWorkspaceNameAndIdParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
GetByWorkspaceNameAndRoleDefinitionIdAndObjectIdParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
GetByWorkspaceNameAndServicePrincipalNameParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
GetByWorkspaceObjectAndNameParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
GetByWorkspaceObjectAndIdParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
GetByWorkspaceObjectAndRoleDefinitionIdAndObjectIdParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
GetByWorkspaceObjectAndServicePrincipalNameParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ItemType

Der Elementtyp des Azure Synapse-Arbeitsbereichs.

Parametereigenschaften

Typ:Microsoft.Azure.Commands.Synapse.Models.SynapseConstants+WorkspaceItemType
Standardwert:None
Zulässige Werte:ApacheSparkPool, IntegrationRuntime, LinkedService, Credential
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

GetByWorkspaceNameAndNameParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
GetByWorkspaceNameAndIdParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
GetByWorkspaceNameAndRoleDefinitionIdAndObjectIdParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
GetByWorkspaceNameAndServicePrincipalNameParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
GetByWorkspaceObjectAndNameParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
GetByWorkspaceObjectAndIdParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
GetByWorkspaceObjectAndRoleDefinitionIdAndObjectIdParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
GetByWorkspaceObjectAndServicePrincipalNameParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ObjectId

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Id, PrincipalId

Parametersätze

GetByWorkspaceNameAndIdParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
GetByWorkspaceNameAndRoleDefinitionIdAndObjectIdParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
GetByWorkspaceObjectAndIdParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
GetByWorkspaceObjectAndRoleDefinitionIdAndObjectIdParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RoleAssignmentId

Die ID der Rollenzuweisung.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

GetByWorkspaceNameAndAssignmentIdParameterSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
GetByWorkspaceObjectAndAssignmentIdParameterSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RoleDefinitionId

ID der Rolle, die dem Prinzipal zugewiesen ist.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

GetByWorkspaceNameAndRoleDefinitionIdAndObjectIdParameterSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
GetByWorkspaceObjectAndRoleDefinitionIdAndObjectIdParameterSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RoleDefinitionName

Der Name der Rolle, die dem Prinzipal zugewiesen ist.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

GetByWorkspaceNameAndNameParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
GetByWorkspaceNameAndIdParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
GetByWorkspaceNameAndServicePrincipalNameParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
GetByWorkspaceObjectAndNameParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
GetByWorkspaceObjectAndIdParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
GetByWorkspaceObjectAndServicePrincipalNameParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ServicePrincipalName

Der ServicePrincipalName des Dienstprinzipals.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

GetByWorkspaceNameAndServicePrincipalNameParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SignInName

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Email, Benutzerhauptname

Parametersätze

GetByWorkspaceNameAndNameParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WorkspaceName

Name des Synapse-Arbeitsbereichs.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

GetByWorkspaceNameAndNameParameterSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
GetByWorkspaceNameAndIdParameterSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
GetByWorkspaceNameAndRoleDefinitionIdAndObjectIdParameterSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
GetByWorkspaceNameAndAssignmentIdParameterSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
GetByWorkspaceNameAndServicePrincipalNameParameterSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WorkspaceObject

Arbeitsbereichseingabeobjekt, in der Regel durch die Pipeline übergeben.

Parametereigenschaften

Typ:PSSynapseWorkspace
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

GetByWorkspaceObjectAndNameParameterSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
GetByWorkspaceObjectAndIdParameterSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
GetByWorkspaceObjectAndRoleDefinitionIdAndObjectIdParameterSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
GetByWorkspaceObjectAndAssignmentIdParameterSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
GetByWorkspaceObjectAndServicePrincipalNameParameterSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

PSSynapseWorkspace

Ausgaben

PSRoleAssignmentDetails