Set-AzSqlInstanceActiveDirectoryAdministrator
SQL Managed Instance の 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>] 説明
Set-AzSqlInstanceActiveDirectoryAdministrator コマンドレットは、現在のサブスクリプションで AzureSQL Managed Instance の Microsoft Entra 管理者をプロビジョニングします。 一度にプロビジョニングできる管理者は 1 人だけです。 Microsoft Entra ID の次のメンバーは、SQL Managed Instance 管理者としてプロビジョニングできます。
- Microsoft Entra ID のネイティブ メンバー
- Microsoft Entra ID のフェデレーション メンバー
- セキュリティ グループとして作成された Microsoft Entra グループは、他の Azure AD からインポートされたメンバーは管理者としてサポートされていません。 Outlook.com、Hotmail.com、Live.com ドメインの Microsoft アカウントは、管理者としてサポートされていません。 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
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。
| 型: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisplayName
アクセス許可を付与するユーザーまたはグループの表示名を指定します。 この表示名は、現在のサブスクリプションに関連付けられている Active Directory に存在する必要があります。
| 型: | String |
| 配置: | 2 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-InputObject
使用するマネージド インスタンス オブジェクト。
| 型: | AzureSqlManagedInstanceModel |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-InstanceName
SQL Managed Instance の名前。
| 型: | String |
| 配置: | 1 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ObjectId
アクセス許可を付与する Microsoft Entra ID のユーザーまたはグループのオブジェクト ID を指定します。
| 型: | Guid |
| 配置: | 3 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ResourceGroupName
リソース グループの名前。
| 型: | String |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ResourceId
使用するインスタンスのリソース ID
| 型: | String |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
出力
AzureSqlInstanceActiveDirectoryAdministratorModel