Тип ресурса administrativeUnit

Пространство имен: microsoft.graph

Административная единица предоставляет концептуальный контейнер для объектов каталога пользователей, групп и устройств. С помощью административных единиц администратор компании теперь может делегировать административные обязанности по управлению пользователями, группами и устройствами, содержащимися в административной единице или в пределах административной единицы, региональному администратору или администратору отдела. Дополнительные сведения об административных единицах см. в разделе Административные единицы в Microsoft Entra ID.

Этот ресурс относится к открытому типу, который позволяет передавать другие свойства.

Этот ресурс поддерживает:

  • добавление собственных данных к настраиваемым свойствам в виде расширений;
  • отслеживание дополнений, удалений и обновлений с помощью запроса изменений (функция delta).

Методы

Метод Возвращаемый тип Описание
Создание administrativeUnit Create новую административную единицу.
List коллекция administrativeUnit Список свойств всех административных параметров.
Получение administrativeUnit Чтение свойств и связей определенного объекта administrativeUnit.
Обновление administrativeUnit Обновление объекта administrativeUnit.
удаление; Нет Удалите объект administrativeUnit.
Добавить участника directoryObject Добавление участника (пользователя, группы или устройства).
Перечисление участников Коллекция directoryObject Получение списка участников (пользователей, групп или устройств).
Получение члена directoryObject Получение определенного участника.
Удаление члена directoryObject Удаление элемента.
Добавление scopedRoleMember scopedRoleMembership Назначьте роль Microsoft Entra с область административной единицы.
Список scopedRoleMembers Коллекция scopedRoleMembership Перечисление Microsoft Entra назначений ролей с помощью область административной единицы.
Получение scopedRoleMember scopedRoleMembership Получите назначение роли Microsoft Entra с область административной единицы.
Удаление scopedRoleMember scopedRoleMembership Удалите назначение роли Microsoft Entra с область административной единицы.

Свойства

Важно!

Определенное использование $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 Члены этой административной единицы с заданной областью действия.

Представление JSON

В следующем представлении JSON показан тип ресурса.

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