Set-AzSynapseSqlActiveDirectoryAdministrator
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-AzSynapseSqlActiveDirectoryAdministrator 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 |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
| Typ: | SwitchParameter |
| Aliasy: | cf |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-DefaultProfile
Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.
| Typ: | IAzureContextContainer |
| Aliasy: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-InputObject
obiekt wejściowy obszaru roboczego, zwykle przekazywany przez potok.
| Typ: | PSSynapseWorkspace |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | 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 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-ResourceGroupName
Nazwa grupy zasobów.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-ResourceId
Identyfikator zasobu obszaru roboczego usługi Synapse.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.
| Typ: | SwitchParameter |
| Aliasy: | wi |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-WorkspaceName
Nazwa obszaru roboczego usługi Synapse.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
