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

Получение deviceRegistrationPolicy

  • Статья

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

Важно!

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

Чтение свойств и связей объекта deviceRegistrationPolicy . Представляет ограничения квоты deviceRegistrationPolicy, дополнительные политики проверки подлинности и авторизации для регистрации удостоверений устройств в организации.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet
✅ ✅ ✅ ✅

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) Policy.Read.DeviceConfiguration Policy.Read.All, Policy.ReadWrite.DeviceConfiguration
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Приложение Policy.Read.DeviceConfiguration Policy.ReadWrite.DeviceConfiguration

Важно!

В делегированных сценариях с рабочими или учебными учетными записями вошедшему пользователю должна быть назначена поддерживаемая роль Microsoft Entra или настраиваемая роль с разрешением поддерживаемой роли. Для этой операции поддерживаются следующие роли с наименьшими привилегиями.

  • Глобальный читатель
  • Администратор облачных устройств
  • Администратор Intune
  • Администратор Windows 365
  • Рецензент каталога

HTTP-запрос

GET /policies/deviceRegistrationPolicy

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.

Текст запроса

Не указывайте текст запроса для этого метода.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 200 OK и объект deviceRegistrationPolicy в теле отклика.

Примеры

Запрос

GET https://graph.microsoft.com/beta/policies/deviceRegistrationPolicy

Отклик

В следующем примере показан ответ с параметрами по умолчанию для политики регистрации устройств.

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#deviceRegistrationPolicy",
  "id": "deviceRegistrationPolicy",
  "displayName": "Device Registration Policy",
  "description": "Tenant-wide policy that manages intial provisioning controls using quota restrictions, additional authentication and authorization checks",
  "userDeviceQuota": 2,
  "multiFactorAuthConfiguration": "notRequired",
  "azureADRegistration": {
    "isAdminConfigurable": false,
    "allowedToRegister": {
      "@odata.type": "#microsoft.graph.noDeviceRegistrationMembership"
    },
  },
  "azureADJoin": {
    "isAdminConfigurable": true,
    "allowedToJoin": {
      "@odata.type": "#microsoft.graph.allDeviceRegistrationMembership"
    },
    "localAdmins": {
      "enableGlobalAdmins": true,
      "registeringUsers": {
        "@odata.type": "#microsoft.graph.enumeratedDeviceRegistrationMembership",
        "users": ["3c8ef067-8b96-44de-b2ae-557dfa0f97a0"],
        "groups": []
      }
    }
  },
  "localAdminPassword": {
    "isEnabled": false
  }
}