Exchange Onlineのコマンドでゲストユーザの属性を取得して結果をCSVファイルに出力する

はじめに

Exchange Onlineのコマンドでゲストユーザの属性を取得する機会があり取得に苦戦したので共有しようと思います。

はじめに
Get-MailUserで属性情報を取得する
まとめ

Get-MailUserで属性情報を取得する

本ブログではコマンド「Get-MailUser」に焦点を当てています。
他のExchange Onlineコマンドにも応用はできるので参考にしてみてください。
Get-MailUserの詳細は以下マイクロソフトのページを参照してください。

Get-MailUser (ExchangePowerShell) | Microsoft Learn

今回やりたいことは次の2点です。

Exchange Onlineコマンドから全ゲストユーザの指定した属性を取得したい
出力結果をCSVファイルに出力し、値が確認できるようにしたい

1.ユーザの属性情報を取得する

Get-MailUser -Identity <ExchangeObjectId> | FL

※Connect-ExchangeOnlineで接続済です。

1ユーザの属性値を確認する場合は上記コマンドでも構いません。
ですが、ユーザ数が多い場合の属性値確認にはむいておらず、フィルターをかけての属性値の確認や各ユーザの属性値の比較にも不向きです。
そこで、CSVに出力した場合に目的の属性値やユーザを発見しやすいコマンドを、次の2～5の手順で解説します。

2.ゲストユーザでフィルターをかける

下記コマンドでゲストユーザにフィルターをかけ、ゲストユーザのみを出力します。

Get-MailUser -Filter "RecipientTypeDetails -eq 'GuestMailUser'"

3.取得したい属性を指定する

以下コマンド取得したい属性のみを出力します。

Get-MailUser -Filter "RecipientTypeDetails -eq 'GuestMailUser'" | select UserPrincipalName,ExchangeObjectId,@{Name='EmailAddresses' ;Expression={$_.EmailAddresses}},@{Name='PrimarySmtpAddress' ;Expression={$_.PrimarySmtpAddress}},@{Name='ExternalEmailAddress' ;Expression={$_.ExternalEmailAddress}}

今回取得する値の一覧

UserPrincipalName
ExchangeObjectId
EmailAddresses　※
PrimarySmtpAddress　※
ExternalEmailAddress　※

※上記のような指定方法を推奨します。

4.出力結果が1000件以上ある場合に制限なく出力する

デフォルトではコマンド結果が1000件を超える場合は出力されません。
1000件以上出力結果がある場合の出力方法を記載しています。

以下コマンドでコマンド結果の出力数を無制限としています。

Get-MailUser -ResultSize unlimited -Filter "RecipientTypeDetails -eq 'GuestMailUser'" | select UserPrincipalName,ExchangeObjectId,@{Name='EmailAddresses' ;Expression={$_.EmailAddresses}},@{Name='PrimarySmtpAddress' ;Expression={$_.PrimarySmtpAddress}},@{Name='ExternalEmailAddress' ;Expression={$_.ExternalEmailAddress}}