次の方法で共有

Set-AzSqlInstanceActiveDirectoryAdministrator

  • リファレンス
モジュール:
Az.Sql

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

入力

String

Guid

出力

AzureSqlInstanceActiveDirectoryAdministratorModel