Graph 用 Azure Active Directory PowerShell のインストール

  • [アーティクル]

重要

Azure AD Powershell は、 2024 年 3 月 30 日に廃止される予定です。 非推奨プランの詳細については、非推奨の 更新プログラムに関するページを参照してください。 引き続き Microsoft Graph PowerShell に移行することをお勧めします。これは、Azure AD との対話に推奨されるモジュールです。 さらに、Microsoft Graph PowerShell を使用すると、すべての Microsoft Graph API にアクセスでき、PowerShell 7 で使用できます。 頻繁な移行クエリに対する回答については、「 移行に関する FAQ」を参照してください。

ユーザー管理、ドメイン管理などの Azure AD 管理タスクやシングル サインオンの構成には、Graph に Azure Active Directory PowerShell モジュール バージョンを使用できます。 ここに記載されているコマンドレットは、Azure Active Directory PowerShell バージョン 1.0 の一部である MSOnline コマンドレットとは異なります。

Azure AD PowerShell for Graph モジュールには、パブリック プレビュー バージョンと一般提供 (GA) バージョンの 2 つのバージョンがあります。 パブリック プレビュー版は、運用環境での使用にはお勧めできません。

PowerShell ギャラリーからモジュールをダウンロードし、次のコードを使用します。

Azure Active Directory PowerShell for Graph のリリース バージョン履歴

Azure AD モジュールと Azure AD プレビュー モジュールのリリース履歴は、次のとおりです:azure active directory powershell for graph: version release history。

Azure AD モジュールのインストール

前提条件

Azure AD モジュールは、Microsoft .NET Framework と Windows PowerShell の既定のバージョンを使用して、次の Windows オペレーティング システムでサポートされています。

  • Windows 8.1
  • Windows 8
  • Windows 7
  • Windows Server 2012 R2、
  • Windows Server 2012
  • Windows Server 2008 R2。

注意

Azure AD PowerShell モジュールは PowerShell 7 と互換性がありません。 PowerShell 5.1 でのみサポートされています。

モジュールの一般提供バージョンをインストールするには、次を実行します。

Install-Module AzureAD

パブリック プレビュー リリースをインストールするには、次を実行します。

Install-module AzureADPreview

プレビュー バージョンと GA バージョンの両方を同じコンピューターに同時にインストールすることはできません。

Azure AD モジュールは、PowerShell ギャラリーを使用して配布されます。 ギャラリーから項目をインストールするには、最新バージョンの PowerShellGet モジュールが必要です。これは、Windows 10、Windows Management Framework (WMF) 5.0、または MSI ベースのインストーラー (PowerShell 3 および 4 の場合) で使用できます。

最新の PowerShellGet モジュールを使用すると、次のことができます。

ギャラリーで PowerShellGet コマンドを使用する方法については、[はじめに] ページを参照してください。 Update-Help -Module PowerShellGet を実行し、コマンドのローカル ヘルプをインストールすることもできます。

サポートされるオペレーティング システム

PowerShellGet モジュールは PowerShell 3.0 以降を必要とします。

そのため、PowerShellGet は次のいずれかのオペレーティング システムを必要とします。

  • Windows 10
  • Windows 8.1 Pro
  • Windows 8.1 Enterprise
  • Windows 7 SP1
  • Windows Server 2016 TP5
  • Windows Server 2012 R2
  • Windows Server 2008 R2 SP1

PowerShellGet には、.NET Framework 4.5 以降も必要です。 .NET Framework 4.5 以降をここからインストールできます。

Azure AD モジュールの更新

コンピューターにインストールされているモジュールのバージョンをチェックするには、次のコマンドを実行します。

Get-Module AzureADPreview

ModuleType Version Name                ExportedCommands
---------- ------- ----                ----------------
Binary     2.0.0.7 azureadpreview     {Add-AzureADAdmini...

コンピューター上の Azure AD PowerShell モジュールのバージョンを更新するには、 Install-Module コマンドレットを再実行します。

Install-Module AzureADPreview

このコマンドは、PowerShell ギャラリーを調べ、新しいバージョンが使用可能かどうかを確認します。 はいの場合は、コンピューターにインストールされているものよりも新しい。

Azure への接続

この記事で取り上げたコマンドレットを実行する前にまず、ご利用のオンライン サービスに接続する必要があります。 Windows PowerShell コマンド プロンプトから Connect-AzureAD コマンドレットを実行してください。 その後、資格情報の入力を求められます。 資格情報は、必要に応じて事前に指定することもできます。その例を次に示します。

$AzureAdCred = Get-Credential
Connect-AzureAD -Credential $AzureAdCred

1 つ目のコマンドで資格情報の入力を求め、それらを $AzureAdCred として格納しています。 さらに、$azureadcred として保存した資格情報を次のコマンドで使い、サービスに接続しています。

注意

Azure AD および Azure AD プレビュー モジュールは、 と -AzureADMSなど、異なる名前付け規則を-AzureAD持つコマンドレットで構成されます。 コマンドレットは -AzureAD Azure AD Graph エンドポイント https://graph.windows.net に接続し、 -AzureADMS コマンドレットは Microsoft Graph エンドポイント を呼び出します graph.microsoft.com。 認証は、あるエンドポイントから別のエンドポイントに呼び出しを変更しても、資格情報の入力を再度求められると、サイレント処理されます。

Azure Active Directory の特定の環境に接続するには、次のように AzureEnvironment パラメーターを使用します。

Connect-AzureAD -AzureEnvironment "AzureGermanyCloud"

この例では、PowerShell セッションを German AzureAD 環境に接続しています。 詳しくは、Connect-AzureAD に関するページをご覧ください。

次の手順