Тип ресурса administrativeUnit

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

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

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

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

• добавление собственных данных к настраиваемым свойствам в виде расширений;
• отслеживание дополнений, удалений и обновлений с помощью запроса изменений (функция delta).
• Возможности запросов OData , включая $select, $filter, $searchи $top. Конкретные использования поддерживаются только с расширенными возможностями запросов.

Методы

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

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

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

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

Связанные материалы

• Добавление пользовательских данных в ресурсы с помощью расширений
• Добавление пользовательских данных в ресурсы user с помощью открытых расширений
• Добавление пользовательских данных в группы с помощью расширений схемы