【 Get-AzureADMSGroup 】コマンドレット――Azure Active Directoryに作成されたグループを参照する：Windows PowerShell基本Tips（35）

連載目次

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

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

　「Get-AzureADMSGroup」は、PowerShellを利用してAzure ADのグループ一覧を表示するコマンドレットです。Azure ADのグループ一覧を表示するコマンドレットには「Get-AzureADGroup」とGet-AzureADMSGroupの2つがありますが、Get-AzureADMSGroupにはより多くのオプションが利用できるメリットがあります。

　なお、Get-AzureADMSGroupコマンドレットは、本連載第30回で解説した「Connect-AzureAD」コマンドレットを利用してAzure ADに接続していることが前提条件になります。

Get-AzureADMSGroupの主なオプション

Azure ADのグループ一覧を参照する

　Get-AzureADMSGroupコマンドレットを、オプションを指定せずに実行すると、Azure ADに作成されたグループの一覧が表示されます（画面1）。

コマンドレット実行例

Get-AzureADMSGroup

画面1　Get-AzureADMSGroupコマンドレットを利用してグループ一覧を表示した

目次に戻る

全てのグループを表示する

　Get-AzureADMSGroupコマンドを、オプションを指定せずに実行した場合、実行結果に表示されるグループの数は既定で「100」です。そのため、明示的に全てのグループを表示させるには、「-All」オプションを利用する必要があります（画面2）。

コマンドレット実行例

Get-AzureADMSGroup -All $true

画面2　Get-AzureADMSGroupコマンドレットに続けて「-All $true」と指定した。見た目は変わらないように見えるが、これにより全てのグループの一覧が表示される

目次に戻る

特定の名称のグループだけを表示する

　Azure ADに作成されたグループのうち、特定の名前を持つグループだけを表示させたい場合は、一部のグループだけを表示させる条件設定である「-Filter」オプションを使います。-Filterオプションに続けて、「"属性 演算子 値"」という並びで条件を設定します。

コマンドレット実行例

Get-AzureADMSGroup -Filter "displayName eq 'MES'"

画面3　Get-AzureADMSGroupコマンドレットでdisplayName属性が「MES」と設定されているグループだけを表示した

目次に戻る

Microsoft 365グループだけを表示する

　Azure ADに作成されたグループのうち、「Microsoft Teams」のチームとしても使われる「Microsoft 365」グループだけを表示させたい場合は、-Filterオプションを使います。

　Microsoft 365グループの場合、groupTypes属性に{unified}という値が入るため、この値を持つグループだけを表示するように条件設定します（画面4）。

コマンドレット実行例

Get-AzureADMSGroup -Filter "groupTypes/any(c:c eq 'Unified')" 

画面4　Get-AzureADUserコマンドレットで「Filter"groupTypes/any(c:c eq 'Unified')"」と指定することで、groupTypes属性に{unified}という値が入るグループを表示できる

筆者紹介

国井 傑（くにい すぐる）

株式会社エストディアン代表取締役。1997年からマイクロソフト認定トレーナーとして、Azure Active DirectoryやMicrosoft 365 Defenderなど、クラウドセキュリティを中心としたトレーニングを提供している。2007年からMicrosoft MVP for Enterprise Mobilityを連続して受賞。なお、テストで作成するユーザーアカウントには必ずサッカー選手の名前が登場するほどのサッカー好き。