Registrar-se no gerenciamento de atualizações pelo serviço de implantação do Windows Update for Business

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

Hoje, o serviço de implantação dá suporte ao registro no gerenciamento de atualizações de recursos Windows 10/11 e atualizações de driver. Neste momento, o serviço de implantação não requer registro no gerenciamento de atualizações de qualidade Windows 10/11 para implantar atualizações de qualidade aceleradas.

Registrar o dispositivo no gerenciamento de atualizações

Quando você registra um dispositivo no gerenciamento de uma determinada categoria de atualização, o serviço de implantação se torna 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é implantar uma atualização usando o serviço de implantação atribuindo-a a uma implantação. Os dispositivos são registrados automaticamente com o serviço quando registrados no gerenciamento pelo serviço (ou seja, um objeto azureADDevice é criado automaticamente se ele ainda não existir). Para registro de driver, confira Registrar dispositivos no gerenciamento de driver.

O exemplo a seguir mostra como registrar um dispositivo no gerenciamento de atualização 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 o serviço tentou registrar, mas encontrou um erro, preencheu coleções para registros e erros. Um dispositivo para o qual o serviço não recebeu nenhuma solicitação 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 pelo serviço.

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 pelo serviço ou cancelar o registro do serviço

Quando você desativa um dispositivo do gerenciamento pelo serviço para uma determinada categoria de atualização, o dispositivo não é mais gerenciado pelo serviço de implantação 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 todos os públicos e implantações que contêm conteúdo para a categoria de atualização fornecida. O dispositivo permanece registrado no serviço 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 o registro de um dispositivo do serviço completamente excluindo o objeto do dispositivo. Quando um dispositivo não é registrado, ele é automaticamente desativado do gerenciamento pelo serviço para todas as categorias de atualização e removido de todas as implantaçõesAudiência e updatableAssetGroup.

Solicitação

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

Resposta

HTTP/1.1 202 Accepted