Set-AzSynapseSqlActiveDirectoryAdministrator
Zřídí správce Microsoft Entra pro fond SQL služby 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
Rutina Set-AzSynapseSqlActiveDirectoryAdministrator zřídí správce Microsoft Entra pro pracovní prostor Azure Synapse Analytics v aktuálním předplatném. Současně můžete zřídit pouze jednoho správce. Jako správce pracovního prostoru Synapse Analytics je možné zřídit následující členy Microsoft Entra ID:
- Nativní členové Microsoft Entra ID
- Federované členy Microsoft Entra ID
- Importované členy z jiných disků Azure AD, kteří jsou nativními nebo federovanými členy
- Skupiny Microsoft Entra vytvořené jako skupiny zabezpečení účty Microsoft, jako jsou například skupiny zabezpečení v Outlook.com, Hotmail.com nebo Live.com domén, nejsou podporovány jako správci. Jiné účty hostů, například účty Gmail.com nebo Yahoo.com domén, nejsou podporované jako správci. Doporučujeme zřídit vyhrazenou skupinu Microsoft Entra jako správce.
Rutina může volat pod rozhraním Microsoft Graph API podle vstupních parametrů:
- GET /users/{id}
- GET /servicePrincipals/{id}
- GET /groups/{id}
Příklady
Příklad 1
Set-AzSynapseSqlActiveDirectoryAdministrator -WorkspaceName ContosoWorkspace -DisplayName "DBAs"
Tento příkaz zřídí skupinu správců Microsoft Entra s názvem DBA pro pracovní prostor s názvem ContosoWorkspace.
Příklad 2
Set-AzSynapseSqlActiveDirectoryAdministrator -WorkspaceName ContosoWorkspace -ObjectId "40b79501-b343-44ed-9ce7-da4c8cc7353b"
Tento příkaz zřídí správce Microsoft Entra podle objectId pro pracovní prostor s názvem ContosoWorkspace.
Parametry
-AsJob
Spuštění rutiny na pozadí
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Confirm
Před spuštěním rutiny vás vyzve k potvrzení.
Typ: | SwitchParameter |
Aliasy: | cf |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.
Typ: | IAzureContextContainer |
Aliasy: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-DisplayName
Určuje zobrazované jméno uživatele nebo skupiny, pro které se mají udělit oprávnění. Tento zobrazovaný název musí existovat ve službě Active Directory přidružené k aktuálnímu předplatnému.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-InputObject
vstupní objekt pracovního prostoru, obvykle předávaný kanálem.
Typ: | PSSynapseWorkspace |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-ObjectId
Určuje ID objektu uživatele nebo skupiny v Microsoft Entra ID, pro který se mají udělit oprávnění.
Typ: | Guid |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-ResourceGroupName
Název skupiny prostředků
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-ResourceId
Identifikátor prostředku pracovního prostoru Synapse
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-WhatIf
Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.
Typ: | SwitchParameter |
Aliasy: | wi |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-WorkspaceName
Název pracovního prostoru Synapse
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
Vstupy
Výstupy
Azure PowerShell