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

  • [アーティクル]

Graph には Azure Active Directory PowerShell モジュール バージョンを使用して、ユーザー管理、ドメイン管理などの Azure AD 管理タスク、シングル サインオンの構成に使用できます。 ここに示すコマンドレットは、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。

Note

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

一般公開バージョンのモジュールをインストールするには、次のコマンドを実行します。

Install-Module AzureAD

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

Install-module AzureADPreview

プレビュー版と GA 版の両方を同時に同じコンピューターにインストールすることはできないので注意してください。

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

最新の 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 として保存した資格情報を次のコマンドで使い、サービスに接続しています。

Note

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

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

Connect-AzureAD -AzureEnvironment "AzureGermanyCloud"

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

次の手順