ユーザー名を入れるだけで使えるMicrosoft 365ユーザーのプロパティ取得スクリプト

Microsoft 365(M365)環境でユーザー情報を取得したいとき、PowerShellを使えば簡単にプロパティを確認できます。

本記事では、ユーザー名を入れるだけで使えるスクリプトを紹介し、Windowsでの実行手順も解説します。

利用シーン

  • ユーザーのメールアドレスや表示名を確認したい
  • ライセンス情報や部署情報をCSVでまとめたい
  • 管理者が一括でユーザー情報を取得する必要がある場合

利用するスクリプト

以下のスクリプトは、指定したユーザーのプロパティを取得し、CSVファイルにエクスポートします。変数を使って、ユーザーアドレスや出力先パスを簡単に変更できるようにしています。また、Select-Object内に取得したいプロパティを追加することで、さらに情報を出力することが出来ます。

# 取得したいユーザーのメールアドレス
$userEmail = "user@example.com"
# CSVファイルの保存先
$outputPath = "C:\Export\UserInfo.csv"
# ユーザー情報を取得
Get-MgUser -UserId $userEmail | Select-Object DisplayName, Mail, Department, JobTitle | Export-Csv -Path $outputPath -NoTypeInformation
Write-Host "ユーザー情報を $outputPath にエクスポートしました。"

Windowsでのスクリプト実行方法

  1. PowerShellを管理者権限で起動

  2. Microsoft Graph PowerShell SDKをインストール(初回のみ)
    Install-Module Microsoft.Graph -Scope CurrentUser
    
  3. M365に接続
    # Microsoft Graphに接続
    Connect-MgGraph -Scopes "User.Read.All"
    # 接続確認(オプション)
    Get-MgContext
    

    ※認証画面が表示されるので、管理者権限を持つアカウントでサインインします。

  4. 上記のスクリプトに必要な値(メールアドレス、出力パス、取得内容)を変更し、PowerShellで実行
  5. 出力されたCSVを確認する

まとめ

M365ユーザー情報は Microsoft Graph PowerShell を使うことで簡単に取得できます。Get-MgUserコマンドでユーザー情報を取得し、Export-CSVでCSVに出力することができます。

変数を使えば、スクリプトの再利用性が高まり、管理作業が効率化できますので、ぜひお試しください。

執筆担当者プロフィール
池田 咲也

池田 咲也(日本ビジネスシステムズ株式会社)

通信サービス本部 CI部 6Gに所属。Exchange Online導入やCopilotサポート、IDプロビジョニングツール開発などを経験。趣味はNetflix鑑賞とサイクリング。

担当記事一覧