PowerShell を使用して Microsoft 365 に接続する

この記事は、Microsoft 365 Enterprise および Office 365 Enterprise の両方に適用されます。

Microsoft 365 用 PowerShell では、コマンド ラインから Microsoft 365 の設定を管理することが可能です。 PowerShell への接続は、必要なソフトウェアをインストールして、Microsoft 365 の組織に接続するだけです。

Microsoft 365 および管理者のユーザー アカウント、グループ、ライセンスへの接続に使用可能な PowerShell モジュールには、次の 2 つのバージョンがあります。

  • コマンドレット名に AzureAD が含まれる Graph 用 Azure Active Directory PowerShell
  • コマンドレット名に Msol が含まれる Windows PowerShell 用 Microsoft Azure Active Directory モジュール

現時点で、Graph 用 Azure Active Directory PowerShell モジュールは、ユーザー、グループ、およびライセンスの管理について Windows PowerShell 用 Microsoft Azure Active Directory モジュールの機能に完全に置き換わるものではありません。 場合によっては、両方のバージョンを使用する必要があります。 両バージョンを同じコンピューターに安全にインストールすることができます。

注:

また、Microsoft 365 管理センターで Azure Cloud Shell と接続することもできます。

はじめに把握しておくべき情報

注:

Azure Active Directory モジュールは、Microsoft Graph PowerShell SDK に置き換えられています。 Microsoft Graph PowerShell SDK を使用して、すべての Microsoft Graph API にアクセスできます。 詳細については、「Microsoft Graph PowerShell SDK の使用を開始する」 を参照してください。

オペレーティング システム

64 ビット版の Windows を使用する必要があります。 Microsoft PowerShell 用 Microsoft Azure Active Directory モジュール の 32 ビット 版のサポートは、2014 年で終了しました。

次の Windows のバージョンを使用できます。

  • Windows 10、Windows 8.1、Windows 8、または Windows 7 Service Pack 1 (SP1)

  • Windows Server 2019、Windows Server 2016、Windows Server 2012 R2、Windows Server 2012、または Windows Server 2008 R2 SP1

注:

Windows 8.1、Windows 8、Windows 7 Service Pack 1 (SP1)、Windows Server 2012 R2、Windows Server 2012、および Windows Server 2008 R2 SP1 の場合は、Windows Management Framework 5.1 をダウンロードしてインストールします。

PowerShell

  • Graph 用 Azure Active Directory PowerShell モジュールでは、PowerShell バージョン 5.1 を使用する必要があります。

  • Windows PowerShell 用 Microsoft Azure Active Directory モジュールでは、PowerShell バージョン 5.1 から PowerShell バージョン 6 までを使用する必要があります。 PowerShell バージョン 7 は使用できません。

注:

これらの手順は、Microsoft 365 の管理者の役割を持つユーザーを対象としています。 詳細については、「管理者の役割について」 を参照してください。

Graph 用 Azure Active Directory PowerShell モジュールに接続する

Graph 用 Azure Active Directory PowerShell モジュールのコマンドには、コマンドレット名に AzureAD が含まれます。 Graph 用 Azure Active Directory PowerShell モジュールか Azure PowerShell をインストールできます。

Graph 用 Azure Active Directory PowerShell モジュールにおいて新しいコマンドレットを必要とするプロシージャについては、以下の手順に従い、モジュールをインストールし、Microsoft 365 サブスクリプションに接続します。

注:

Windows のさまざまなバージョンに対するサポート情報については、「Graph 用 Azure Active Directory PowerShell モジュール」を参照してください。

手順 1: 必要なソフトウェアをインストールする

これらの手順は、お使いのコンピューターで一度だけ行う必要があります。 ただし、定期的にソフトウェアを更新する必要があります。

  1. Windows PowerShellコマンド プロンプト ウィンドウを開きます。

  2. 次のコマンドを実行します。

    Install-Module -Name AzureAD
    

既定では、PowerShell ギャラリー (PSGallery) は、PowerShellGet 用の信頼されたリポジトリとして構成されません。 初めて PSGallery を使用する場合は、次のメッセージが表示されます。

Untrusted repository

You are installing the modules from an untrusted repository. If you trust this repository, change its InstallationPolicy value by running the `Set-PSRepository` cmdlet.

Are you sure you want to install the modules from 'PSGallery'?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"):

インストールを続行するには [はい] または [すべてにはい] をクリックします。

  1. 次のコマンドを実行して、モジュールをインポートします。

    Import-Module  AzureAD
    

手順 2: Microsoft 365 サブスクリプション用の Azure AD に接続する

アカウント名とパスワードまたは多要素認証を使用して Microsoft 365 サブスクリプション用の Azure Active Directory (Azure AD) に接続するには、Windows PowerShell コマンド プロンプトから次のいずれかのコマンドを実行します。 (昇格する必要はありません。)

Office 365 のクラウド コマンド
Office 365 ワールドワイド (+GCC) Connect-AzureAD
21 Vianet が運営する Office 365 Connect-AzureAD -AzureEnvironmentName AzureChinaCloud
Office 365 Germany Connect-AzureAD -AzureEnvironmentName AzureGermanyCloud
Office 365 U.S. Government DoD と Office 365 U.S. Government GCC High Connect-AzureAD -AzureEnvironmentName AzureUSGovernment

[アカウントにサインイン] ダイアログ ボックスで、Microsoft 365 の職場または学校のアカウントのユーザー名とパスワードを入力し、[OK] を選択します。

多要素認証を使用している場合は、手順に従って確認コードなどの追加認証情報を入力します。

接続後は、Graph 用 Azure Active Directory PowerShell モジュールのコマンドレットを使用できます。

Windows PowerShell 用 Microsoft Azure Active Directory モジュールとの接続

注:

Windows PowerShell 用 Microsoft Azure Active Directory モジュールには、コマンドレット名に Msol が含まれています。

PowerShell バージョン 7 以降は、Windows PowerShell 用 Microsoft Azure Active Directory モジュールと、名前に Msol が含まれるコマンドレットをサポートしていません。 PowerShell バージョン 7 以降の場合は、Microsoft Graph PowerShell SDK を使用する必要があります。

PowerShell Core は、Windows PowerShell 用 Microsoft Azure Active Directory モジュールと、名前に Msol が含まれるコマンドレットをサポートしていません。 これらのコマンドレットは、Windows PowerShell から実行します。

手順 1: 必要なソフトウェアをインストールする

これらの手順は、お使いのコンピューターで一度だけ行う必要があります。 ただし、定期的にソフトウェアを更新する必要があります。

  1. Windows 10 を実行中でない場合は、Microsoft Online Services サインイン アシスタントの 32 ビット版をインストールします: IT プロフェッショナル用 Microsoft Online Services サインイン アシスタント RTW

  2. 以下の手順に従って、Windows PowerShell の Microsoft Azure Active Directory モジュールをインストールします。

    1. 管理者特権で Windows PowerShell コマンド プロンプトを開きます (Windows PowerShell を管理者として実行)。
    2. Install-Module MSOnline コマンドを実行します。
    3. NuGet プロバイダーをインストールするようにメッセージが表示されたら、「Y」と入力し、Enter キーを押します。
    4. PSGallery からモジュールをインストールするようにメッセージが表示されたら、「Y」と入力し、Enter キーを押します。

手順 2: Microsoft 365 サブスクリプション用の Azure AD に接続する

アカウント名とパスワードまたは多要素認証を使用して Microsoft 365 サブスクリプション用の Azure AD に接続するには、Windows PowerShell コマンド プロンプトから次のいずれかのコマンドを実行します。 (昇格する必要はありません。)

Office 365 のクラウド コマンド
Office 365 ワールドワイド (+GCC) Connect-MsolService
21 Vianet が運営する Office 365 Connect-MsolService -AzureEnvironment AzureChinaCloud
Office 365 Germany Connect-MsolService -AzureEnvironment AzureGermanyCloud
Office 365 U.S. Government DoD と Office 365 U.S. Government GCC High Connect-MsolService -AzureEnvironment USGovernment

[アカウントにサインイン] ダイアログ ボックスで、Microsoft 365 の職場または学校のアカウントのユーザー名とパスワードを入力し、[OK] を選択します。

多要素認証を使用している場合は、手順に従って確認コードなどの追加認証情報を入力します。

正常な動作を確認する方法

エラー メッセージが表示されなければ、正常に接続されています。 クイック テストでは、 Get-MsolUser などの Microsoft 365 コマンドレットを実行し、結果を確認します。

エラー メッセージが表示される場合は、次の点を確認します。

  • よくある原因は、正しくないパスワードです手順 2 をもう一度実行し、その際入力するユーザー名とパスワードには特に注意します。

  • Windows PowerShell用のMicrosoft Azure Active Directory モジュールでは、Microsoft .NET Framework 3.5 が必要です。x はコンピューターで有効になっています。 コンピューターに新しいバージョン (4 や 4.5 など) がインストールされている可能性があります。x). ただし、以前の .NET Framework のバージョンとの下位互換性を有効または無効にすることができます。 詳細については、次の記事を参照してください。

  • お使いの Windows PowerShell 用 Microsoft Azure Active Directory モジュールのバージョンは期限切れの可能性があります。 Microsoft 365用または PowerShell または Windows PowerShell 用 Microsoft Azure Active Directory モジュールで、次のコマンドを実行して確認します。

    (Get-Item C:\Windows\System32\WindowsPowerShell\v1.0\Modules\MSOnline\Microsoft.Online.Administration.Automation.PSModule.dll).VersionInfo.FileVersion
    

    返されたバージョン番号が 1.0.8070.2 より小さい場合は、Windows PowerShell 用 Microsoft Azure Active Directory モジュールをアンインストールして、上の手順 1 からインストールします。

  • 接続エラーが発生した場合は、"Connect-MsolService: 例外がスローされました" というエラーに関するトピックをご覧ください。

  • 「Get-Item: パスが見つかりません」エラーが表示された場合は、次のコマンドを使用します。

       (dir "C:\Program Files\WindowsPowerShell\Modules\MSOnline").Name
    

Azure Cloud Shell との接続

Microsoft 365 管理センターで Azure Cloud Shell に接続して使用するには、タスク バーの右上にある PowerShell ウィンドウ アイコンを選択します。 [Azure Cloud Shell へようこそ] ウィンドウで、PowerShell を選択します。

Microsoft 365 サブスクリプションに関連付けられた、組織のアクティブな Azure サブスクリプションが必要です。 まだお持ちでない場合は、作成できます。 Azure サブスクリプションを取得すると、PowerShell ウィンドウが開き、PowerShell のコマンドやスクリプトを実行することができます。

詳細については、「Azure Cloud Shell」を参照してください。

関連項目