Set-AzSynapseSqlActiveDirectoryAdministrator

Odwołanie

Moduł:: Az.Synapse

Aprowizuje administratora usługi Microsoft Entra dla puli SQL usługi Synapse Analytics.

Składnia

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

Opis

Polecenie cmdlet Set-AzSynapseSqlActiveDirectory Administracja istrator aprowizuje administratora usługi Microsoft Entra dla obszaru roboczego usługi Azure Synapse Analytics w bieżącej subskrypcji. Jednocześnie można aprowizować tylko jednego administratora. Następujące elementy członkowskie identyfikatora Entra firmy Microsoft można aprowizować jako administrator obszaru roboczego usługi Synapse Analytics:

Natywni członkowie identyfikatora Entra firmy Microsoft
Federacyjni członkowie identyfikatora Entra firmy Microsoft
Zaimportowani członkowie z innych usług Azure AD, którzy są członkami natywnymi lub federacyjnymi
Grupy microsoft Entra utworzone jako konta Microsoft grup zabezpieczeń, takie jak te w Outlook.com, Hotmail.com lub domenach Live.com, nie są obsługiwane jako administratorzy. Inne konta gości, takie jak te w domenach Gmail.com lub Yahoo.com, nie są obsługiwane jako administratorzy. Zalecamy aprowizowanie dedykowanej grupy Microsoft Entra jako administrator.

Polecenie cmdlet może wywołać poniższy interfejs API programu Microsoft Graph zgodnie z parametrami wejściowymi:

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

Przykłady

Przykład 1

Set-AzSynapseSqlActiveDirectoryAdministrator -WorkspaceName ContosoWorkspace -DisplayName "DBAs"

To polecenie aprowizuje grupę administratorów entra firmy Microsoft o nazwie DBAs dla obszaru roboczego o nazwie ContosoWorkspace.

Przykład 2

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

To polecenie aprowizuje administratora entra firmy Microsoft według identyfikatora objectId dla obszaru roboczego o nazwie ContosoWorkspace.

Parametry

-AsJob

Uruchamianie polecenia cmdlet w tle

Typ:	SwitchParameter
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:	SwitchParameter
Aliases:	cf
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisplayName

Określa nazwę wyświetlaną użytkownika lub grupy, dla której mają być przyznane uprawnienia. Ta nazwa wyświetlana musi istnieć w usłudze Active Directory skojarzonej z bieżącą subskrypcją.

Typ:	String
Position:	Named
wartość domyślna:	None
Wymagane:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

obiekt wejściowy obszaru roboczego, zwykle przekazywany przez potok.

Typ:	PSSynapseWorkspace
Position:	Named
wartość domyślna:	None
Wymagane:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ObjectId

Określa identyfikator obiektu użytkownika lub grupy w identyfikatorze Entra firmy Microsoft, dla którego chcesz udzielić uprawnień.

Typ:	Guid
Position:	Named
wartość domyślna:	None
Wymagane:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Nazwa grupy zasobów.

Typ:	String
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceId

Identyfikator zasobu obszaru roboczego usługi Synapse.

Typ:	String
Position:	Named
wartość domyślna:	None
Wymagane:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Typ:	SwitchParameter
Aliases:	wi
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WorkspaceName

Nazwa obszaru roboczego usługi Synapse.

Typ:	String
Position:	Named
wartość domyślna:	None
Wymagane:	True
Accept pipeline input:	False
Accept wildcard characters:	False

Dane wejściowe

PSSynapseWorkspace

Dane wyjściowe

PSWorkspaceAadAdminInfo

Udostępnij za pośrednictwem