【 New-MgUser 】コマンドレット――Azure Active Directoryのユーザーを新規作成する：Windows PowerShell基本Tips（72）

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

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

連載目次

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

目次

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

実行例

• ユーザーを新規作成する
• CSVファイルを利用してユーザーをまとめて作成する

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コマンドレットの書式

New-MgUser [オプション]

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

オプション	意味
-DisplayName	表示上の名前を設定する
-MailNickName	メールのエイリアスを設定する
-UserPrincipalName	UPN（User Principal Name）形式のユーザー名を設定する
-PasswordProfile	ユーザーのパスワードを設定する
-AccountEnabled	有効なユーザーを作成する。省略可能
-UsageLocation	利用場所属性を設定する。省略可能

目次に戻る

ユーザーを新規作成する

　New-MgUserコマンドレットでは必須オプションを付加して実行することで、ユーザーを新規作成できます。このとき、「パスワード」の値だけはNew-MgUserコマンドレット内で直接指定できないため、事前に変数に定義しておきます（画面1）。