【 New-MgDirectoryRoleMemberByRef 】コマンドレット――Azure Active Directoryユーザーにロールを割り当てる：Windows PowerShell基本Tips（65）

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

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

連載目次

　本連載では、Windows PowerShellの基本的なコマンドレットについて、基本的な書式からオプション、具体的な実行例までを分かりやすく紹介していきます。今回は、「Azure Active Directory」（Azure AD）を管理するための権限がまとめられた「ロール」をユーザーに割り当てる「New-MgDirectoryRoleMemberByRef」コマンドレットです。

目次

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

実行例

• Azure ADロールのIDを調べる
• ロールIDが割り当てられていないAzure ADロールを割り当てる
• Azure ADロールにユーザーを追加する

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

　「New-MgDirectoryRoleMemberByRef」は、PowerShellを利用してAzure ADユーザーにロールを割り当てるためのコマンドレットです。ロールはブラウザからも割り当てることができますが、コマンドレットは特定のタイミングでロールを割り当てるような処理を自動化する場合に有効です。

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

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

New-MgDirectoryRoleMemberByRef [オプション]

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

オプション	意味
-DirectoryRoleId	ユーザーを追加するAzure ADロールIDを指定する
-BodyParameter	Azure ADロールに追加するユーザーを指定する

目次に戻る

Azure ADロールのIDを調べる

　New-MgDirectoryRoleMemberByRefコマンドレットでロールにユーザーを追加する場合は、事前に操作する「ロールID」を知っておく必要があります。Azure ADの各ロールIDは「Get-MgDirectoryRole」コマンドレットで確認します（画面1）。