【 New-MgUser 】コマンドレット――Azure Active Directoryのユーザーを新規作成する：Windows PowerShell基本Tips（72）
本連載は、PowerShellコマンドレットについて、基本書式からオプション、具体的な実行例までを紹介していきます。今回は「New-MgUser」コマンドレットを解説します。
この記事は会員限定です。会員登録（無料）すると全てご覧いただけます。
本連載では、Windows PowerShellの基本的なコマンドレットについて、基本的な書式からオプション、具体的な実行例までを分かりやすく紹介していきます。今回は、「Azure Active Directory」（Azure AD）に新しくユーザーを作成する「New-MgUser」コマンドレットです。
New-MgUserコマンドレットとは？
「New-MgUser」は、PowerShellを利用してAzure ADにユーザーを新規作成するためのコマンドレットです。一般的にコマンドレットによるAzure ADの操作は、複数の操作をまとめて実行したい場合に有効ですが、ユーザー作成に限っては「Microsoft Entra管理センター」（Microsoft Entra admin center）からCSVファイル経由でまとめて作成することが可能です。
しかし、Microsoft Entra管理センターではユーザーをまとめて変更できないため、ユーザーの作成／変更／削除を全てPowerShellで実行したい場合にはNew-MgUserコマンドレットが有効です。
なお、New-MgUserコマンドレットは、本連載第45回で解説した「Connect-MgGraph」コマンドレットで「Connect-MgGraph -Scopes "User.ReadWrite.All"」と実行して、Azure ADへの接続とアクセス許可を与えておくことが前提条件になります。
New-MgUserコマンドレットの主なオプション
| オプション | 意味 |
|---|---|
| -DisplayName | 表示上の名前を設定する |
| -MailNickName | メールのエイリアスを設定する |
| -UserPrincipalName | UPN（User Principal Name）形式のユーザー名を設定する |
| -PasswordProfile | ユーザーのパスワードを設定する |
| -AccountEnabled | 有効なユーザーを作成する。省略可能 |
| -UsageLocation | 利用場所属性を設定する。省略可能 |
ユーザーを新規作成する
New-MgUserコマンドレットでは必須オプションを付加して実行することで、ユーザーを新規作成できます。このとき、「パスワード」の値だけはNew-MgUserコマンドレット内で直接指定できないため、事前に変数に定義しておきます（画面1）。
Copyright © ITmedia, Inc. All Rights Reserved.
ITmediaはアイティメディア株式会社の登録商標です。