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

この記事は、Microsoft 365 Enterprise および Office 365 Enterprise の両方に適用されます。This article applies to both Microsoft 365 Enterprise and Office 365 Enterprise.

Microsoft 365 用 PowerShell では、コマンド ラインから Microsoft 365 の設定を管理することが可能です。PowerShell for Microsoft 365 enables you to manage your Microsoft 365 settings from the command line. PowerShell への接続は、必要なソフトウェアをインストールして、Microsoft 365 の組織に接続するだけです。To connect to PowerShell, just install the required software and then connect to your Microsoft 365 organization.

Microsoft 365 および管理者のユーザー アカウント、グループ、ライセンスへの接続に使用可能な PowerShell モジュールには、次の 2 つのバージョンがあります。There are two versions of the PowerShell module that you can use to connect to Microsoft 365 and administer user accounts, groups, and licenses:

  • コマンドレット名に AzureAD が含まれる Graph 用 Azure Active Directory PowerShellAzure Active Directory PowerShell for Graph, whose cmdlets include AzureAD in their name
  • コマンドレット名に Msol が含まれる Windows PowerShell 用 Microsoft Azure Active Directory モジュールMicrosoft Azure Active Directory Module for Windows PowerShell, whose cmdlets include Msol in their name

現時点で、Graph 用 Azure Active Directory PowerShell モジュールは、ユーザー、グループ、およびライセンスの管理について Windows PowerShell 用 Microsoft Azure Active Directory モジュールの機能に完全に置き換わるものではありません。Currently, the Azure Active Directory PowerShell for Graph module doesn't completely replace the functionality of the Microsoft Azure Active Directory Module for Windows PowerShell module for user, group, and license administration. 場合によっては、両方のバージョンを使用する必要があります。In some cases, you need to use both versions. 両バージョンを同じコンピューターに安全にインストールすることができます。You can safely install both versions on the same computer.

はじめに把握しておくべき情報What do you need to know before you begin?

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

64 ビット版の Windows を使用する必要があります。You must use a 64-bit version of Windows. Microsoft PowerShell 用 Microsoft Azure Active Directory モジュール の 32 ビット 版のサポートは、2014 年で終了しました。Support for the 32-bit version of the Microsoft Azure Active Directory Module for Windows PowerShell ended in 2014.

次の Windows のバージョンを使用できます。You can use the following versions of Windows:

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

  • Windows Server 2019、Windows Server 2016、Windows Server 2012 R2、Windows Server 2012、または Windows Server 2008 R2 SP1Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, or 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 をダウンロードしてインストールします。For Windows 8.1, Windows 8, Windows 7 Service Pack 1 (SP1), Windows Server 2012 R2, Windows Server 2012, and Windows Server 2008 R2 SP1, download and install the Windows Management Framework 5.1.

PowerShellPowerShell

  • Graph 用 Azure Active Directory PowerShell モジュールでは、PowerShell バージョン 5.1 以降を使用する必要があります。For the Azure Active Directory PowerShell for Graph module, you must use PowerShell version 5.1 or later.

  • Windows PowerShell 用 Microsoft Azure Active Directory モジュールでは、PowerShell バージョン 5.1 から PowerShell バージョン 6 までを使用する必要があります。For the Microsoft Azure Active Directory Module for Windows PowerShell module, you must use PowerShell version 5.1 or later, up to PowerShell version 6. PowerShell バージョン 7 は使用できません。You can't use PowerShell version 7.

注意

これらの手順は、Microsoft 365 の管理者の役割を持つユーザーを対象としています。These procedures are intended for users who are members of a Microsoft 365 admin role. 詳細については、「管理者の役割について」 を参照してください。For more information, see About admin roles.

Graph 用 Azure Active Directory PowerShell モジュールに接続するConnect with the Azure Active Directory PowerShell for Graph module

Graph 用 Azure Active Directory PowerShell モジュールのコマンドには、コマンドレット名に AzureAD が含まれます。Commands in the Azure Active Directory PowerShell for Graph module have AzureAD in their cmdlet name. Graph 用 Azure Active Directory PowerShell モジュールか Azure PowerShell をインストールできます。You can install the Azure Active Directory PowerShell for Graph module or Azure PowerShell.

Graph 用 Azure Active Directory PowerShell モジュールにおいて新しいコマンドレットを必要とするプロシージャについては、以下の手順に従い、モジュールをインストールし、Microsoft 365 サブスクリプションに接続します。For procedures that require the new cmdlets in the Azure Active Directory PowerShell for Graph module, follow these steps to install the module and connect to your Microsoft 365 subscription.

注意

Windows のさまざまなバージョンに対するサポート情報については、「Graph 用 Azure Active Directory PowerShell モジュール」を参照してください。For information about support for different versions of Windows, see Azure Active Directory PowerShell for Graph module .

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

これらの手順は、お使いのコンピューターで一度だけ行う必要があります。These steps are required only one time on your computer. ただし、定期的にソフトウェアを更新する必要があります。But you'll likely need to update the software periodically.

  1. 管理者特権で Windows PowerShell コマンド プロンプト ウィンドウを開きます (Windows PowerShell を管理者として実行)。Open an elevated Windows PowerShell Command Prompt window (run Windows PowerShell as an administrator).

  2. 次のコマンドを実行します。Run this command:

    Install-Module -Name AzureAD
    

    信頼されていないリポジトリからモジュールをインストールするようにメッセージが表示されたら、「 Y 」と入力し、Enter キーを押します。If you're prompted to install a module from an untrusted repository, type Y and press Enter.

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

アカウント名とパスワードまたは多要素認証を使用して Microsoft 365 サブスクリプション用の Azure Active Directory (Azure AD) に接続するには、Windows PowerShell コマンド プロンプトから次のいずれかのコマンドを実行します。To connect to Azure Active Directory (Azure AD) for your Microsoft 365 subscription with an account name and password or with multi-factor authentication, run one of these commands from a Windows PowerShell command prompt. (昇格する必要はありません。)(It doesn't have to be elevated.)

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

[ アカウントにサインイン ] ダイアログ ボックスで、Microsoft 365 の職場または学校のアカウントのユーザー名とパスワードを入力し、[ OK ] を選択します。In the Sign into your account dialog box, type your Microsoft 365 work or school account user name and password, and then select OK.

多要素認証を使用している場合は、手順に従って確認コードなどの追加認証情報を入力します。If you're using multi-factor authentication, follow the instructions to provide additional authentication information, such as a verification code.

接続後は、Graph 用 Azure Active Directory PowerShell モジュールのコマンドレットを使用できます。After you connect, you can use the cmdlets for the Azure Active Directory PowerShell for Graph module.

Windows PowerShell 用 Microsoft Azure Active Directory モジュールとの接続Connect with the Microsoft Azure Active Directory Module for Windows PowerShell

注意

Windows PowerShell 用 Microsoft Azure Active Directory モジュールには、コマンドレット名に Msol が含まれています。Cmdlets in the Microsoft Azure Active Directory Module for Windows PowerShell have Msol in their name.

PowerShell バージョン 7 以降は、Windows PowerShell 用 Microsoft Azure Active Directory モジュールと、名前に Msol が含まれるコマンドレットをサポートしていません。PowerShell version 7 and later don't support the Microsoft Azure Active Directory Module for Windows PowerShell module and cmdlets with Msol in their name. PowerShell バージョン 7 以降では、Graph 用 Azure Active Directory PowerShell モジュールか Azure PowerShell を使用する必要があります。For PowerShell version 7 and later, you must use the Azure Active Directory PowerShell for Graph module or Azure PowerShell.

PowerShell Core は、Windows PowerShell 用 Microsoft Azure Active Directory モジュールと、名前に Msol が含まれるコマンドレットをサポートしていません。PowerShell Core doesn't support the Microsoft Azure Active Directory Module for Windows PowerShell module and cmdlets with Msol in their name. これらのコマンドレットは、Windows PowerShell から実行します。Run these cmdlets from Windows PowerShell.

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

これらの手順は、お使いのコンピューターで一度だけ行う必要があります。These steps are required only one time on your computer. ただし、定期的にソフトウェアを更新する必要があります。But you'll likely need to update the software periodically.

  1. Windows 10を実行中でない場合は、Microsoft Online Services サインイン アシスタントの 64 ビット版をインストールします: IT プロフェッショナル用 Microsoft Online Services サインイン アシスタント RTWIf you're not running Windows 10, install the 64-bit version of the Microsoft Online Services Sign-in Assistant: Microsoft Online Services Sign-in Assistant for IT Professionals RTW.

  2. 以下の手順に従って、Windows PowerShell の Microsoft Azure Active Directory モジュールをインストールします。Follow these steps to install the Microsoft Azure Active Directory Module for Windows PowerShell:

    1. 管理者特権で Windows PowerShell コマンド プロンプトを開きます (Windows PowerShell を管理者として実行)。Open an elevated Windows PowerShell command prompt (run Windows PowerShell as an administrator).
    2. Install-Module MSOnline コマンドを実行します。Run the Install-Module MSOnline command.
    3. NuGet プロバイダーをインストールするようにメッセージが表示されたら、「 Y 」と入力し、Enter キーを押します。If you're prompted to install the NuGet provider, type Y and press Enter.
    4. PSGallery からモジュールをインストールするようにメッセージが表示されたら、「 Y 」と入力し、Enter キーを押します。If you're prompted to install the module from PSGallery, type Y and press Enter.

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

アカウント名とパスワードまたは多要素認証を使用して Microsoft 365 サブスクリプション用の Azure AD に接続するには、Windows PowerShell コマンド プロンプトから次のいずれかのコマンドを実行します。To connect to Azure AD for your Microsoft 365 subscription with an account name and password or with multi-factor authentication, run one of these commands from a Windows PowerShell command prompt. (昇格する必要はありません。)(It doesn't have to be elevated.)

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

[ アカウントにサインイン ] ダイアログ ボックスで、Microsoft 365 の職場または学校のアカウントのユーザー名とパスワードを入力し、[ OK ] を選択します。In the Sign into your account dialog box, type your Microsoft 365 work or school account user name and password, and then select OK.

多要素認証を使用している場合は、手順に従って確認コードなどの追加認証情報を入力します。If you're using multi-factor authentication, follow the instructions to provide additional authentication information, such as a verification code.

正常な動作を確認する方法How do you know it worked?

エラー メッセージが表示されなければ、正常に接続されています。If you don't get an error message, you connected successfully. 簡単に確かめるには、 Get-MsolUser などの Microsoft 365 コマンドレットを実行して結果を確認します。For quick test, run a Microsoft 365 cmdlet, such as Get-MsolUser , and see the results.

エラー メッセージが表示される場合は、次の点を確認します。If you get an error message, check the following issues:

  • よくある原因は、正しくないパスワードですA common problem is an incorrect password. 手順 2 をもう一度実行し、その際入力するユーザー名とパスワードには特に注意します。Run Step 2 again, and pay close attention to the user name and password that you enter.

  • Windows PowerShell 用 Microsoft Azure Active Directory モジュールには、Microsoft .NET Framework 3.5 が必要です。お使いのコンピューターで x が有効になっています**。コンピューターにより新しいバージョンがインストールされている可能性があります (4 または 4.5.* x* など)。The Microsoft Azure Active Directory Module for Windows PowerShell requires that Microsoft .NET Framework 3.5. x is enabled on your computer**. It's likely that your computer has a newer version installed (for example, 4 or 4.5.* x*). ただし、以前の .NET Framework のバージョンとの下位互換性を有効または無効にすることができます。But backward compatibility with older versions of the .NET Framework can be enabled or disabled. 詳細については、次の記事を参照してください。For more information, see the following articles:

  • お使いの Windows PowerShell 用 Microsoft Azure Active Directory モジュールのバージョンは期限切れの可能性があります。Your version of the Microsoft Azure Active Directory Module for Windows PowerShell might be out of date. Microsoft 365用または PowerShell または Windows PowerShell 用 Microsoft Azure Active Directory モジュールで、次のコマンドを実行して確認します。To check, run the following command in PowerShell for Microsoft 365 or the Microsoft Azure Active Directory Module for Windows PowerShell:

    (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 からインストールします。If the version number returned is lower than 1.0.8070.2 , uninstall the Microsoft Azure Active Directory Module for Windows PowerShell and install from Step 1, above.

  • 接続エラーが発生した場合 は、 "Connect-MsolService: 例外がスローされました" というエラーに関するトピックをご覧ください。If you get a connection error message , see "Connect-MsolService: Exception of type was thrown" error.

  • 「Get-Item: パスが見つかりません」エラーが表示された場合 は、次のコマンドを使用します。If you get a "Get-Item: Cannot find path" error message , run this command:

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

関連項目See also