Set-AzSynapseSqlActiveDirectoryAdministrator

Référence

Module:: Az.Synapse

Provisionne un administrateur Microsoft Entra pour le pool SQL Synapse Analytics.

Syntaxe

Set-AzSynapseSqlActiveDirectoryAdministrator
   [-ResourceGroupName <String>]
   -WorkspaceName <String>
   -DisplayName <String>
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzSynapseSqlActiveDirectoryAdministrator
   [-ResourceGroupName <String>]
   -WorkspaceName <String>
   -ObjectId <Guid>
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzSynapseSqlActiveDirectoryAdministrator
   -InputObject <PSSynapseWorkspace>
   -DisplayName <String>
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzSynapseSqlActiveDirectoryAdministrator
   -InputObject <PSSynapseWorkspace>
   -ObjectId <Guid>
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzSynapseSqlActiveDirectoryAdministrator
   -ResourceId <String>
   -DisplayName <String>
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzSynapseSqlActiveDirectoryAdministrator
   -ResourceId <String>
   -ObjectId <Guid>
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande Set-AzSynapseSqlActiveDirectoryAdministrator provisionne un administrateur Microsoft Entra pour l’espace de travail Azure Synapse Analytics dans l’abonnement actuel. Vous ne pouvez provisionner qu’un seul administrateur à la fois. Les membres suivants de l’ID Microsoft Entra peuvent être provisionnés en tant qu’administrateur d’espace de travail Synapse Analytics :

Membres natifs de Microsoft Entra ID
Membres fédérés de l’ID Microsoft Entra
Membres importés à partir d’autres AD Azure qui sont des membres natifs ou fédérés
Les groupes Microsoft Entra créés en tant que comptes Microsoft de groupes de sécurité, tels que ceux des domaines Outlook.com, Hotmail.com ou Live.com, ne sont pas pris en charge en tant qu’administrateurs. D’autres comptes invités, tels que ceux des domaines Gmail.com ou Yahoo.com, ne sont pas pris en charge en tant qu’administrateurs. Nous vous recommandons de provisionner un groupe Microsoft Entra dédié en tant qu’administrateur.

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}
GET /groups/{id}

Exemples

Exemple 1

Set-AzSynapseSqlActiveDirectoryAdministrator -WorkspaceName ContosoWorkspace -DisplayName "DBAs"

Cette commande provisionne un groupe d’administrateurs Microsoft Entra nommé DBAs pour l’espace de travail nommé ContosoWorkspace.

Exemple 2

Set-AzSynapseSqlActiveDirectoryAdministrator -WorkspaceName ContosoWorkspace -ObjectId "40b79501-b343-44ed-9ce7-da4c8cc7353b"

Cette commande provisionne un administrateur Microsoft Entra par objectId pour l’espace de travail nommé ContosoWorkspace.

Paramètres

-AsJob

Exécuter l’applet de commande en arrière-plan

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:	SwitchParameter
Alias:	cf
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DisplayName

Spécifie le nom complet de l’utilisateur ou du groupe pour lequel accorder des autorisations. Ce nom complet doit exister dans l’annuaire Active Directory associé à l’abonnement actuel.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-InputObject

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

Type:	PSSynapseWorkspace
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-ObjectId

Spécifie l’ID d’objet de l’utilisateur ou du groupe dans Microsoft Entra ID pour lequel accorder des autorisations.

Type:	Guid
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ResourceGroupName

Nom du groupe de ressources.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ResourceId

Identificateur de ressource de l’espace de travail Synapse.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:	SwitchParameter
Alias:	wi
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-WorkspaceName

Nom de l’espace de travail Synapse.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

Entrées

PSSynapseWorkspace

Sorties

PSWorkspaceAadAdminInfo

Partager via