【 Get-MgUser 】コマンドレット――Azure Active Directoryユーザーを参照する：Windows PowerShell基本Tips（50）

本連載は、PowerShellコマンドレットについて、基本書式からオプション、具体的な実行例までを紹介していきます。今回は「Get-MgUser」コマンドレットを解説します。

[国井傑，株式会社エストディアン]

連載目次

　本連載では、Windows PowerShellの基本的なコマンドレットについて、基本的な書式からオプション、具体的な実行例までを分かりやすく紹介していきます。今回は、「Azure Active Directory」（Azure AD）に作成されたユーザーを参照する「Get-MgUser」コマンドレットです。

目次

Get-MgUserの概要 | 書式 | オプション

実行例

• ディレクトリに含まれる全てのAzure ADユーザーを表示する
• 特定のユーザーの属性を参照する
• 値が前方一致するユーザーを一覧表示する
• 演算子に「ne」を利用する

Get-MgUserコマンドレットとは？

　「Get-MgUser」は、PowerShellを利用してAzure ADユーザーを参照するためのコマンドレットです。Azure ADのユーザー一覧はブラウザから参照する方法が一般的ですが、Get-MgUserコマンドレットを利用することで、特定の条件に合致するユーザーだけを簡単に参照できるようになります。

　なお、Get-MgUserコマンドレットは、本連載第45回で解説した≪「Connect-MgGraph」コマンドレットで「Connect-MgGraph -Scopes "User.Read.All"」を実行して、Azure ADへの接続とアクセス許可を与えておくことが前提条件になります。

Get-MgUserコマンドレットの書式

Get-MgUser [オプション]

Get-MgUserコマンドレットの主なオプション

オプション	意味
-All	全てのAzure ADユーザーを表示する。省略可能
-Filter	条件に合致するAzure ADユーザーを表示する。省略可能
-ConsistencyLevel	ConsistencyLevelヘッダを定義し、Advanced Queryの有効化を設定する。省略可能
-Count	Get-MgUserコマンドレットが返した値の数を変数として設定する。省略可能

目次に戻る

ディレクトリに含まれる全てのAzure ADユーザーを表示する

　Get-MgUserコマンドレットに「-All」オプションを指定して実行すると、Connect-MgGraphコマンドレットで接続したディレクトリに作成された全てのユーザーを表示します（画面1）。