【Office 365】PowerShellでGet-MsolUserやGet-Mailboxの実行結果をUPNでマッピング

はじめに

Office 365にはテナント上のユーザーごとの情報（プロパティ値）を出力するPowerShellコマンドとして例えば以下のようなものがある。

• Office 365 PowerShell
  • Get-MsolUser
• Exchange Online PowerShell
  • Get-Mailbox
  • Get-User

上記コマンドごとに実行時に出力できるプロパティ値は異なるが、ときには複数の異なるコマンドの実行結果を一つのリストにまとめたいときがある。
その場合は各コマンドで共通して取得できるプロパティ値UserPrincipalNameをキーにしたマッピングを行えば可能である。

手順

Get-MsolUserとGet-Userの結果をUPNでマッピング

例として、Get-MsolUserとGet-Userでユーザーごとに以下の５つのプロパティの値をCSV出力する場合のコマンドを示す。

• Get-MsolUser
  • DisplayName
  • UserPrincipalName
  • Licenses
• Get-User
  • Company
  • Department

コマンド

#すべてのユーザーの情報を格納するオブジェクト$Datasを定義
$Datas = New-Object System.Collections.ArrayList

#Get-Userで取得したユーザーごとの情報を変数に格納
$ExOUsers = Get-User -ResultSize Unlimited

#Get-MsolUserで取得したユーザーごとの情報をForEachにより処理
Get-MsolUser -All | ForEach-Object {

    #UserPrincipalNameをキーにしてGet-UserとGet-MsolUserのユーザー情報を紐付け
    $MsolUPN = $_.UserPrincipalName
    $ExOUser = $ExOUsers | Where-Object {
        $_.UserPrincipalName -eq $MsolUPN
    }

    #ユーザーごとの情報を格納するオブジェクト$Dataを定義し、プロパティ値を設定して$Datasに格納
    $Data = New-Object PSObject | Select-Object DisplayName, UserPrincipalName, Company, Department, Licenses
    $Data.DisplayName = $_.DisplayName
    $Data.UserPrincipalName = $_.UserPrincipalName
    $Data.Company = ($ExOUser).Company
    $Data.Department = ($ExOUser).Department
    $Data.Licenses = ($_ | Select-Object -ExpandProperty Licenses).AccountSkuId -join ";"
    [void]$Datas.Add($Data)

}

#$Datasの内容をCSV出力
$Datas | Export-Csv export.csv -NoTypeInformation -Encoding UTF8

出力結果

export.csv

DisplayName,UserPrincipalName,Company,Department,Licenses
Liam,[e-mail],contoso Inc.,marketing,hoge:FLOW_FREE;hoge:O365_BUSINESS_ESSENTIALS
Noah,[e-mail],contoso Inc.,human resources,hoge:O365_BUSINESS_ESSENTIALS
Emma,[e-mail],contoso Inc.,Manufacturing,
Olivia,[e-mail],contoso Inc.,Manufacturing,hoge:O365_BUSINESS_PREMIUM
Ava,[e-mail],contoso Inc.,Manufacturing,hoge:O365_BUSINESS_PREMIUM;hoge:POWERAPPS_VIRAL

以上