【 New-MgDirectoryAdministrativeUnitMemberByRef 】コマンドレット――Azure Active Directoryの「管理単位」にユーザーを追加する：Windows PowerShell基本Tips（68）

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

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

連載目次

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

目次

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

実行例

• 管理単位のIDを調べる
• 管理単位にユーザーを追加する
• 管理単位に複数のユーザーをまとめて追加する

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

　「New-MgDirectoryAdministrativeUnitMemberByRef」は、PowerShellを利用してAzure AD管理単位に所属させたいユーザーを追加するためのコマンドレットです。Azure AD管理単位はActive Directory（AD）の「組織単位（OU）」に相当する“入れ物”ですが、ADのOUようにGUIの管理ツール上で複数のユーザーをドラッグ＆ドロップでまとめて追加するようなことはできません。そのため、管理単位に複数ユーザーをまとめて追加する場合は、New-MgDirectoryAdministrativeUnitMemberByRefコマンドレットを使って処理を自動化します。

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

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

New-MgDirectoryAdministrativeUnitMemberByRef [オプション]

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

オプション	意味
-AdministrativeUnitId	ユーザーを追加する管理単位のIDを指定する
-BodyParameter	管理単位に追加するユーザーを指定する

目次に戻る

管理単位のIDを調べる

　New-MgDirectoryAdministrativeUnitMemberByRefコマンドレットを使用して管理単位にユーザーを追加する場合、事前に操作する「管理単位のID」を知る必要があります。管理単位のIDは、「Get-MgDirectoryAdministrativeUnit」コマンドレットで確認します（画面1）。