Connect to Microsoft 365 with PowerShell
On 10月 22, 2021 by admin- 07/17/2020
- 6 minutes to read
-
- J
- D
- m
- d
- Azure Active Directory PowerShell for Graph, whose cmdlets includes AzureAD in their name
- Microsoft Azure Active Directory Module for Windows PowerShell, whose cmdlets includes Msol in their name
-
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
-
Azure Active Directory PowerShell for Graph モジュールでは PowerShell バージョン 5.1以降。
-
Microsoft Azure Active Directory Module for Windows PowerShellモジュールは、PowerShellバージョン5.1以降、PowerShellバージョン6まで使用する必要があります。 PowerShell バージョン 7 は使用できません。
この記事はMicrosoft 365 Enterprise と Office 365 Enterprise に適用されます。
PowerShell for Microsoft 365を使用すると、Microsoft 365の設定をコマンドラインから管理することができます。 PowerShellに接続するには、必要なソフトウェアをインストールし、Microsoft 365の組織に接続するだけです。
Microsoft365に接続し、ユーザーアカウント、グループ、ライセンスを管理するために使用できるPowerShellモジュールには、2つのバージョンがあります。
現在、Azure Active Directory PowerShell for Graphモジュールは、ユーザー・グループおよびライセンスの管理についてMicrosoft Azure Active Directory Module for Windows PowerShellモジュールの機能を完全に代替することはできていません。 場合によっては、両方のバージョンを使用する必要があります。 両方のバージョンを同じコンピューターに安全にインストールできます。
オペレーティング システム
Windowsの64ビット バージョンを使用する必要があります。 32ビット版のMicrosoft Azure Active Directory Module for Windows PowerShellのサポートは2014年に終了しました。
以下のバージョンのWindowsを使用できます。
注
Windows8では、Windows 8.1、Windows 8.2、Windows 8.3、Windows 7 Service Pack 1(SP1)
、Windows 8.4、Windows 7 Service Pack 1(SP2)が使用できます。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
注意
これらの手順は、Microsoft 365 管理者ロールのメンバーであるユーザーを対象としています。 詳しくは、管理者ロールについてを参照してください。
Azure Active Directory PowerShell for Graph モジュールとの接続
Azure Active Directory PowerShell for Graph モジュールのコマンドは、コマンドレット名に AzureAD が含まれています。 Azure Active Directory PowerShell for GraphモジュールまたはAzure PowerShellをインストールできます。
Azure Active Directory PowerShell for Graphモジュールの新しいコマンドレットを必要とする手順では、次の手順に従ってモジュールをインストールし、Microsoft 365サブスクリプションに接続します。
注意
異なるバージョンのWindowsのサポートについては、Azure Active Directory PowerShell for Graph module .
Step 1: 必須ソフトウェアのインストール
この手順はコンピューターに1回だけ必要なものです。
-
昇格したWindows PowerShellコマンドプロンプトウィンドウを開きます(Windows PowerShellを管理者として実行)。
-
このコマンドを実行します。
Step 2: Microsoft 365 サブスクリプションの Azure AD に接続する
アカウント名とパスワードを使用して、または多要素認証で Microsoft 365 サブスクリプションの Azure Active Directory (Azure AD) に接続するには、Windows PowerShell コマンド プロンプトからこれらのコマンドのいずれかを実行します。 (昇格している必要はありません。)
Office 365 cloud | Command |
---|---|
Office 365 Worldwide (+GCC) | Connect-AzureAD |
Office 365 21 Vianet | Connect-AzureAD -AzureEnvironmentName AzureChinaCloud |
Office 365 Germany | Connect-AzureAD -AzureEnvironmentName AzureGermanyCloud |
オフィス 365 U.米国政府DoDおよびOffice 365 米国政府GCC High | Connect-AzureAD -AzureEnvironmentName AzureUSGovernment |
アカウントにサインイン ダイアログ ボックスで、Microsoft 365 仕事または学校アカウントのユーザー名とパスワードを入力して、OK を選択します。
多要素認証を使用している場合は、指示に従って認証コードなどの追加の認証情報を入力します。
接続後、Azure Active Directory PowerShell for Graphモジュールのコマンドレットを使用することができます。
Microsoft Azure Active Directory Module for Windows PowerShellとの接続
注意
Microsoft Azure Active Directory Module for Windows PowerShellのコマンドレットは名前にMsolを持ちます。
PowerShellバージョン7以降ではMicrosoft Azure Active Directory Module for Windows PowerShellモジュールと名前にMsolがあるコマンドレットはサポートされていません。 PowerShellバージョン7以降では、Azure Active Directory PowerShell for GraphモジュールまたはAzure PowerShellを使用する必要があります。
PowerShell CoreはMicrosoft Azure Active Directory Module for Windows PowerShellモジュールとその名前にMsolが含まれるコマンドレットをサポートしていません。 Windows PowerShellからこれらのコマンドレットを実行します。
ステップ1:必要なソフトウェアをインストールする
これらのステップは、コンピューターに1回だけ必要です。 しかし、定期的にソフトウェアを更新する必要がある可能性があります。
-
Windows 10を実行していない場合、64ビット版のMicrosoft Online Services Sign-in Assistant: Microsoft Online Services Sign-in Assistant for IT Professionals RTWをインストールします。
-
以下の手順に従って、Windows PowerShell用のMicrosoft Azure Active Directory Moduleをインストールします:
- 昇格したWindows PowerShellコマンドプロンプトを開きます(管理者としてWindows PowerShellを実行します)。
- Install-Module MSOnline コマンドを実行します。
- NuGetプロバイダーをインストールするよう求められたら、Yと入力してEnterキーを押します。
- PSGalleryからモジュールをインストールするよう求められたら、Yと入力しEnterキーを押します。
Step 2: Microsoft 365 サブスクリプションの Azure AD に接続する
アカウント名とパスワードで、または多要素認証で Microsoft 365 サブスクリプションの Azure AD に接続するには、Windows PowerShell コマンド プロンプトからこれらのコマンドのいずれかを実行してください。 (昇格されている必要はありません。)。)
Office 365 cloud | Command |
---|---|
Office 365 Worldwide (+GCC) | Connect-MsolService |
Office 365 operated by 21 Vianet | Connect-MsolService -AzureEnvironment AzureChinaCloud |
Office 365 Germany | Connect-MsolService -AzureEnvironment AzureGermanyCloud |
オフィス 365 U.米国政府DoDとOffice 365 U.S. Government GCC High | Connect-MsolService -AzureEnvironment USGovernment |
Sign into your account dialog boxで、Microsoft 365 work or school account user nameとpasswordを入力し、OKを選択してください。
多要素認証を使用している場合は、指示に従って認証コードなどの追加の認証情報を入力します。
正常に接続されたことを確認するには?
エラーメッセージが表示されない場合は、正常に接続されています。 簡単なテストとして、Get-MSolUser などの Microsoft 365 コマンドレットを実行し、結果を確認します。
エラー メッセージが表示された場合、次の問題を確認します。 手順2をもう一度実行し、入力したユーザー名とパスワードによく注意してください。
WindowsPowerShell用のMicrosoft Azure Active Directory Moduleは、Microsoft .NET Framework 3.5.xがコンピューター上で有効であることが必要です。 お使いのコンピューターには、より新しいバージョン (たとえば、4 または 4.5.x) がインストールされている可能性があります。 しかし、.NET Frameworkの古いバージョンとの後方互換性は、有効または無効にすることができます。 詳細は、以下の記事を参照してください。
- Windows Server 2012 または Windows Server 2012 R2 の場合は、役割と機能の追加ウィザードを使用して .NET Framework 3.5 を有効にします。
Windows 7 または Windows Server 2008 R2 の場合は、Windows PowerShell 用 Azure Active Directory Module を開けないをご覧ください。
Windows 10、Windows 8.1、および Windows 8 の場合は、Windows 10、Windows 8.1、および Windows 8 で .NET Framework 3.5 をインストールするを参照してください。
お使いの Windows PowerShell の Microsoft Azure Active Directory Module のバージョンが古い可能性があります。 確認するには、PowerShell for Microsoft 365または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 より低い場合、Microsoft Azure Active Directory Module for Windows PowerShellをアンインストールして、上記の手順 1 からインストールしてください。
接続エラーのメッセージが表示されたら、「Connect-MSolService.NET」を参照してください。 Exception of type was thrown” エラー。
If you get-Item: Cannot find path” エラーメッセージが表示されたら、このコマンドを実行します。
(dir "C:\Program Files\WindowsPowerShell\Modules\MSOnline").Name
See also
- Manage Microsoft 365 with PowerShell
- Get started with PowerShell for Microsoft 365
- 単一の Windows PowerShell ウィンドウですべての Microsoft 365 サービスへ接続する
コメントを残す