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-AzSqlInstanceActiveDirectory管理istrator コマンドレットは、現在のサブスクリプションで 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
コマンドレットの実行前に確認を求めるメッセージが表示されます。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
アクセス許可を付与するユーザーまたはグループの表示名を指定します。 この表示名は、現在のサブスクリプションに関連付けられている Active Directory に存在する必要があります。
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InputObject
使用するマネージド インスタンス オブジェクト。
Type: | AzureSqlManagedInstanceModel |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InstanceName
SQL Managed Instance の名前。
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ObjectId
アクセス許可を付与する Microsoft Entra ID のユーザーまたはグループのオブジェクト ID を指定します。
Type: | Guid |
Position: | 3 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceGroupName
リソース グループの名前。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceId
使用するインスタンスのリソース ID
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
出力
AzureSqlInstanceActiveDirectoryAdministratorModel
関連リンク
Azure PowerShell
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示