Set-AzSqlServerActiveDirectoryAdministrator

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

SQL Server の Microsoft Entra 管理者をプロビジョニングします。

構文

Set-AzSqlServerActiveDirectoryAdministrator
   [-DisplayName] <String>
   [[-ObjectId] <Guid>]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Set-AzSqlServerActiveDirectory管理istrator コマンドレットは、現在のサブスクリプションで 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 doメイン など) は、管理者としてはサポートされていません。 その他のゲスト アカウント (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

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
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

このコマンドレットがプロビジョニングする Microsoft Entra 管理者の表示名を指定します。

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ObjectId

このコマンドレットがプロビジョニングする Microsoft Entra 管理者の一意の ID を指定します。 表示名が一意でない場合は、このパラメーターの値を指定する必要があります。

Type:Guid
Position:3
Default value:None
Required:False
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

-ServerName

このコマンドレットが管理者をプロビジョニングする SQL Server の名前を指定します。

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

String

Guid

出力

AzureSqlServerActiveDirectoryAdministratorModel