【 New-MgGroupMember 】コマンドレット――Azure Active Directoryグループに新しいメンバーを追加する：Windows PowerShell基本Tips（59）

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

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

連載目次

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

目次

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

実行例

• グループのメンバーを追加する
• GroupId／UserIdを指定せずにグループのメンバーを追加する

New-MgGroupMemberコマンドレットとは？

　「New-MgGroupMember」は、PowerShellを利用してAzure ADグループのメンバーを追加するためのコマンドレットです。Azure ADグループへのメンバーの追加／削除はブラウザから行うことが一般的ですが、複数のユーザーを一括処理する場合などに有効です。

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

New-MgGroupMemberコマンドレットの書式

New-MgGroupMember [オプション]

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

オプション	意味
-GroupId	メンバーを追加するAzure ADグループのグループIDを指定する
-DirectoryObjectId	Azure ADグループに追加するユーザー／グループのIDを指定する

目次に戻る

グループのメンバーを追加する

　New-MgGroupMemberコマンドレットでは、「-GroupId」オプションを指定してメンバーを追加するグループを指定します。続けて「-DirectoryObjectId」オプションを指定して、グループに追加するメンバーを指定します（画面1）。メンバーにはユーザーまたはグループのどちらを指定することもできますが、どちらを指定する場合もユーザーID／グループIDを指定しなければなりません。