administrativeUnit リソースの種類

名前空間: microsoft.graph

管理単位は、ユーザー、グループ、およびデバイス のディレクトリ オブジェクトの概念コンテナーを提供します。 管理単位を使用すると、会社の管理者は、管理単位に含まれるユーザー、グループ、デバイスを管理するための管理責任を、地域または部門の管理者に委任できるようになりました。 管理単位の詳細については、「 Microsoft Entra ID の管理単位」を参照してください。

このリソースは、他のプロパティを渡すことができるオープン型です。

このリソースは以下をサポートしています。

• 拡張機能として、カスタム プロパティに独自のデータを追加します。
• デルタ関数を提供することにより、デルタ クエリを使用して、増分の追加、削除、更新を追跡します。
• OData クエリ機能 ( $select、 $filter、 $search、 $topなど)。 特定の使用法は、 高度なクエリ機能でのみサポートされます。

メソッド

メソッド	戻り値の型	説明
Create	administrativeUnit	新しい管理単位を作成します。
List	administrativeUnit コレクション	すべての administrativeUnits のプロパティを一覧表示します。
Get	administrativeUnit	特定の managementUnit オブジェクトのプロパティとリレーションシップを読み取ります。
Update	administrativeUnit	administrativeUnit オブジェクトを更新します。
Delete	なし	administrativeUnit オブジェクトを削除します。
Memberships
メンバーを追加する	directoryObject	メンバー (ユーザー、グループ、またはデバイス) を追加します。
メンバーを一覧表示する	directoryObject コレクション	(ユーザー、グループ、またはデバイス) メンバーの一覧を取得します。
メンバーを取得する	directoryObject	特定のメンバーを取得します。
メンバーを削除する	directoryObject	メンバーを削除します。
役割の割り当て
スコープを使用してロールの割り当てを一覧表示する	scopedRoleMembership コレクション	管理単位スコープを使用して Microsoft Entra ロールの割り当てを一覧表示します。
スコープを使用してロールを割り当てる	scopedRoleMembership	管理単位スコープを使用して Microsoft Entra ロールを割り当てます。
スコープを使用してロールの割り当てを取得する	scopedRoleMembership	管理単位スコープを使用して Microsoft Entra ロールの割り当てを取得します。
スコープを使用してロールの割り当てを削除する	scopedRoleMembership	管理単位スコープを使用して Microsoft Entra ロールの割り当てを削除します。
削除済みアイテム
List	directoryObject コレクション	ディレクトリ オブジェクトのコレクションから最近削除された管理単位の一覧を取得します。
Get	directoryObject	最近削除された管理単位オブジェクトのプロパティを取得します。
復元	directoryObject	最近削除した管理単位オブジェクトを復元します。

プロパティ

重要

$filter および $search クエリ パラメーターの具体的な使用方法は、ConsistencyLevel ヘッダーの設定を eventual と $count に使用する場合にのみサポートされます。 詳細については、「ディレクトリ オブジェクトの詳細クエリ機能」を参照してください。

プロパティ	型	説明
description	String	管理単位の説明 (省略可能)。 $filter (eq、ne、in、startsWith)、$searchをサポートします。
displayName	String	管理単位の表示名。 $filter (eq、ne、not、ge、le、in、startsWith、および eq の null値)、$search、および $orderby をサポートします。
id	String	管理単位の一意識別子。 読み取り専用です。 $filter (eq)をサポートしています。
visibility	String	管理単位とそのメンバーを非表示にするか、パブリックにするかを制御します。 HiddenMembershipに設定できます。 設定されていない場合 (値は null)、既定の動作はパブリックです。 HiddenMembershipに設定すると、管理単位の他のメンバーをリストできるのは、管理単位のメンバーだけです。

ヒント

ディレクトリ拡張機能と関連付けられたデータは既定で返されますが、スキーマ拡張機能と関連するデータは $selectでのみ返されます。

リレーションシップ

リレーションシップ	型	説明
members	directoryObject コレクション	この管理単位のメンバーであるユーザーとグループ。 $expand をサポートします。
extensions	extension コレクション	この管理単位に対して定義されているオープン拡張機能のコレクション。 Null 許容型。
scopedRoleMembers	scopedRoleMembership コレクション	この管理単位の Scoped-role メンバー。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

{
  "description": "String",
  "displayName": "String",
  "id": "String (identifier)",
  "visibility": "String"
}

関連コンテンツ

• 拡張機能を使用してカスタム データをリソースに追加する
• オープン拡張機能を使用してカスタム データをユーザーに追加する
• スキーマ拡張機能を使用してグループにカスタム データを追加する