Поделиться через


Тип ресурса administrativeUnit

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

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

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

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

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

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

Методы

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

Примечание.

Конечная точка URL-адреса для вызова API administrativeUnits находится /administrativeUnits в конечной точке, beta но /directory/administrativeUnits в конечной точке v1.0 .

Свойства

Важно!

Определенное использование $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).
isMemberManagementRestricted Логический true Значение , если члены этой административной единицы должны рассматриваться как конфиденциальные, что требует определенных разрешений для управления. Значение по умолчанию — false. Используйте это свойство, чтобы определить административные единицы, роли которых не наследуются от администраторов уровня клиента, а управление отдельными объектами-членами ограничено администраторами. Неизменяемый, поэтому не может быть изменен позже.

Дополнительные сведения о работе с административными единицами управления с ограниченным доступом см. в разделе Ограниченные административные единицы управления в идентификаторе Microsoft Entra.
membershipRule String Правило динамического членства для административной единицы. Дополнительные сведения о правилах, которые можно использовать для динамических административных единиц и динамических групп, см. в статье Использование атрибутов для создания расширенных правил.
membershipRuleProcessingState String Используется для управления активной обработкой правила динамического членства. Задайте значение , On если требуется, чтобы правило динамического членства было активным, и Paused если вы хотите прекратить динамическое обновление членства. Если значение не задано, поведение по умолчанию — Paused.
membershipType String Тип членства для административной единицы. Допустимые значения: dynamic и assigned. Если значение не задано, поведение по умолчанию — assigned.
visibility String Определяет, являются ли административная единица и ее члены скрытыми или общедоступными. Можно задать значение HiddenMembership или Public. Если значение не задано, поведение по умолчанию — Public. Если задано значение HiddenMembership, только члены административной единицы могут перечислять другие члены административной единицы.

Совет

Расширения каталогов и связанные данные возвращаются по умолчанию, а расширения схемы и связанные данные возвращаются только в $select.

Связи

Связь Тип Описание
extensions Коллекция extension Коллекция открытых расширений, определенная для данной административной единицы. Допускается значение null.
members Коллекция directoryObject Пользователи и группы, которые являются членами этой административной единицы. Поддерживает $expand.
scopedRoleMembers Коллекция scopedRoleMembership Члены этой административной единицы с заданной областью действия.

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

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

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