Регистрация в службе развертывания клиентский компонент Центра обновления Windows для бизнеса для управления обновлениями

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

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

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

При регистрации устройства в управлении для определенной категории обновлений служба развертывания становится центром обновления этой категории, поступающим из клиентский компонент Центра обновления Windows. В результате устройства не получают обновления этой категории от клиентский компонент Центра обновления Windows, пока вы не развернете обновление с помощью службы развертывания, назначив его развертыванию. Устройства автоматически регистрируются в службе при регистрации службы в управлении (то есть объект 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