Set-AzSynapseSqlActiveDirectoryAdministrator

Referentie

Module:: Az.Synapse

Richt een Microsoft Entra-beheerder in voor synapse Analytics SQL-pool.

Syntaxis

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

Met de cmdlet Set-AzSynapseSqlActiveDirectoryAdministrator wordt een Microsoft Entra-beheerder ingericht voor Azure Synapse Analytics Workspace in het huidige abonnement. U kunt slechts één beheerder tegelijk inrichten. De volgende leden van Microsoft Entra-id kunnen worden ingericht als synapse Analytics-werkruimtebeheerder:

Systeemeigen leden van Microsoft Entra-id
Federatieve leden van Microsoft Entra-id
Geïmporteerde leden van andere Azure-AD's die systeemeigen of federatieve leden zijn
Microsoft Entra-groepen die zijn gemaakt als beveiligingsgroepen microsoft-accounts, zoals die in de Outlook.com, Hotmail.com of Live.com domeinen, worden niet ondersteund als beheerders. Andere gastaccounts, zoals die in de Gmail.com- of Yahoo.com-domeinen, worden niet ondersteund als beheerders. U wordt aangeraden een speciale Microsoft Entra-groep in te richten als beheerder.

De cmdlet kan onderstaande Microsoft Graph API aanroepen op basis van invoerparameters:

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

Voorbeelden

Voorbeeld 1

Set-AzSynapseSqlActiveDirectoryAdministrator -WorkspaceName ContosoWorkspace -DisplayName "DBAs"

Met deze opdracht wordt een Microsoft Entra-beheerdersgroep ingericht met de naam DBA's voor de werkruimte met de naam ContosoWorkspace.

Voorbeeld 2

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

Met deze opdracht wordt een Microsoft Entra-beheerder ingericht op objectId voor de werkruimte met de naam ContosoWorkspace.

Parameters

-AsJob

Cmdlet op de achtergrond uitvoeren

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:	SwitchParameter
Aliassen:	cf
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:	IAzureContextContainer
Aliassen:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DisplayName

Hiermee geeft u de weergavenaam op van de gebruiker of groep voor wie machtigingen moet worden verleend. Deze weergavenaam moet bestaan in de Active Directory die is gekoppeld aan het huidige abonnement.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-InputObject

werkruimte-invoerobject, meestal doorgegeven via de pijplijn.

Type:	PSSynapseWorkspace
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ObjectId

Hiermee geeft u de object-id van de gebruiker of groep in Microsoft Entra-id op waarvoor machtigingen moeten worden verleend.

Type:	Guid
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ResourceGroupName

Naam van de resourcegroep.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ResourceId

Resource-id van Synapse-werkruimte.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:	SwitchParameter
Aliassen:	wi
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-WorkspaceName

Naam van Synapse-werkruimte.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Invoerwaarden

PSSynapseWorkspace

Uitvoerwaarden

PSWorkspaceAadAdminInfo

Delen via