Partager via


Get-AzSynapseRoleAssignment

Obtient une attribution de rôle Synapse Analytics.

Syntaxe

GetByWorkspaceNameAndNameParameterSet (Par défaut)

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

Description

L’applet de commande Get-AzSynapseRoleAssignment obtient une attribution de rôle Azure Synapse Analytics. Si vous ne spécifiez pas de définition de rôle ou de nom d’utilisateur principal, cette applet de commande obtient toutes les attributions de rôles.

L’applet de commande peut appeler sous l’API Microsoft Graph en fonction des paramètres d’entrée :

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

Note

Pour récupérer une attribution de rôle pour un principal de service, transmettez l’ID d’objet du principal dans le paramètre ObjectId.

Exemples

Exemple 1

Get-AzSynapseRoleAssignment -WorkspaceName ContosoWorkspace

Cette commande obtient toutes les attributions de rôles sous un espace de travail.

Exemple 2

Get-AzSynapseRoleAssignment -WorkspaceName ContosoWorkspace -RoleDefinitionName ContosoRole

Cette commande obtient toutes les attributions de rôles sous l’espace de travail ContosoWorkspace avec le nom de rôle ContosoRole.

Exemple 3

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

Cette commande obtient une attribution de rôle sous l’espace de travail ContosoWorkspace avec le nom de rôle ContosoRole et le nom d’utilisateur principal ContosoName.

Exemple 4

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

Cette commande obtient les attributions de rôles sous l’espace de travail ContosoWorkspace avec le nom de rôle ContosoRole, le nom d’utilisateur principal ContosoName et sous itemtype ContosoItemtype.

Exemple 5

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

Cette commande obtient une attribution de rôle sous l’espace de travail ContosoWorkspace avec le nom de rôle ContosoRole, le nom d’utilisateur principal ContosoName, ContosoItemType et ContosoItem.

Exemple 6

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

Cette commande obtient toutes les attributions de rôles sous un espace de travail via le pipeline.

Paramètres

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Item

Élément de l’espace de travail Azure Synapse.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

GetByWorkspaceNameAndNameParameterSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
GetByWorkspaceNameAndIdParameterSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
GetByWorkspaceNameAndRoleDefinitionIdAndObjectIdParameterSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
GetByWorkspaceNameAndServicePrincipalNameParameterSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
GetByWorkspaceObjectAndNameParameterSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
GetByWorkspaceObjectAndIdParameterSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
GetByWorkspaceObjectAndRoleDefinitionIdAndObjectIdParameterSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
GetByWorkspaceObjectAndServicePrincipalNameParameterSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ItemType

Type d’élément de l’espace de travail Azure Synapse.

Propriétés du paramètre

Type:Microsoft.Azure.Commands.Synapse.Models.SynapseConstants+WorkspaceItemType
Valeur par défaut:None
Valeurs acceptées:ApacheSparkPool, IntegrationRuntime, LinkedService, Credential
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

GetByWorkspaceNameAndNameParameterSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
GetByWorkspaceNameAndIdParameterSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
GetByWorkspaceNameAndRoleDefinitionIdAndObjectIdParameterSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
GetByWorkspaceNameAndServicePrincipalNameParameterSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
GetByWorkspaceObjectAndNameParameterSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
GetByWorkspaceObjectAndIdParameterSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
GetByWorkspaceObjectAndRoleDefinitionIdAndObjectIdParameterSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
GetByWorkspaceObjectAndServicePrincipalNameParameterSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ObjectId

Microsoft Entra ObjectId de l’utilisateur, du groupe ou du principal du service.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Id, PrincipalId

Jeux de paramètres

GetByWorkspaceNameAndIdParameterSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
GetByWorkspaceNameAndRoleDefinitionIdAndObjectIdParameterSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
GetByWorkspaceObjectAndIdParameterSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
GetByWorkspaceObjectAndRoleDefinitionIdAndObjectIdParameterSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RoleAssignmentId

ID de l’attribution de rôle.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

GetByWorkspaceNameAndAssignmentIdParameterSet
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
GetByWorkspaceObjectAndAssignmentIdParameterSet
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RoleDefinitionId

ID du rôle affecté au principal.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

GetByWorkspaceNameAndRoleDefinitionIdAndObjectIdParameterSet
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
GetByWorkspaceObjectAndRoleDefinitionIdAndObjectIdParameterSet
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RoleDefinitionName

Nom du rôle affecté au principal.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

GetByWorkspaceNameAndNameParameterSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
GetByWorkspaceNameAndIdParameterSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
GetByWorkspaceNameAndServicePrincipalNameParameterSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
GetByWorkspaceObjectAndNameParameterSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
GetByWorkspaceObjectAndIdParameterSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
GetByWorkspaceObjectAndServicePrincipalNameParameterSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ServicePrincipalName

ServicePrincipalName du principal de service.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

GetByWorkspaceNameAndServicePrincipalNameParameterSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SignInName

Adresse e-mail ou nom d’utilisateur principal de l’utilisateur.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Messagerie électronique, Nom Principal de l'Utilisateur

Jeux de paramètres

GetByWorkspaceNameAndNameParameterSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WorkspaceName

Nom de l’espace de travail Synapse.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

GetByWorkspaceNameAndNameParameterSet
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
GetByWorkspaceNameAndIdParameterSet
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
GetByWorkspaceNameAndRoleDefinitionIdAndObjectIdParameterSet
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
GetByWorkspaceNameAndAssignmentIdParameterSet
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
GetByWorkspaceNameAndServicePrincipalNameParameterSet
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WorkspaceObject

objet d’entrée d’espace de travail, généralement passé par le pipeline.

Propriétés du paramètre

Type:PSSynapseWorkspace
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

GetByWorkspaceObjectAndNameParameterSet
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
GetByWorkspaceObjectAndIdParameterSet
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
GetByWorkspaceObjectAndRoleDefinitionIdAndObjectIdParameterSet
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
GetByWorkspaceObjectAndAssignmentIdParameterSet
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
GetByWorkspaceObjectAndServicePrincipalNameParameterSet
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

PSSynapseWorkspace

Sorties

PSRoleAssignmentDetails