Sdílet prostřednictvím


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

PSSynapseWorkspace

Výstupy

PSWorkspaceAadAdminInfo