共用方式為

Set-AzSqlInstanceActiveDirectoryAdministrator

  • 參考
模組:
Az.Sql

為 SQL 受控實例布建Microsoft Entra 系統管理員。

語法

Set-AzSqlInstanceActiveDirectoryAdministrator
   [-DisplayName] <String>
   [-ObjectId] <Guid>
   [-ResourceGroupName] <String>
   [-InstanceName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzSqlInstanceActiveDirectoryAdministrator
   [-DisplayName] <String>
   [-ObjectId] <Guid>
   -InputObject <AzureSqlManagedInstanceModel>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzSqlInstanceActiveDirectoryAdministrator
   [-DisplayName] <String>
   [-ObjectId] <Guid>
   [-ResourceId] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Set-AzSqlInstanceActiveDirectoryAdministrator Cmdlet 會在目前訂用帳戶中為 AzureSQL 受控實例布建Microsoft Entra 系統管理員。 您一次只能布建一個系統管理員。 Microsoft Entra 標識符的下列成員可以布建為 SQL 受控實例管理員：

  • Microsoft Entra 標識碼的原生成員
  • Microsoft Entra 識別碼的同盟成員
  • Microsoft建立為安全組的 Entra 群組從其他 Azure AD 匯入成員，不支持系統管理員身分。 系統管理員不支援Microsoft帳戶，例如 Outlook.com、Hotmail.com 或 Live.com 網域中的帳戶。 系統管理員不支援其他來賓帳戶，例如 Gmail.com 或 Yahoo.com 網域中的帳戶。 建議您以系統管理員身分佈建專用Microsoft Entra 群組。

範例

範例 1：為與資源群組相關聯的受控實例布建系統管理員群組

Set-AzSqlInstanceActiveDirectoryAdministrator -ResourceGroupName "ResourceGroup01" -InstanceName "ManagedInstance01" -DisplayName "DBAs" -ObjectId "40b79501-b343-44ed-9ce7-da4c8cc7353b"

ResourceGroupName InstanceName      DisplayName ObjectId 
----------------- ----------------- ----------- -------- 
ResourceGroup01   ManagedInstance01 DBAs        40b79501-b343-44ed-9ce7-da4c8cc7353b

此命令會針對名為ManagedInstance01的受控實例，布建名為 DBA 的 Microsoft Entra 系統管理員群組。 此伺服器與資源群組 ResourceGroup01 相關聯。

範例 2：使用受控實例物件布建系統管理員使用者

Get-AzSqlInstance -ResourceGroupName "ResourceGroup01" -InstanceName "ManagedInstance01" | Set-AzSqlInstanceActiveDirectoryAdministrator -DisplayName "David Chew" -ObjectId "11E95548-B179-4FE1-9AF4-ACA49D13ABB9"

ResourceGroupName InstanceName      DisplayName ObjectId 
----------------- ----------------- ----------- -------- 
Resourcegroup01   ManagedInstance01 David Chew  11E95548-B179-4FE1-9AF4-ACA49D13ABB9

此命令會以受控實例對象的系統管理員身分佈建 Microsoft Entra 使用者。

範例 3：使用受控實例資源標識符布建系統管理員

Get-AzSqlInstance -ResourceId "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/ResourceGroup01/providers/Microsoft.Sql/managedInstances/ManagedInstance01" | Set-AzSqlInstanceActiveDirectoryAdministrator -DisplayName "David Chew" -ObjectId "11E95548-B179-4FE1-9AF4-ACA49D13ABB9"

ResourceGroupName InstanceName      DisplayName ObjectId 
----------------- ----------------- ----------- -------- 
Resourcegroup01   ManagedInstance01 David Chew  11E95548-B179-4FE1-9AF4-ACA49D13ABB9

此命令會使用受控實例資源標識符，以系統管理員身分佈建 Microsoft Entra 使用者。

參數

-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:2
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-InputObject

要使用的受控實例物件。

類型:AzureSqlManagedInstanceModel
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-InstanceName

SQL 受控實例名稱。

類型:String
Position:1
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-ObjectId

指定要授與許可權之Microsoft Entra ID 中使用者或群組的物件標識碼。

類型:Guid
Position:3
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-ResourceGroupName

資源群組的名稱。

類型:String
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-ResourceId

要使用的實例資源標識碼

類型:String
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:SwitchParameter
別名:wi
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

String

Guid

輸出

AzureSqlInstanceActiveDirectoryAdministratorModel