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 |
入力
出力
AzureSqlServerActiveDirectoryAdministratorModel