Set-AzSqlServerActiveDirectoryAdministrator
佈建 SQL Server 的 Microsoft Entra 系統管理員。
語法
Default (預設值)
Set-AzSqlServerActiveDirectoryAdministrator
[-DisplayName] <String>
[[-ObjectId] <Guid>]
[-ServerName] <String>
[-ResourceGroupName] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Set-AzSqlServerActiveDirectoryAdministrator Cmdlet 會在目前訂用帳戶中布建 AzureSQL Server 的 Microsoft Entra 系統管理員。
您一次只能佈建一個管理員。
下列 Microsoft Entra ID 成員可以布建為 SQL Server 系統管理員：
Microsoft Entra ID 的原生成員
Microsoft Entra ID 的同盟成員
從其他原生或同盟成員匯入的成員
Microsoft 建立為安全群組Microsoft帳戶的 Entra 群組 （例如 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 的伺服器佈建名為 DBAs 的 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 的伺服器佈建名為 DBAs 的 Microsoft Entra 系統管理員群組。
此命令會指定 ObjectId 參數的識別碼。
這可確保命令成功，即使群組的顯示名稱不是唯一的。
參數
-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 系統管理員的唯一識別碼。
如果顯示名稱不是唯一的，您必須指定此參數的值。
參數屬性
類型: 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 。
輸出
