Inscreva-se no gerenciamento de atualizações pelo Windows Autopatch

Ao inscrever um dispositivo no gerenciamento de atualizações do Windows Autopatch, você pode usar o Windows Autopatch para gerenciar o conteúdo entregue pelo Windows Update para esse dispositivo. Você pode registrar um dispositivo no gerenciamento de atualizações por categoria de atualização.

Hoje, o Windows Autopatch oferece suporte ao registro de dispositivo para atualizações de recursos e atualizações de driver do Windows 10/11. No momento, nenhum registro de dispositivo é necessário no gerenciamento de atualizações de qualidade do Windows 10/11 para implantar atualizações de qualidade aceleradas ou de hotpatch.

Registrar o dispositivo no gerenciamento de atualizações

Quando você registra um dispositivo no gerenciamento para uma determinada categoria de atualização, o Windows Autopatch se torna a autoridade para atualizações dessa categoria provenientes do Windows Windows Update. Como resultado, os dispositivos não recebem atualizações dessa categoria do Windows Update até que você implante uma atualização atribuindo-a a uma implantação. Os dispositivos são registrados automaticamente quando inscritos no gerenciamento pelo Windows Autopatch (ou seja, um objeto azureADDevice é criado automaticamente se ainda não existir). Para registro de driver, consulte registrar dispositivos no gerenciamento de driver.

O exemplo a seguir mostra como registrar um dispositivo no gerenciamento de atualizações de recursos.

Solicitação

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)"
    }
  ]
}

Resposta

HTTP/1.1 202 Accepted

Verificar o estado de registro de um dispositivo

Você pode marcar o estado de registro de um dispositivo obtendo o dispositivo e examinando as propriedades de registros e erros no objeto azureADDevice. Um dispositivo registrado com êxito no gerenciamento de atualizações tem um objeto updateManagementEnrollment na coleção de registros e não tem nenhum objeto updatableAssetError na coleção de erros. Um dispositivo que tentou se registrar, mas encontrou um erro, preencheu coleções para registros e erros. Um dispositivo sem solicitações de registro tem coleções vazias para registros e erros.

O exemplo a seguir mostra um dispositivo registrado com êxito no gerenciamento de atualizações de recursos.

Solicitação

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

Resposta

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"
      }
    ]
  }
}

Cancelar o registro do gerenciamento ou cancelar o registro

Quando você cancela o registro de um dispositivo do gerenciamento para uma determinada categoria de atualização, o dispositivo não é mais considerado gerenciado e pode começar a receber outras atualizações do Windows Update com base em sua configuração de política. O dispositivo não registrado é removido de todas as audiências e implantações que contêm conteúdo para determinada categoria de atualização. O dispositivo permanece registrado e ainda está registrado e recebendo conteúdo para outras categorias de atualização, se aplicável.

Solicitação

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)"
    }
  ]
}

Resposta

HTTP/1.1 202 Accepted

Você pode cancelar completamente o registro de um dispositivo excluindo o objeto do dispositivo. Quando um dispositivo tem o registro cancelado, ele é automaticamente cancelado do gerenciamento para todas as categorias de atualização e removido de cada deploymentAudience e updatableAssetGroup.

Solicitação

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

Resposta

HTTP/1.1 202 Accepted