PowerShellでMicrosoft 365を管理しよう！PowerShell環境構築手順

Microsoft 365 のユーザー追加、ライセンスの割り当て、グループ管理などは、管理センターの GUI でも操作できます。ただ、同じ作業の繰り返しや大量の処理になると、PowerShell で自動化したくなります。この記事では、Microsoft 365 を PowerShell で管理するための環境として、Microsoft Graph PowerShell SDK をインストールし、テナントに接続して動作を確認するまでの手順をまとめます。

Microsoft Graph PowerShell SDKとは？

以前は、Microsoft 365（Microsoft Entra ID）を PowerShell で管理するのに「Azure AD PowerShell」や「MSOnline」のモジュールが使われていました。これらのモジュールは非推奨になっていて、現在は「Microsoft Graph PowerShell SDK」を使います。

Microsoft Graph PowerShell SDK は、Microsoft Graph API を呼び出すためのモジュール群です。Microsoft Graph API は、Entra ID のユーザーやグループだけでなく、Exchange、SharePoint、Teams などの Microsoft 365 サービスの API を 1 つのエンドポイント（窓口）にまとめたものです。そのため、1 回のサインインで、さまざまなサービスの情報を扱えます。

セットアップの準備をしよう！

PowerShell で Microsoft 365 の管理を始めるために、次の 2 つを準備します。

PowerShell 7 のインストール方法は、Microsoft の公式ドキュメントを参考にしてください。

公式ドキュメント：Windows への PowerShell のインストール

PowerShellを使ってMicrosoft365へ接続するまでの手順

Microsoft Graph PowerShell SDK をインストールし、Microsoft 365 に接続するまでの手順です。

PowerShell 7 を開く

Windows のスタートメニューで「PowerShell」と検索し、表示された PowerShell 7 (x64) を開きます。検証では、右側のメニューの「管理者として実行」で開きました。

次の STEP 2 のように、モジュールを自分のユーザーだけにインストールする（-Scope CurrentUser）場合は、管理者として開かなくてもインストールできます。すべてのユーザー向けにインストールする（-Scope AllUsers）場合は、管理者として開く必要があります。

Microsoft Graph PowerShell SDKモジュールをインストールする

Microsoft 365 を管理するためのコマンド（コマンドレット）を使うには、まずモジュールをインストールします。PowerShell のウィンドウで次のコマンドを実行します。

PowerShell 7

Install-Module Microsoft.Graph -Scope CurrentUser

実行すると、「Untrusted repository」（信頼されていないリポジトリ）と確認のメッセージが表示されます。インストール元の PSGallery は Microsoft が運営する公式のリポジトリですが、既定では「信頼されていない」設定になっているため、このメッセージが出ます。Y を入力して Enter キーを押し、インストールを続けます。

PowerShell 7.5.11PS C:\Users\hirotano> Install-Module Microsoft.Graph -Scope CurrentUser 2Untrusted repositoryYou are installing the modules from an untrusted repository. If you trust this repository, change itsInstallationPolicy value by running the Set-PSRepository cmdlet. Are you sure you want to install the modules from'PSGallery'?3[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): Y

インストールが終わったら、Get-InstalledModule Microsoft.Graph でインストールされたバージョンを確認できます。

Microsoft 365に接続する（Connect-MgGraph）

モジュールのインストールが終わったら、Microsoft 365 のテナントに接続します。接続には Connect-MgGraph を使います。

PowerShell 7

Connect-MgGraph -Scopes "User.Read.All", "Group.ReadWrite.All"

-Scopes には、このセッションで使いたい権限（スコープ）を指定します。この例で要求しているのは次の 2 つです。

セキュリティの面では、必要な権限だけを要求するのが基本です。たとえば、ユーザーの情報を読み取るだけなら User.Read.All だけで足ります。どのコマンドにどのスコープが必要かは、Microsoft のドキュメントの各コマンドのページで確認できます。

コマンドを実行すると Web ブラウザが起動し、Microsoft 365 のサインイン画面が表示されます。管理者のアカウントでサインインします。初めて接続するときや、要求するスコープが変わったときは、アクセス許可の同意画面が表示されます。

接続を確認する

接続できたかを、簡単なコマンドで確認します。次のコマンドで、テナントに登録されているユーザーの一覧を取得します。

PowerShell 7

Get-MgUser

PS C:\Users\hirotano> Get-MgUser 1DisplayName Id                                   Mail----------- --                                   ----（ユーザーの情報は伏せています）

ユーザーの一覧が表示されれば、接続は成功です。接続中のアカウントや同意済みのスコープは Get-MgContext で確認できます。作業が終わったら、Disconnect-MgGraph でサインアウトします。

セットアップ後にできること

セットアップが終われば、Microsoft 365 のユーザーやグループの管理を中心に、多くの作業を PowerShell で行えます。たとえば、次のような作業です。

どのコマンドも、実行には対応するスコープが必要です。たとえば、ユーザーを作成・変更するには User.ReadWrite.All を付けて接続し直します。

Exchange Online、SharePoint Online、Teams の設定をより細かく管理するには、Microsoft Graph PowerShell SDK だけでなく、それぞれのサービス用のモジュールを使う場合があります。

うまくいかないとき

まとめ