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


Регистрация в управлении обновлениями с помощью автоматического исправления Windows

При регистрации устройства в системе управления обновлениями с помощью автоматического исправления Windows можно использовать автоматическое исправление Windows для управления содержимым, доставленным из клиентский компонент Центра обновления Windows на это устройство. Вы можете зарегистрировать устройство в управлении обновлениями по категории обновления.

Сегодня автопатка Windows поддерживает регистрацию устройств для обновлений компонентов и драйверов Windows 10/11. В настоящее время регистрация устройств не требуется для управления обновлениями качества Windows 10/11 для развертывания ускоряемых обновлений качества.

Регистрация устройства в управлении обновлениями

Когда вы регистрируете устройство в системе управления для определенной категории обновлений, автоматическое исправление Windows становится центром обновления этой категории, поступающих из клиентский компонент Центра обновления Windows. В результате устройства не получают обновления этой категории от клиентский компонент Центра обновления Windows до тех пор, пока вы не развернете обновление, назначив его развертыванию. Устройства автоматически регистрируются при регистрации в управлении с помощью windows Autopatch (то есть объект azureADDevice автоматически создается, если он еще не существует). Сведения о регистрации драйверов см. в разделе Регистрация устройств в управлении драйверами.

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

Запрос

POST https://graph.microsoft.com/beta/admin/windows/updates/updatableAssets/enrollAssets
Content-Type: application/json

{
  "updateCategory": "feature",
  "assets": [
    {
      "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice",
      "id": "String (identifier)"
    },
    {
      "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice",
      "id": "String (identifier)"
    },
    {
      "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice",
      "id": "String (identifier)"
    }
  ]
}

Отклик

HTTP/1.1 202 Accepted

Проверка состояния регистрации устройства

Вы можете проверка состояние регистрации устройства, получив устройство и просмотрев свойства регистраций и ошибок в объекте azureADDevice. Устройство, которое успешно зарегистрировано в управлении обновлениями, имеет объект updateManagementEnrollment в коллекции регистраций, и оно не содержит объектов updatableAssetError в коллекции ошибок. Устройство, которое пыталось зарегистрироваться, но обнаружило ошибку, заполнило коллекции как для регистраций, так и для ошибок. Устройство без запросов на регистрацию содержит пустые коллекции как для регистраций, так и для ошибок.

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

Запрос

GET https://graph.microsoft.com/beta/admin/windows/updates/updatableAssets/983f03cd-03cd-983f-cd03-3f98cd033f98

Отклик

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

{
  "value": {
    "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice",
    "id": "983f03cd-03cd-983f-cd03-3f98cd033f98",
    "errors": [],
    "enrollments": [
      {
        "@odata.type": "microsoft.graph.windowsUpdates.updateManagementEnrollment",
        "updateCategory": "feature"
      }
    ]
  }
}

Отмена регистрации от руководства или отмена регистрации

При отмене регистрации устройства из управления для определенной категории обновлений устройство больше не считается управляемым и может начать получать другие обновления от клиентский компонент Центра обновления Windows в зависимости от конфигурации политики. Незарегистрированное устройство удаляется из всех аудиторий и развертываний, содержащих содержимое для данной категории обновления. Устройство остается зарегистрированным и по-прежнему регистрируется и получает содержимое для других категорий обновлений, если применимо.

Запрос

POST https://graph.microsoft.com/beta/admin/windows/updates/updatableAssets/unenrollAssets
Content-Type: application/json

{
  "updateCategory": "feature",
  "assets": [
    {
      "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice",
      "id": "String (identifier)"
    }
  ]
}

Отклик

HTTP/1.1 202 Accepted

Вы можете отменить регистрацию устройства полностью, удалив объект устройства. Если устройство не зарегистрировано, оно автоматически отменяется из управления для всех категорий обновлений и удаляется из каждого развертыванияAudience и updatableAssetGroup.

Запрос

DELETE https://graph.microsoft.com/beta/admin/windows/updates/updatableAssets/{azureADDeviceId}

Отклик

HTTP/1.1 202 Accepted