> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/pt/sonar/administration/patching/device-updates.md).

# Atualizações em um único dispositivo

Revise, aprove, ignore, faça a varredura e instale as atualizações do Windows de um dispositivo pela aba Updates e pelo menu de ações, e veja o que acontece na reinicialização.

## O que é e quando usar

A aba **Updates** (atualizações) de um dispositivo Windows lista todas as atualizações que o agente encontrou naquela máquina na última vez que consultou o Windows Update: as que já estão instaladas e as que ainda faltam. Na aba, você decide, atualização por atualização, o que pode ser instalado, e inicia uma varredura ou uma instalação sob demanda.

Use-a para atualizar uma máquina agora (um servidor antes que a janela de manutenção se feche, um notebook que perdeu a execução agendada) ou para segurar uma atualização que quebra uma aplicação.

Para o parque inteiro, use **Devices › Windows Updates**: veja [Windows Updates em todo o parque](https://wiki.datadike.com/pt/sonar/administration/patching/windows-updates.md). Para as regras que aprovam atualizações automaticamente e agendam a instalação, veja [Política de aprovação de atualizações](https://wiki.datadike.com/pt/sonar/administration/patching/patch-policy.md). Para o procedimento completo, veja [Automatizar as atualizações do Windows](https://wiki.datadike.com/pt/sonar/administration/patching/automate-windows-updates.md).

## Antes de começar

* Um papel com **Manage Windows Updates** em **Admin Center › Roles**. Essa permissão abre a lista e habilita todas as ações desta página.
* Um dispositivo Windows. Em dispositivos Linux e macOS, a aba mostra **Only supported for Windows Devices**.
* O dispositivo **online**. **Run Update Scan** e **Install Approved Updates** só ficam disponíveis enquanto o dispositivo está online; caso contrário, aparecem esmaecidos com *This machine must be online to run actions*.

## Como as atualizações avançam pela aba

| Etapa           | O que acontece                                                                                                                                                                                                                                           |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Varredura       | O agente pergunta ao Windows Update quais atualizações se aplicam à máquina e as informa. As atualizações encontradas pela primeira vez aparecem com **Do Nothing**                                                                                      |
| Aprovação       | Uma atualização passa a **Approve** à mão (clique com o botão direito na linha) ou pela aprovação automática da política de atualizações                                                                                                                 |
| Instalação      | Uma execução de instalação instala, uma após a outra, todas as atualizações em **Approve** que ainda não estão instaladas                                                                                                                                |
| Resultado       | Cada atualização informa sucesso ou falha. Uma atualização bem-sucedida mostra **Installed** e a data em **Installed On**. A data só existe nas instalações que o SONAR executou; uma atualização instalada por outro meio mostra **Installed** sem data |
| Reinicialização | Ao final da execução, a configuração de reinicialização da política de atualizações decide se o dispositivo reinicia                                                                                                                                     |

O agente também faz a varredura por conta própria quando o serviço dele inicia, e o servidor pede uma varredura a todos os dispositivos Windows online a cada 8 horas.

## Passos

**Fazer a varredura do dispositivo**

1. Abra **Dashboard › Sysadmin**, escolha o cliente e clique no dispositivo na lista.
2. No painel do dispositivo, na parte inferior, abra a aba **Updates**.
3. Clique em **Run Update Scan**. O console confirma com `A Windows update scan will be performed on <hostname>`.
4. Aguarde alguns minutos e clique no ícone de recarregar, à esquerda da barra de ferramentas, para carregar a lista de novo.

**Aprovar, ignorar ou redefinir uma atualização**

1. Clique com o botão direito na linha da atualização. As atualizações instaladas não têm menu.
2. Escolha **Approve**, **Ignore**, **Do Nothing** ou **Inherit**. O console confirma com `Windows update <KB> was changed to <action>` e recarrega a lista.

**Instalar**

1. Clique em **Install Approved Updates**. O console confirma com `Approved patches will now be installed on <hostname>`.
2. Antes de instalar, o servidor aplica a aprovação automática da política de atualizações do dispositivo, de modo que a execução abrange as atualizações que você aprovou à mão e as que a política aprova.

**Pelo menu de ações do dispositivo**

O menu **Other actions** (o **⋮** no cabeçalho do painel do dispositivo, ou um clique com o botão direito na linha do dispositivo na lista) tem **Patch Management**, com duas entradas:

* **Run Patch Status Scan**: a mesma varredura de **Run Update Scan**. O console mostra `Scan will be run shortly on <hostname>`.
* **Install Patches Now**: a mesma instalação de **Install Approved Updates**.

Envie-as apenas para um dispositivo online. Uma solicitação para um dispositivo offline não é entregue.

## O que você deve ver

A aba lista uma linha por atualização, com dois selos à esquerda:

* a **aprovação**: **Do Nothing**, **Approve**, **Ignore** ou **Inherit**;
* o **status de instalação**: **Installed**, **Pending** (aprovada e aguardando uma execução de instalação), **Ignored** ou **Missing** (ainda não aprovada).

Clique no texto **More Info** de uma linha para ler as categorias da atualização, a descrição completa e os links de suporte que a Microsoft publica para ela.

Depois de uma execução de instalação, as atualizações instaladas mostram **Installed** e uma data em **Installed On**. As atualizações que falharam continuam aprovadas, com **Pending**, e são tentadas de novo na próxima execução de instalação.

## Reinicialização após a instalação

Quando uma execução de instalação termina, o agente informa ao servidor se o Windows precisa reiniciar, e o servidor aplica **Reboot After Install** da política de atualizações do dispositivo:

| Configuração      | O que acontece ao final de uma execução de instalação                                                                                    |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **Never**         | Nenhuma reinicialização. A coluna **Needs Reboot** do dispositivo em **Dashboard › Sysadmin** mostra que há uma reinicialização pendente |
| **When Required** | O dispositivo reinicia imediatamente se o Windows informar que precisa                                                                   |
| **Always**        | O dispositivo reinicia imediatamente, ao final de toda execução de instalação                                                            |

A reinicialização não espera pelo usuário conectado. Para reiniciar em um horário de sua escolha, mantenha **Never** e use **Reboot › Later** no menu de ações do dispositivo.

## Como verificar se funcionou

1. Depois de uma varredura, recarregue a aba com o ícone de recarregar. Novas atualizações aparecem e, em **Devices › Windows Updates**, o **Last scan** do dispositivo mostra o horário da sua solicitação.
2. Depois de uma execução de instalação, recarregue a aba. As atualizações instaladas mostram **Installed**, com uma data em **Installed On**.
3. Em **Dashboard › Sysadmin**, a coluna **Patches Pending** do dispositivo fica vazia quando não resta nenhuma atualização aprovada a instalar, e **Needs Reboot** mostra se o Windows está aguardando uma reinicialização.
4. Quando **Agent Debug Level** está em **Info** em **Admin Center › Settings › General**, a aba **Debug** do dispositivo registra `<hostname> is rebooting after updates were installed.` quando a política o reinicia.

## Erros comuns

| Sintoma                                                                   | Causa                                                                     | Correção                                                                                                                                                                           |
| ------------------------------------------------------------------------- | ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Botões esmaecidos, *This machine must be online to run actions*           | O dispositivo está offline ou em atraso                                   | Aguarde até que ele esteja online. O status vem do último carregamento da lista de dispositivos; recarregue-a se o dispositivo acabou de voltar                                    |
| Botões esmaecidos, *You don't have permission for this action*            | O papel não tem **Manage Windows Updates**                                | Adicione a permissão em **Admin Center › Roles**                                                                                                                                   |
| **Only supported for Windows Devices**                                    | O dispositivo roda Linux ou macOS                                         | A gestão de atualizações abrange dispositivos Windows                                                                                                                              |
| `Not available for linux` (ou `darwin`)                                   | Uma varredura de atualizações foi enviada a um dispositivo Linux ou macOS | Comportamento esperado                                                                                                                                                             |
| A lista não muda depois de uma varredura                                  | A varredura ainda está em andamento, ou você recarregou cedo demais       | Uma varredura pode levar vários minutos. Clique de novo no ícone de recarregar                                                                                                     |
| **Install Approved Updates** está esmaecido, sem mensagem                 | A lista está vazia                                                        | Faça uma varredura antes                                                                                                                                                           |
| Uma atualização ignorada voltou como **Approve**                          | A política de atualizações aprova automaticamente a severidade dela       | Defina essa severidade como **Manual** na política de atualizações do dispositivo e aprove as outras à mão                                                                         |
| Uma atualização continua **Pending** depois de uma execução de instalação | A instalação falhou no dispositivo                                        | Confira a atualização em **Devices › Windows Updates**, onde as instalações com falha são contadas. Execute a instalação de novo, ou instale-a no dispositivo e faça uma varredura |

## Referência de campos

**Barra de ferramentas**

| Elemento                     | O que faz                                                                                                                                    |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| Ícone de recarregar          | Recarrega a lista a partir do servidor. Não consulta o dispositivo                                                                           |
| **Run Update Scan**          | Pede ao agente uma varredura de atualizações. Exige um dispositivo online                                                                    |
| **Install Approved Updates** | Aplica a aprovação automática da política e depois instala todas as atualizações aprovadas ainda não instaladas. Exige um dispositivo online |
| **Search...**                | Filtra as linhas                                                                                                                             |
| Botão de exportação          | Baixa a lista em CSV                                                                                                                         |

**Colunas**

| Coluna             | O que mostra                                                                                                                                                                             |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Selo de aprovação  | **Do Nothing** (padrão para atualizações novas), **Approve**, **Ignore** ou **Inherit**                                                                                                  |
| Selo de instalação | **Installed**, **Pending**, **Ignored** ou **Missing**                                                                                                                                   |
| **Severity**       | A severidade atribuída pela Microsoft: Critical, Important, Moderate ou Low. **Other** quando a Microsoft não atribui nenhuma, como na maioria das atualizações que não são de segurança |
| **Name**           | O título da atualização                                                                                                                                                                  |
| **KB**             | O número do artigo da Knowledge Base, ou `-`                                                                                                                                             |
| **More Info**      | O início da descrição. Clique para ver os detalhes completos                                                                                                                             |
| **Installed On**   | Quando a execução de instalação a instalou, ou `-`                                                                                                                                       |

**Menu do clique com o botão direito**

| Opção          | Efeito                                                                                                                                                                                               |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Approve**    | A próxima execução de instalação a instala, seja ela manual, pela tela do parque ou agendada                                                                                                         |
| **Ignore**     | As execuções de instalação a deixam de fora enquanto ela continuar ignorada. Se a política aprova automaticamente a severidade dela, a próxima aprovação automática a marca como **Approve** de novo |
| **Do Nothing** | Não aprovada. Só é instalada depois de aprovada, à mão ou pela política                                                                                                                              |
| **Inherit**    | Deixa a decisão para a política de atualizações, como **Do Nothing**                                                                                                                                 |

## Páginas relacionadas

* [Automatizar as atualizações do Windows](https://wiki.datadike.com/pt/sonar/administration/patching/automate-windows-updates.md)
* [Windows Updates em todo o parque](https://wiki.datadike.com/pt/sonar/administration/patching/windows-updates.md)
* [Política de aprovação de atualizações](https://wiki.datadike.com/pt/sonar/administration/patching/patch-policy.md)
* [Detalhes do dispositivo](https://wiki.datadike.com/pt/sonar/administration/devices/device-details.md)
* [A lista de dispositivos](https://wiki.datadike.com/pt/sonar/administration/devices/device-list.md)
