【 Update-MgUser 】コマンドレット――Azure Active Directoryユーザーの属性を変更する：Windows PowerShell基本Tips（51）

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

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

連載目次

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

目次

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

実行例

• ユーザーの表示名を変更する
• UserIdが分からないユーザーの属性を変更する
• 複数のユーザーの属性をまとめて変更する

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

　「Update-MgUser」は、PowerShellを利用してAzure ADユーザーの属性を変更するコマンドレットです。Azure ADユーザーの属性はブラウザから変更する方法が一般的ですが、複数のユーザーを一括で変更する場合などに有効です。

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

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

Update-MgUser [オプション]

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

オプション	意味
-UserId	属性を変更するAzure ADユーザーを指定する
-DisplayName	ユーザーの表示名を変更する。省略可能
-usageLocation	ユーザーの利用場所を変更する。省略可能

目次に戻る

ユーザーの表示名を変更する

　Update-MgUserコマンドレットでは、「-UserId」オプションで属性を変更するユーザーを指定します。その後、続けて設定変更したい属性をオプションで指定します。ユーザーの表示名を変更する場合は、「-DisplayName」属性を利用します（画面1）。

　Update-MgUserコマンドレットで設定変更可能な属性一覧は、MicrosoftのWebサイト「Update-MgUser」で確認できます。