【 New-MgGroupMember 】コマンドレット――Azure Active Directoryグループに新しいメンバーを追加する：Windows PowerShell基本Tips（59）
本連載は、PowerShellコマンドレットについて、基本書式からオプション、具体的な実行例までを紹介していきます。今回は「New-MgGroupMember」コマンドレットを解説します。
この記事は会員限定です。会員登録（無料）すると全てご覧いただけます。
本連載では、Windows PowerShellの基本的なコマンドレットについて、基本的な書式からオプション、具体的な実行例までを分かりやすく紹介していきます。今回は、「Azure Active Directory」（Azure AD）グループに新たにメンバーを追加する「New-MgGroupMember」コマンドレットです。
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コマンドレットの主なオプション
| オプション | 意味 |
|---|---|
| -GroupId | メンバーを追加するAzure ADグループのグループIDを指定する |
| -DirectoryObjectId | Azure ADグループに追加するユーザー／グループのIDを指定する |
グループのメンバーを追加する
New-MgGroupMemberコマンドレットでは、「-GroupId」オプションを指定してメンバーを追加するグループを指定します。続けて「-DirectoryObjectId」オプションを指定して、グループに追加するメンバーを指定します（画面1）。メンバーにはユーザーまたはグループのどちらを指定することもできますが、どちらを指定する場合もユーザーID／グループIDを指定しなければなりません。
Copyright © ITmedia, Inc. All Rights Reserved.
ITmediaはアイティメディア株式会社の登録商標です。