Get-AzSynapseRoleAssignment

Riferimento

Modulo:: Az.Synapse

Ottiene un'assegnazione di ruolo di Synapse Analytics.

Sintassi

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

Descrizione

Il cmdlet Get-AzSynapseRoleAssignment ottiene un'assegnazione di ruolo di Azure Synapse Analytics. Se non si specifica una definizione di ruolo o un nome di entità utente, questo cmdlet ottiene tutte le assegnazioni di ruolo.

Il cmdlet può chiamare sotto l'API Microsoft Graph in base ai parametri di input:

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

Nota

Per recuperare un'assegnazione di ruolo per un'entità servizio, passare l'ID oggetto dell'entità nel parametro ObjectId.

Esempio

Esempio 1

Get-AzSynapseRoleAssignment -WorkspaceName ContosoWorkspace

Questo comando ottiene tutte le assegnazioni di ruolo in un'area di lavoro.

Esempio 2

Get-AzSynapseRoleAssignment -WorkspaceName ContosoWorkspace -RoleDefinitionName ContosoRole

Questo comando ottiene tutte le assegnazioni di ruolo nell'area di lavoro ContosoWorkspace con il nome del ruolo ContosoRole.

Esempio 3

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

Questo comando ottiene un'assegnazione di ruolo nell'area di lavoro ContosoWorkspace con il nome del ruolo ContosoRole e il nome dell'entità utente ContosoName.

Esempio 4

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

Questo comando ottiene le assegnazioni di ruolo nell'area di lavoro ContosoWorkspace con il nome del ruolo ContosoRole, il nome dell'entità utente ContosoName e il tipo di elemento ContosoItemtype.

Esempio 5

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

Questo comando ottiene un'assegnazione di ruolo nell'area di lavoro ContosoWorkspace con il nome del ruolo ContosoRole, il nome dell'entità utente ContosoName, ContosoItemType e ContosoItem.

Esempio 6

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

Questo comando ottiene tutte le assegnazioni di ruolo in un'area di lavoro tramite pipeline.

Parametri

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Item

Elemento dell'area di lavoro di Azure Synapse.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ItemType

Tipo di elemento dell'area di lavoro di Azure Synapse.

Tipo:	Microsoft.Azure.Commands.Synapse.Models.SynapseConstants+WorkspaceItemType
Valori accettati:	ApacheSparkPool, IntegrationRuntime, LinkedService, Credential
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ObjectId

Id oggetto Microsoft Entra dell'utente, del gruppo o dell'entità servizio.

Tipo:	String
Alias:	Id, PrincipalId
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-RoleAssignmentId

ID dell'assegnazione di ruolo.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-RoleDefinitionId

ID del ruolo assegnato all'entità.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-RoleDefinitionName

Nome del ruolo assegnato all'entità.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ServicePrincipalName

ServicePrincipalName dell'entità servizio.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-SignInName

Indirizzo di posta elettronica o nome dell'entità utente dell'utente.

Tipo:	String
Alias:	Email, UserPrincipalName
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-WorkspaceName

Nome dell'area di lavoro di Synapse.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-WorkspaceObject

oggetto di input dell'area di lavoro, in genere passato attraverso la pipeline.

Tipo:	PSSynapseWorkspace
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

Input

PSSynapseWorkspace

Output

PSRoleAssignmentDetails

Condividi tramite