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

тип ресурса домена

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

Представляет домен, связанный с клиентом.

Используйте операции с доменом, чтобы связать домены с клиентом, проверить владение доменом и настроить поддерживаемые службы. Проверка домена с помощью Microsoft Graph не настраивает домен для использования с Office 365 службами, такими как Exchange. Полная настройка домена для работы с продуктами Microsoft 365 может потребовать дополнительных действий. Дополнительные сведения см. в статье Настройка администратора Microsoft 365.

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

  1. Связывание домена с клиентом.

  2. Получите записи проверки домена. Добавьте сведения о записи проверки в файл зоны домена с помощью регистратора домена или конфигурации DNS-сервера.

  3. Проверьте владение доменом, включая переключение внешнего администратора. Эта операция задает свойству isVerified значение true.

  4. Укажите поддерживаемые службы, которые планируется использовать с доменом.

  5. Настройте поддерживаемые службы, извлекая список записей, необходимых для включения служб для домена. Добавьте сведения о записи конфигурации в файл зоны домена с помощью регистратора доменных имен или конфигурации DNS-сервера.

Методы

Метод Возвращаемый тип Описание
Список domain; Получите все домены, связанные с клиентом.
Создание domain; Добавление домена в клиент.
Получение domain; Чтение свойств и связей объекта предметной области.
Получение корневого домена domain; Получите корневой домен поддомена.
Обновление domain; Обновления домен.
удаление; Нет Удаляет домен.
Принудительное удаление Нет Удаляет домен с помощью асинхронной операции.
Проверять domain; Проверка права собственности на домен.
Promote Логический Повышение уровня проверенного поддомена до корневого домена.
Перечисление ссылок на доменные имена Коллекция directoryObject Получите список объектов каталога со ссылкой на домен.
Перечисление записей конфигурации службы коллекция domainDnsRecord Получение списка записей DNS домена для настройки домена.
Вывод списка записей DNS для проверки коллекция domainDnsRecord Получение списка записей DNS домена для проверки домена.

Свойства

Свойство Тип Описание
authenticationType String Указывает настроенный тип проверки подлинности для домена. Значение равно или ManagedFederated. Managedуказывает управляемый облачный домен, в котором Microsoft Entra идентификатор выполняет проверку подлинности пользователя. Federatedуказывает, что проверка подлинности является федеративной с поставщиком удостоверений, например с локальная служба Active Directory клиента, через службы федерации Active Directory (AD FS). Значение null не допускается.

Чтобы обновить это свойство в делегированных сценариях, вызывающему приложению необходимо назначить разрешение Domain-InternalFederation.ReadWrite.All .
availabilityStatus String Это свойство всегда null имеет значение, за исключением случаев, когда используется действие проверки . При использовании действия проверки в ответе возвращается сущность домена . Свойство availabilityStatus сущности домена в ответе имеет значение AvailableImmediately или EmailVerifiedDomainTakeoverScheduled.
id String Полное имя домена. Ключ, неизменяемый, не допускающий значения NULL, уникальный.
isAdminManaged Логический Значение свойства равно, false если управление записями DNS домена делегировано Microsoft 365. В противном случае значение равно true. Значение NULL не допускается
isDefault Логический true Значение , если это домен по умолчанию, используемый для создания пользователей. Существует только один домен по умолчанию для каждой компании. Значение null не допускается.
isInitial Логический true Если это начальный домен, созданный Microsoft Online Services (contoso.com). На каждую компанию имеется только один начальный домен. Значение NULL не допускается
isRoot Логический true Значение , если домен является проверенным корневым доменом. В противном случае , false если домен является поддоменом или непроверен. Значение null не допускается.
isVerified Логический true Значение , если домен прошел проверку владения доменом. Значение null не допускается.
passwordNotificationWindowInDays Int32 Указывает количество дней, в течение которых пользователь получит уведомление об истечении срока действия пароля. Если свойство не задано, используется значение по умолчанию 14 дней.
passwordValidityPeriodInDays Int32 Указывает срок действия пароля до его изменения. Если свойство не задано, используется значение по умолчанию 90 дней.
state domainState Состояние асинхронных операций, запланированных для домена.
supportedServices Коллекция строк Возможности, назначенные домену. Может включать 0или 1 несколько следующих значений: Email, Sharepoint, EmailInternalRelayOnly, OfficeCommunicationsOnline, SharePointDefaultDomain, FullRedelegation, , SharePointPublic, OrgIdAuthentication, Yammer, . Intune Значения, которые можно добавить или удалить с помощью API: Email, OfficeCommunicationsOnline, Yammer. Значение null не допускается.

Связи

Связи между доменом и другими объектами в каталоге, такими как его записи проверки и записи конфигурации службы, предоставляются через свойства навигации. Эти связи можно прочитать, нацелив на эти свойства навигации в запросах.

Связь Тип Описание
domainNameReferences Коллекция directoryObject Такие объекты, как пользователи и группы, ссылающиеся на идентификатор домена. Только для чтения, допускает значение NULL. Не поддерживает $expand. Поддерживает $filter возвращаемые объекты типа OData. Например, /domains/{domainId}/domainNameReferences/microsoft.graph.user и /domains/{domainId}/domainNameReferences/microsoft.graph.group.
federationConfiguration internalDomainFederation Параметры домена, настроенные клиентом при федерации с идентификатором Microsoft Entra. Не поддерживает $expand.
rootDomain domain; Корневой домен поддомена. Только для чтения, допускает значение NULL. Поддерживает $expand.
serviceConfigurationRecords коллекция domainDnsRecord DNS записывает, что клиент добавляет в dns-файл зоны домена, прежде чем домен можно будет использовать службами Microsoft Online. Только для чтения, допускает значение NULL. Не поддерживает $expand.
verificationDnsRecords коллекция domainDnsRecord Dns записывает, что клиент добавляет в dns-файл зоны домена, прежде чем клиент сможет пройти проверку владения доменом с Microsoft Entra идентификатором. Только для чтения, допускает значение NULL. Не поддерживает $expand.

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

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

{
  "authenticationType": "String",
  "availabilityStatus": "String",
  "id": "String (identifier)",
  "isAdminManaged": true,
  "isDefault": true,
  "isInitial": true,
  "isRoot": true,
  "isVerified": true,
  "passwordNotificationWindowInDays": 14,
  "passwordValidityPeriodInDays": 90,
  "state": {"@odata.type": "microsoft.graph.domainState"},
  "supportedServices": ["String"]
}
  • Last updated on