次の方法で共有


Set-AzSqlServerActiveDirectoryAdministrator

SQL Server の Microsoft Entra 管理者をプロビジョニングします。

構文

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

説明

Set-AzSqlServerActiveDirectoryAdministrator コマンドレットは、現在のサブスクリプションで AzureSQL Server の Microsoft Entra 管理者をプロビジョニングします。 一度にプロビジョニングできる管理者は 1 人だけです。 Microsoft Entra ID の次のメンバーは、SQL Server 管理者としてプロビジョニングできます。

  • Microsoft Entra ID のネイティブ メンバー
  • Microsoft Entra ID のフェデレーション メンバー
  • ネイティブ メンバーまたはフェデレーション メンバーである他の Azure AD からインポートされたメンバー
  • セキュリティ グループとして作成された 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 という名前のサーバーの 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

このコマンドは、Server01 というサーバーの管理者として Microsoft Entra ユーザーをプロビジョニングします。

例 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

コマンドレットの実行前に確認を求めるメッセージが表示されます。

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション

型:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DisplayName

このコマンドレットがプロビジョニングする Microsoft Entra 管理者の表示名を指定します。

型:String
配置:2
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ObjectId

このコマンドレットがプロビジョニングする Microsoft Entra 管理者の一意の ID を指定します。 表示名が一意でない場合は、このパラメーターの値を指定する必要があります。

型:Guid
配置:3
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ResourceGroupName

サーバーが割り当てられているリソース グループの名前を指定します。

型:String
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ServerName

このコマンドレットが管理者をプロビジョニングする SQL Server の名前を指定します。

型:String
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

String

Guid

出力

AzureSqlServerActiveDirectoryAdministratorModel