Graph 用 Azure Active Directory PowerShell

  • [アーティクル]

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

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

Azure AD PowerShell for Graph プレビュー モジュールは、AzureADPreview ページのPowerShell ギャラリーからダウンロードできます。

Azure AD PowerShell for Graph 一般提供モジュールは、AzureAD ページのPowerShell ギャラリーからダウンロードできます。

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

Azure AD PowerShell for Graph モジュールは、Microsoft .NET Framework とWindows PowerShellの既定のバージョンを持つ次の Windows オペレーティング システムでサポートされています:Windows 8.1、Windows 8、Windows 7、Windows Server 2012 R2、Windows Server 2012、または Windows Server 2008 R2。

ご利用のコンピューターがインストールの前提条件をすべて満たしている場合、一般公開版のモジュールをコンピューターにインストールするには、次のコマンドを実行します。

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 モジュールの更新

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

PS C:\WINDOWS\system32> Get-Module AzureADPreview

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

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

PS C:\WINDOWS\system32> Install-Module AzureADPreview

このコマンドは、現在よりも新しいバージョンが入手可能かどうかを PowerShell ギャラリーで調べ、ご利用のコンピューターにインストールされているバージョンよりも新しければ、PowerShell ギャラリーで見つかったバージョンをコンピューターにインストールします。

Azure への接続

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

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

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

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

Connect-AzureAD -AzureEnvironment "AzureGermanyCloud"

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

Power BI チームへのご提案は、

Azure Active Directory PowerShell を改善する方法に関する提案がある場合は、お気軽にお 知らせください。

Windows PowerShell についてのさらに詳しい情報

Windows PowerShell はタスクベースのコマンド ライン シェルであり、システム管理を意図して設計されたスクリプト言語でもあります。 テキストを受け取ってテキストを返すほとんどのシェルとは異なり、Windows PowerShell は .NET Framework を基盤として構築され、受け取るデータも返すデータも .NET Framework のオブジェクトです。

Windows PowerShell は、シンプルな単一機能のコマンド ライン ツールをシェルに組み込んだ、コマンドレットという概念を導入しました。 コマンドレットには、 Get-Help、 Get-Process、 Start-Service など、ダッシュ (-) で区切られた動詞と名詞という名前付け規則があります。 Windows PowerShell には、100 を上回る数の核となる基本コマンドレットが用意されています。

コマンドレットについての詳しい情報や構文は、Get-Help <cmdlet name> コマンドを使って調査できます。<cmdlet name> には、調べるコマンドレットの名前を指定します。 詳しくは、次のいずれかのコマンドを実行してください。

  • Get-Help <cmdlet name> -Detailed
  • Get-Help <cmdlet name> -Examples
  • Get-Help <cmdlet name> -Full

Windows PowerShell について詳しくは、「Windows PowerShell ファースト ステップ ガイド」をご覧ください。