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

Set-AzSqlServerActiveDirectoryAdministrator

参考

模块:: Az.Sql

为 SQL Server 预配Microsoft Entra 管理员。

语法

Set-AzSqlServerActiveDirectoryAdministrator
   [-DisplayName] <String>
   [[-ObjectId] <Guid>]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

Set-AzSqlServerActiveDirectoryAdministrator cmdlet 在当前订阅中为 AzureSQL Server 预配Microsoft Entra 管理员。一次只能预配一个管理员。 Microsoft Entra ID 的以下成员可以预配为 SQL Server 管理员：

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

示例

示例 1：为服务器预配管理员组

Set-AzSqlServerActiveDirectoryAdministrator -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DisplayName "DBAs"

ResourceGroupName ServerName DisplayName ObjectId IsAzureADOnlyAuthentication
----------------- ---------- ----------- -------- ---------------------------
ResourceGroup01   Server01   DBAs        40b79501-b343-44ed-9ce7-da4c8cc7353b False

此命令为名为 Server01 的服务器预配名为 DBA 的 Microsoft Entra 管理员组。此服务器与资源组 ResourceGroup01 相关联。

示例 2：为服务器预配管理员用户

Set-AzSqlServerActiveDirectoryAdministrator -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DisplayName "David Chew"

ResourceGroupName ServerName DisplayName ObjectId IsAzureADOnlyAuthentication
----------------- ---------- ----------- -------- 
resourcegroup01   server01   David Chew  11E95548-B179-4FE1-9AF4-ACA49D13ABB9 False

此命令将 Microsoft Entra 用户预配为名为 Server01 的服务器管理员。

示例 3：通过指定管理员组 ID 来预配管理员组

Set-AzSqlServerActiveDirectoryAdministrator -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DisplayName "DBAs" -ObjectId "40b79501-b343-44ed-9ce7-da4c8cc7353b"

ResourceGroupName ServerName DisplayName ObjectId IsAzureADOnlyAuthentication 
----------------- ---------- ----------- -------- 
ResourceGroup01   Server01   DBAs        40b79501-b343-44ed-9ce7-da4c8cc7353b False

此命令为名为 Server01 的服务器预配名为 DBA 的 Microsoft Entra 管理员组。该命令指定 ObjectId 参数的 ID。这可确保即使组的显示名称不唯一，命令也会成功。

参数

-Confirm

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

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

-DefaultProfile

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

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

-DisplayName

指定此 cmdlet 预配的 Microsoft Entra 管理员的显示名称。

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

-ObjectId

指定此 cmdlet 预配的 Microsoft Entra 管理员的唯一 ID。如果显示名称不唯一，则必须为此参数指定值。

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

-ResourceGroupName

指定为其分配服务器的资源组的名称。

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

-ServerName

指定此 cmdlet 为其预配管理员的 SQL Server 的名称。

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

-WhatIf

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

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

输入

String

Guid

输出

AzureSqlServerActiveDirectoryAdministratorModel

通过