Condividi tramite

New-AzSynapseRoleAssignment

  • Riferimento
Modulo:
Az.Synapse

Crea un'assegnazione di ruolo di Synapse Analytics.

Sintassi

New-AzSynapseRoleAssignment
   -WorkspaceName <String>
   -RoleDefinitionName <String>
   -SignInName <String>
   [-ItemType <WorkspaceItemType>]
   [-Item <String>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzSynapseRoleAssignment
   -WorkspaceName <String>
   -RoleDefinitionName <String>
   -ObjectId <String>
   [-ItemType <WorkspaceItemType>]
   [-Item <String>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzSynapseRoleAssignment
   -WorkspaceName <String>
   -RoleDefinitionId <String>
   -ObjectId <String>
   [-ItemType <WorkspaceItemType>]
   [-Item <String>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzSynapseRoleAssignment
   -WorkspaceName <String>
   -RoleDefinitionName <String>
   -ServicePrincipalName <String>
   [-ItemType <WorkspaceItemType>]
   [-Item <String>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzSynapseRoleAssignment
   -WorkspaceObject <PSSynapseWorkspace>
   -RoleDefinitionName <String>
   -SignInName <String>
   [-ItemType <WorkspaceItemType>]
   [-Item <String>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzSynapseRoleAssignment
   -WorkspaceObject <PSSynapseWorkspace>
   -RoleDefinitionName <String>
   -ObjectId <String>
   [-ItemType <WorkspaceItemType>]
   [-Item <String>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzSynapseRoleAssignment
   -WorkspaceObject <PSSynapseWorkspace>
   -RoleDefinitionId <String>
   -ObjectId <String>
   [-ItemType <WorkspaceItemType>]
   [-Item <String>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzSynapseRoleAssignment
   -WorkspaceObject <PSSynapseWorkspace>
   -RoleDefinitionName <String>
   -ServicePrincipalName <String>
   [-ItemType <WorkspaceItemType>]
   [-Item <String>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Il cmdlet New-AzSynapseRoleAssignment crea un'assegnazione di ruolo di Azure Synapse Analytics.

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

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

Nota

Per creare un'assegnazione di ruolo per un'entità servizio, passare l'ID oggetto dell'entità nel parametro ObjectId. Quando si è un utente con l'autorizzazione per gestire l'assegnazione di ruolo di Controllo degli accessi in base al ruolo di Azure nell'area di lavoro ma non un amministratore di Synapse, creare il ruolo di amministratore di Synapse -RoleDefinitionId e -ObjectId direttamente ma non da -RoleDefinitionName, per l'amministratore di Synapse, RoleDefinitionId è "aaaaa-0000-1111-2222-bbbbbbbbbb", seguire l'esempio 5 come riferimento. Il motivo è , quando si tenta di aggiungere un ruolo "Amministratore di Synapse", il cmdlet deve ottenere l'ID ruolo dal nome del ruolo che richiede l'autorizzazione di lettura dell'area di lavoro, che l'utente corrente non dispone.

Esempio

Esempio 1

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

Questo comando assegna ContosoRole all'utente il cui nome principale è ContosoName.

Esempio 2

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

Questo comando assegna ContosoRole all'utente il cui nome principale è ContosoName e il tipo di elemento è ContosoItemType, l'elemento è ContosoItem.

Esempio 3

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

Questo comando assegna ContosoRole all'utente il cui nome principale è ContosoName e il tipo di elemento è ContosoItemType, l'elemento è ContosoItem.

Esempio 4

$ws = Get-AzSynapseWorkspace -Name ContosoWorkspace
$ws | New-AzSynapseRoleAssignment -RoleDefinitionName ContosoRole -SignInName ContosoName

Questo comando assegna ContosoRole all'utente il cui nome principale è ContosoName tramite la pipeline.

Esempio 5

$ws = Get-AzSynapseWorkspace -Name ContosoWorkspace
$ws | New-AzSynapseRoleAssignment -RoleDefinitionId "00001111-aaaa-2222-bbbb-3333cccc4444" -ObjectId ContosoObjectId

Questo comando assegna il ruolo di amministratore di Synapse all'utente il cui ID oggetto è ContosoObjectId tramite la pipeline.

Parametri

-AsJob

Eseguire il cmdlet in background

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

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

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

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.

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: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:True
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

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
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