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"
}
関連コンテンツ
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示