Registrar-se no gerenciamento de atualizações pelo serviço de implantação Windows Update para Empresas

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 fornecido Windows Update para esse dispositivo. Você pode registrar um dispositivo no gerenciamento de atualizações por categoria de atualização.

Atualmente, o serviço de implantação dá suporte ao registro no gerenciamento de Windows 10 de recursos. No momento, o serviço de implantação não requer registro no gerenciamento de atualizações Windows 10 qualidade 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 do Windows Update até que você implante 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).

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 verificar 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ê cancela o registro de 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. Se o dispositivo for atribuído a qualquer implantação para a categoria de atualização fornecida, ele não receberá esse conteúdo. 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 é cancelado, ele é cancelado automaticamente do gerenciamento pelo serviço 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