Set-AzSynapseSqlActiveDirectoryAdministrator

Referenz

Modul:: Az.Synapse

Stellt einen Microsoft Entra-Administrator für synapse Analytics SQL-Pool bereit.

Syntax

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

Beschreibung

Der Set-AzSynapseSqlActiveDirectoryAdministrator Cmdlet stellt einen Microsoft Entra-Administrator für Azure Synapse Analytics Workspace im aktuellen Abonnement bereit. Sie können jeweils nur einen Administrator bereitstellen. Die folgenden Mitglieder der Microsoft Entra-ID können als Synapse Analytics Workspace-Administrator bereitgestellt werden:

Native Mitglieder der Microsoft Entra-ID
Partnermitglieder der Microsoft Entra-ID
Importierte Mitglieder aus anderen Azure-ADs, die systemeigene oder Verbundmitglieder sind
Microsoft Entra-Gruppen, die als Sicherheitsgruppen erstellt wurden, werden nicht als Administratoren unterstützt, z. B. in den Outlook.com-, Hotmail.com- oder Live.com-Domänen. Andere Gastkonten, z. B. die in der Gmail.com oder Yahoo.com Domänen, werden nicht als Administratoren unterstützt. Es wird empfohlen, eine dedizierte Microsoft Entra-Gruppe als Administrator bereitzustellen.

Das Cmdlet kann unter der Microsoft Graph-API gemäß eingabeparametern aufgerufen werden:

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

Beispiele

Beispiel 1

Set-AzSynapseSqlActiveDirectoryAdministrator -WorkspaceName ContosoWorkspace -DisplayName "DBAs"

Dieser Befehl stellt eine Microsoft Entra-Administratorgruppe namens DBAs für den Arbeitsbereich namens ContosoWorkspace bereit.

Beispiel 2

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

Mit diesem Befehl wird ein Microsoft Entra-Administrator nach objectId für den Arbeitsbereich "ContosoWorkspace" bereitgestellt.

Parameter

-AsJob

Cmdlet im Hintergrund ausführen

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:	SwitchParameter
Aliase:	cf
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:	IAzureContextContainer
Aliase:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DisplayName

Gibt den Anzeigenamen des Benutzers oder der Gruppe an, für den Berechtigungen erteilt werden sollen. Dieser Anzeigename muss im Active Directory vorhanden sein, das dem aktuellen Abonnement zugeordnet ist.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-InputObject

Arbeitsbereichseingabeobjekt, in der Regel durch die Pipeline übergeben.

Typ:	PSSynapseWorkspace
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-ObjectId

Gibt die Objekt-ID des Benutzers oder der Gruppe in der Microsoft Entra-ID an, für die Berechtigungen erteilt werden sollen.

Typ:	Guid
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ResourceGroupName

Ressourcengruppenname.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ResourceId

Ressourcenbezeichner des Synapse-Arbeitsbereichs.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:	SwitchParameter
Aliase:	wi
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-WorkspaceName

Name des Synapse-Arbeitsbereichs.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

PSSynapseWorkspace

Ausgaben

PSWorkspaceAadAdminInfo

Freigeben über