Set-AzSqlServerActiveDirectoryAdministrator
为 SQL Server 预配Microsoft Entra 管理员。
语法
Default （默认值）
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 之前，提示你进行确认。
参数属性
参数集
(All)
Position: Named 必需: False 来自管道的值: False 来自管道的值（按属性名称）: False 来自剩余参数的值: False
-DefaultProfile
用于与 azure 通信的凭据、帐户、租户和订阅
参数属性
参数集
(All)
Position: Named 必需: False 来自管道的值: False 来自管道的值（按属性名称）: False 来自剩余参数的值: False
-DisplayName
指定此 cmdlet 预配的 Microsoft Entra 管理员的显示名称。
参数属性
类型: String
默认值: None 支持通配符: False 不显示: False
参数集
(All)
Position: 2 必需: True 来自管道的值: False 来自管道的值（按属性名称）: True 来自剩余参数的值: False
-ObjectId
指定此 cmdlet 预配的 Microsoft Entra 管理员的唯一 ID。
如果显示名称不唯一，则必须为此参数指定值。
参数属性
类型: Guid
默认值: None 支持通配符: False 不显示: False
参数集
(All)
Position: 3 必需: False 来自管道的值: False 来自管道的值（按属性名称）: True 来自剩余参数的值: False
-ResourceGroupName
指定为其分配服务器的资源组的名称。
参数属性
类型: String
默认值: None 支持通配符: False 不显示: False
参数集
(All)
Position: 0 必需: True 来自管道的值: False 来自管道的值（按属性名称）: True 来自剩余参数的值: False
-ServerName
指定此 cmdlet 为其预配管理员的 SQL Server 的名称。
参数属性
类型: String
默认值: None 支持通配符: False 不显示: False
参数集
(All)
Position: 1 必需: True 来自管道的值: False 来自管道的值（按属性名称）: True 来自剩余参数的值: False
-WhatIf
显示 cmdlet 运行时会发生什么情况。
命令脚本未运行。
参数属性
参数集
(All)
Position: Named 必需: False 来自管道的值: False 来自管道的值（按属性名称）: False 来自剩余参数的值: False
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters 。
输出
