> 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/automate-windows-updates.md).

# Automatizar as atualizações do Windows

O procedimento completo para manter os dispositivos Windows atualizados: faça a varredura, crie uma política de automação com política de atualizações, atribua-a e confirme a instalação.

## O que é e quando usar

Esta página percorre todo o caminho, de "quais atualizações estão faltando?" até "as atualizações aprovadas se instalam sozinhas, toda semana, na janela de manutenção". Ela reúne telas que são documentadas uma a uma em outras páginas: a varredura, a política de automação, a política de atualizações dela e a atribuição.

O caminho tem três etapas:

1. **Varredura**: cada dispositivo pergunta ao Windows Update quais atualizações se aplicam a ele e informa a lista ao SONAR.
2. **Aprovação e instalação**: uma atualização só é instalada depois de **aprovada**. A aprovação vem de uma política de atualizações, por severidade, ou de uma pessoa, atualização por atualização.
3. **Automação**: uma política de atualizações dentro de uma política de automação, atribuída a dispositivos, sites ou clientes, aprova por severidade e instala em um agendamento, com a regra de reinicialização que você escolher.

Há duas formas de instalar, e é fácil confundi-las:

| Forma           | Onde                                                                                                                                                             | O que instala                                                                                                                                                      |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Sob demanda** | **Tools › Bulk Patch Management** com **Install**, **Install approved** na tela **Devices › Windows Updates**, ou **Install Approved Updates** em um dispositivo | As atualizações já **aprovadas** em cada dispositivo de destino, imediatamente. A aprovação automática da política de atualizações do dispositivo é aplicada antes |
| **Agendada**    | Uma política de atualizações em uma política de automação                                                                                                        | As atualizações aprovadas, no **Scheduled Time** da política, nos dias que você escolher, com a regra de reinicialização da política                               |

Nenhuma das duas formas instala atualizações que ninguém aprovou. Um dispositivo sem política de atualizações e sem nenhuma atualização aprovada à mão não instala nada, mesmo quando recebe uma instalação em massa.

{% hint style="info" %}
Para o detalhe de cada tela, veja [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) e [Políticas de automação](https://wiki.datadike.com/pt/sonar/administration/automation/automation-policies.md). Esta página segue a ordem em que você as usa.
{% endhint %}

## Antes de começar

* O agente do SONAR instalado e fazendo contato nos dispositivos Windows. A gestão de atualizações não abrange dispositivos Linux e macOS.
* Em **Admin Center › Roles**:
  * **Manage Automation Policies**, para criar a política de automação e a política de atualizações dela;
  * **Run Bulk Operations** e **Manage Windows Updates**, para **Tools › Bulk Patch Management**;
  * **Edit Agent**, **Manage Clients** ou **Manage Sites**, para atribuir a política a um dispositivo, a um cliente ou a um site.
* O fuso horário dos dispositivos correto. As instalações agendadas rodam no horário do próprio dispositivo, obtido de **Timezone** no painel lateral **Edit** do dispositivo ou de **Default agent timezone** em **Admin Center › Settings › General**.
* Uma janela de manutenção combinada com quem usa os dispositivos, principalmente se a política os reinicia.

## Passos

### 1. Fazer a varredura dos dispositivos

É a varredura que preenche a lista de atualizações. Sem uma varredura recente, a lista não reflete o que realmente falta, e nada novo pode ser aprovado.

Escolha o escopo:

* **Um dispositivo**: abra o dispositivo em **Dashboard › Sysadmin**, aba **Updates**, e clique em **Run Update Scan**.
* **Um cliente, um site, um grupo de dispositivos**: abra **Tools › Bulk Patch Management**. Em **Choose Target**, escolha **Client**, **Site**, **Selected Agents** ou **All** e, depois, o cliente ou o site. Mantenha **Agent OS** em **Windows**, escolha o **Agent Type** (**All**, **Servers** ou **Workstations**), selecione **Scan** em **Action** e clique em **Run**.
* **Todos os dispositivos Windows que você pode acessar**: clique em **Scan now** em **Devices › Windows Updates**.

A solicitação é aceita na hora, e os resultados chegam à medida que cada dispositivo responde. Só os dispositivos online a recebem. O SONAR também pede uma varredura a todos os dispositivos Windows online a cada 8 horas; assim, um dispositivo que estava offline passa pela varredura no primeiro ciclo depois de voltar.

### 2. Criar a política de automação

A política de automação é o contêiner: um nome, um estado e os clientes, sites ou dispositivos que ela alcança.

1. Abra **Management › Automations**.
2. Clique em **New**. O formulário **Add Policy** é aberto.
3. Em **Policy Name**, use um nome que diga o que a política faz e para quem, por exemplo `Atualizações-Windows-servidores-sábado-3h`.
4. Em **Description**, registre as severidades aprovadas, os alvos e a janela, por exemplo `Critical e Important · servidores · sábado 3h`.
5. Ligue **Active**. Uma política inativa continua cadastrada, mas não é aplicada. Você também pode criá-la inativa e ligá-la depois de uma revisão.
6. Deixe **Enforced** desligado. **Enforced** só determina que os **checks** da política prevalecem sobre os checks do mesmo tipo nos dispositivos; não tem efeito sobre a política de atualizações.
7. Clique em **Submit**. A política aparece na lista.

### 3. Adicionar a política de atualizações

1. Na linha da nova política, clique em **Create Patch Policy** na coluna **Patch Policy**.
2. Em **Auto Approval**, escolha **Approve**, **Manual** ou **Ignore** para cada severidade: **Critical**, **Important**, **Moderate**, **Low** e **Other**. Uma política de atualizações nova começa com todas as severidades em **Ignore**.
3. Em **Installation Schedule**, escolha **Schedule Frequency**:
   * **Daily/Weekly** e, depois, marque os **Week Days**;
   * **Monthly** e, depois, o **Day of month to run**.
4. Escolha o **Scheduled Time**, no fuso horário do dispositivo.
5. Em **Reboot After Installation**, escolha **Reboot After Install**: **Never**, **When Required** ou **Always**.
6. Clique em **Submit**. A coluna passa a mostrar **Modify Patch Policy**; use essa opção para revisar ou alterar as configurações depois.

Um ponto de partida que muitas equipes usam, a ser adaptado ao seu próprio processo de mudanças:

| Severidade    | Auto Approval | Por quê                                                                    |
| ------------- | ------------- | -------------------------------------------------------------------------- |
| **Critical**  | **Approve**   | Correções de vulnerabilidades graves, a aplicar o quanto antes             |
| **Important** | **Approve**   | Correções relevantes de segurança e de estabilidade                        |
| **Moderate**  | **Manual**    | Avalie o impacto antes de aprovar                                          |
| **Low**       | **Manual**    | Risco baixo; aprove quando for conveniente                                 |
| **Other**     | **Manual**    | Na maioria, atualizações que não são de segurança; revise o conteúdo antes |

{% hint style="warning" %}
**Uma política de atualizações deixada nos valores padrão não instala nada.** Todas as severidades começam em **Ignore**, e uma execução agendada só acontece quando ao menos uma severidade está em **Approve**. Defina ao menos uma antes de atribuir a política.
{% endhint %}

{% hint style="warning" %}
**A reinicialização acontece sem aviso à pessoa que usa o dispositivo.** Com **When Required** ou **Always**, o dispositivo reinicia assim que a instalação termina, haja ou não alguém trabalhando nele, e o trabalho não salvo é perdido. Na dúvida sobre se um dispositivo pode reiniciar (em particular, servidores de produção), mantenha **Never** e reinicie-o em um horário de sua escolha. **Needs Reboot** em **Dashboard › Sysadmin** mostra quais dispositivos estão aguardando uma reinicialização.
{% endhint %}

### 4. Atribuir a política

Comece por um piloto: um dispositivo de teste ou um site, antes do cliente inteiro.

* **A um dispositivo**: em **Dashboard › Sysadmin**, clique com o botão direito na linha do dispositivo, ou use o menu **Other actions** do painel do dispositivo, escolha **Assign Automation Policy** e selecione a política.
* **A um cliente ou a um site**: na árvore **Clients** de **Dashboard › Sysadmin**, clique com o botão direito no cliente ou no site e escolha **Assign Automation Policy**. Selecione a política em **Server Policy**, em **Workstation Policy** ou nos dois, e clique em **Submit**.

{% hint style="info" %}
A política de um cliente ou de um site é definida separadamente para servidores e estações de trabalho. Se o cliente ou o site tem os dois tipos, preencha **Server Policy** e **Workstation Policy**; caso contrário, um dos dois tipos fica de fora.
{% endhint %}

Para deixar clientes, sites ou dispositivos específicos fora de uma política que os alcança, use **Show Policy Exclusions (N)** na linha da política. Veja [Políticas de automação](https://wiki.datadike.com/pt/sonar/administration/automation/automation-policies.md).

### 5. Instalar o que já está pendente, se necessário

A política instala no próximo horário agendado. Para zerar o que já está acumulado antes disso, envie uma instalação sob demanda: **Tools › Bulk Patch Management** com **Install** em **Action**, **Install approved** em **Devices › Windows Updates**, ou **Install Approved Updates** em um dispositivo.

Todas elas aplicam primeiro a aprovação automática da política de atualizações do dispositivo e depois instalam todas as atualizações aprovadas no dispositivo. Para instalar uma única atualização, ela precisa ser a única aprovada nos dispositivos de destino: nenhuma outra aprovada à mão e nenhuma severidade em **Approve** na política de atualizações deles.

## O que você deve ver

* Em **Management › Automations**, a linha da política com **Active** ligado, **Modify Patch Policy** na coluna **Patch Policy** e **Show Relations (N)** contando os dispositivos que a recebem.
* Depois do próximo ciclo de aprovação de 8 horas, as atualizações das severidades em **Approve** aparecem como aprovadas na aba **Updates** de cada dispositivo.
* Depois do horário agendado, essas atualizações passam a **Installed**, com a data da instalação em **Installed On** no dispositivo e em **Installed at** no painel lateral da máquina em **Devices › Windows Updates**.

## Como verificar se funcionou

1. Em **Management › Automations**, clique em **Show Relations (N)** na linha da política e confirme que os clientes, sites e dispositivos listados são os que você pretendia.
2. Em um dispositivo de destino, abra **Edit**, aba **Automation Policies**. **Effective Patch Policy** mostra a aprovação por severidade, a frequência e a regra de reinicialização que realmente valem para esse dispositivo. Se não forem as da política, uma política anterior na ordem, ou uma configuração do próprio dispositivo, está prevalecendo: veja [Política de aprovação de atualizações](https://wiki.datadike.com/pt/sonar/administration/patching/patch-policy.md).
3. Depois da primeira execução agendada, abra **Devices › Windows Updates**: os contadores **Installed** e **Failed installs** mudam, e, no painel lateral da máquina, as atualizações instaladas pelo SONAR têm uma data em **Installed at**. A data só é registrada nas instalações que o SONAR executou: uma atualização instalada por outro meio aparece como instalada, sem data.
4. **Reports & Audits › Audits** registra a criação da política, da política de atualizações dela e de cada atribuição.

## Erros comuns

| Sintoma                                             | Causa                                                                                                                                               | Correção                                                                     |
| --------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
| Nada é instalado no horário agendado                | Nenhuma severidade está em **Approve** na política efetiva                                                                                          | Coloque ao menos uma severidade em **Approve**                               |
| Nada é instalado em um agendamento **Daily/Weekly** | Nenhum dia marcado em **Week Days**                                                                                                                 | Marque os dias                                                               |
| Alguns dispositivos do site não são abrangidos      | Só **Server Policy** ou só **Workstation Policy** foi preenchido                                                                                    | Preencha os dois campos no cliente ou no site                                |
| Um dispositivo mantém o próprio comportamento       | Uma política anterior na ordem tem uma política de atualizações, ou as configurações de atualização do próprio dispositivo não estão em **Inherit** | Confira **Effective Patch Policy** no painel lateral **Edit** do dispositivo |
| A lista de atualizações parece desatualizada        | O dispositivo não fez nenhuma varredura desde que as últimas atualizações foram lançadas                                                            | Faça uma varredura, ou aguarde o próximo ciclo de 8 horas                    |
| Uma instalação sob demanda não fez nada             | Nenhuma atualização está aprovada no dispositivo, e a política de atualizações dele não aprova nada                                                 | Aprove as atualizações, ou coloque as severidades em **Approve**             |
| Um dispositivo reiniciou no horário de trabalho     | **Reboot After Install** está em **When Required** ou **Always**, e a instalação rodou no horário de trabalho                                       | Mude o **Scheduled Time**, ou use **Never**                                  |
| A instalação rodou em um horário inesperado         | O fuso horário do dispositivo não é o que você supunha                                                                                              | Confira **Timezone** no dispositivo ou **Default agent timezone**            |

## Referência de campos

**Tools › Bulk Patch Management**

| Campo                                                   | O que faz                                             | Valores                                                                           |
| ------------------------------------------------------- | ----------------------------------------------------- | --------------------------------------------------------------------------------- |
| **Choose Target**                                       | Quais dispositivos recebem a ação                     | **Client**, **Site**, **Selected Agents**, **All**                                |
| **Select Client** / **Select Site** / **Select Agents** | O cliente, o site ou os dispositivos, conforme o alvo | Os que você pode acessar                                                          |
| **Agent OS**                                            | Sistema operacional dos alvos                         | **Windows**                                                                       |
| **Agent Type**                                          | Tipo de dispositivo                                   | **All**, **Servers**, **Workstations**                                            |
| **Action**                                              | O que fazer                                           | **Scan** (apenas renova a lista), **Install** (instala as atualizações aprovadas) |

**Add Policy** (política de automação)

| Campo           | O que faz                                                                  | Recomendação                                       |
| --------------- | -------------------------------------------------------------------------- | -------------------------------------------------- |
| **Policy Name** | Nome exibido na lista e quando você atribui a política                     | Ação e escopo, sem ambiguidade                     |
| **Description** | Texto livre                                                                | Severidades, alvos e janela                        |
| **Active**      | Aplica a política                                                          | Ligado                                             |
| **Enforced**    | Os checks da política prevalecem sobre os checks dos próprios dispositivos | Desligado, em uma política dedicada a atualizações |

Para todos os campos de **Add Patch Policy**, veja [Política de aprovação de atualizações](https://wiki.datadike.com/pt/sonar/administration/patching/patch-policy.md#referencia-de-campos).

## Páginas relacionadas

* [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)
* [Atualizações em um único dispositivo](https://wiki.datadike.com/pt/sonar/administration/patching/device-updates.md)
* [Políticas de automação](https://wiki.datadike.com/pt/sonar/administration/automation/automation-policies.md)
* [Executar ações em muitos dispositivos](https://wiki.datadike.com/pt/sonar/administration/automation/bulk-actions.md)
