Inscrever-se na gestão de atualizações por Bloqueio Automático do Windows

Quando inscreve um dispositivo na gestão de atualizações através do Windows Autopatch, pode utilizar a Correção Automática do Windows para gerir o conteúdo fornecido de Windows Update para esse dispositivo. Pode inscrever um dispositivo na gestão de atualizações por categoria de atualização.

Atualmente, o Windows Autopatch suporta a inscrição de dispositivos para atualizações de funcionalidades Windows 10/11 e atualizações de controladores. Neste momento, não é necessária qualquer inscrição de dispositivos na gestão de atualizações de qualidade Windows 10/11 para implementar atualizações de qualidade aceleradas.

Inscrever o dispositivo na gestão de atualizações

Quando inscreve um dispositivo na gestão de uma determinada categoria de atualização, o Windows Autopatch torna-se a autoridade para atualizações dessa categoria provenientes de Windows Update. Como resultado, os dispositivos não recebem atualizações dessa categoria de Windows Update até implementar uma atualização ao atribuí-la a uma implementação. Os dispositivos são registados automaticamente quando inscritos na gestão pelo Windows Autopatch (ou seja, um objeto azureADDevice é criado automaticamente se ainda não existir). Para a inscrição de controladores, veja Inscrever dispositivos na gestão de controladores.

O exemplo seguinte mostra como inscrever um dispositivo na gestão de atualizações de funcionalidades.

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 inscrição de um dispositivo

Pode marcar o estado de inscrição de um dispositivo ao obter o dispositivo e ver as propriedades de inscrições e erros no objeto azureADDevice. Um dispositivo inscrito com êxito na gestão de atualizações tem um objeto updateManagementEnrollment na coleção de inscrições e não tem objetos updatableAssetError na coleção de erros. Um dispositivo que tentou inscrever-se, mas encontrou um erro, preencheu as coleções para inscrições e erros. Um dispositivo sem pedidos de inscrição tem coleções vazias para inscrições e erros.

O exemplo seguinte mostra um dispositivo inscrito com êxito na gestão de atualizações de funcionalidades.

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

Anular a inscrição da gestão ou anular o registo

Quando anula a inscrição de um dispositivo da gestão de uma determinada categoria de atualização, o dispositivo já não é considerado gerido e pode começar a receber outras atualizações de Windows Update com base na respetiva configuração de política. O dispositivo não inscrito é removido de todas as audiências e implementações que contêm conteúdo para a categoria de atualização especificada. O dispositivo permanece registado e ainda está inscrito e a receber conteúdos 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

Pode anular completamente o registo de um dispositivo ao eliminar o objeto do dispositivo. Quando um dispositivo não é registado, este é automaticamente anulado da gestão de todas as categorias de atualização e removido de todas as implementaçõesAudiência e updatableAssetGroup.

Solicitação

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

Resposta

HTTP/1.1 202 Accepted