Set-AzSqlServerActiveDirectoryAdministrator
SQL Server の Microsoft Entra 管理者をプロビジョニングします。
構文
Default (既定)
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
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named 必須: False パイプラインからの値: False プロパティ名別のパイプラインからの値: False 残りの引数からの値: False
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション
パラメーターのプロパティ
型: IAzureContextContainer
規定値: None ワイルドカードのサポート: False DontShow: False Aliases: AzContext, AzureRmContext, AzureCredential
パラメーター セット
(All)
配置: Named 必須: False パイプラインからの値: False プロパティ名別のパイプラインからの値: False 残りの引数からの値: False
-DisplayName
このコマンドレットがプロビジョニングする Microsoft Entra 管理者の表示名を指定します。
パラメーターのプロパティ
型: String
規定値: None ワイルドカードのサポート: False DontShow: False
パラメーター セット
(All)
配置: 2 必須: True パイプラインからの値: False プロパティ名別のパイプラインからの値: True 残りの引数からの値: False
-ObjectId
このコマンドレットがプロビジョニングする Microsoft Entra 管理者の一意の ID を指定します。
表示名が一意でない場合は、このパラメーターの値を指定する必要があります。
パラメーターのプロパティ
型: Guid
規定値: None ワイルドカードのサポート: False DontShow: False
パラメーター セット
(All)
配置: 3 必須: False パイプラインからの値: False プロパティ名別のパイプラインからの値: True 残りの引数からの値: False
-ResourceGroupName
サーバーが割り当てられているリソース グループの名前を指定します。
パラメーターのプロパティ
型: String
規定値: None ワイルドカードのサポート: False DontShow: False
パラメーター セット
(All)
配置: 0 必須: True パイプラインからの値: False プロパティ名別のパイプラインからの値: True 残りの引数からの値: False
-ServerName
このコマンドレットが管理者をプロビジョニングする SQL Server の名前を指定します。
パラメーターのプロパティ
型: String
規定値: None ワイルドカードのサポート: False DontShow: False
パラメーター セット
(All)
配置: 1 必須: True パイプラインからの値: False プロパティ名別のパイプラインからの値: True 残りの引数からの値: False
-WhatIf
コマンドレットを実行した場合の動作を示します。
コマンドレットは実行されません。
パラメーターのプロパティ
型: SwitchParameter
規定値: False ワイルドカードのサポート: False DontShow: False Aliases: ウィスコンシン
パラメーター セット
(All)
配置: Named 必須: False パイプラインからの値: False プロパティ名別のパイプラインからの値: False 残りの引数からの値: False
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParameters を参照してください。
出力
