你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Set-AzSynapseSqlActiveDirectoryAdministrator

参考

模块:: Az.Synapse

为 Synapse Analytics SQL 池预配Microsoft Entra 管理员。

语法

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

说明

Set-AzSynapseSqlActiveDirectoryAdministrator cmdlet 为当前订阅中的 Azure Synapse Analytics 工作区预配Microsoft Entra 管理员。一次只能预配一个管理员。 Microsoft Entra ID 的以下成员可以作为 Synapse Analytics 工作区管理员进行预配：

Microsoft Entra ID 的本机成员
Microsoft Entra ID 的联合成员
从本机或联合成员的其他 Azure AD 导入的成员
管理员不支持Microsoft作为安全组创建的 entra 组Microsoft帐户（例如 Outlook.com、Hotmail.com 或 Live.com 域中的组）。管理员不支持其他来宾帐户，例如 Gmail.com 或 Yahoo.com 域中的来宾帐户。建议以管理员身份预配专用Microsoft Entra 组。

cmdlet 可以根据输入参数调用以下Microsoft图形 API：

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

示例

示例 1

Set-AzSynapseSqlActiveDirectoryAdministrator -WorkspaceName ContosoWorkspace -DisplayName "DBAs"

此命令为名为 ContosoWorkspace 的工作区预配名为 DBA 的 Microsoft Entra 管理员组。

示例 2

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

此命令通过名为 ContosoWorkspace 的工作区的 objectId 预配 Microsoft Entra 管理员。

参数

-AsJob

在后台运行 cmdlet

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:	IAzureContextContainer
别名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DisplayName

指定要向其授予权限的用户或组的显示名称。此显示名称必须存在于与当前订阅关联的 Active Directory 中。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-InputObject

工作区输入对象，通常通过管道传递。

类型:	PSSynapseWorkspace
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-ObjectId

指定要向其授予权限的Microsoft Entra ID 中用户或组的对象 ID。

类型:	Guid
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ResourceGroupName

资源组名称。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ResourceId

Synapse 工作区的资源标识符。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WorkspaceName

Synapse 工作区的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

输入

PSSynapseWorkspace

输出

PSWorkspaceAadAdminInfo

通过