[comment]: # ({bfcc3bc2-1c6301ba})
# 4 Atualização em massa

[comment]: # ({/bfcc3bc2-1c6301ba})

[comment]: # ({7205743f-7205743f})
#### Visão geral

Às vezes, você pode querer alterar algum atributo para vários hosts de uma só vez. Em vez de abrir cada host individualmente para edição, você pode usar a função de atualização em massa para isso.

[comment]: # ({/7205743f-7205743f})

[comment]: # ({38c5e944-929367ac})
#### Usando atualização em massa

Para atualizar vários hosts em massa, faça o seguinte:

-   Marque as caixas de seleção antes dos hosts que você deseja atualizar na [lista de hosts](/manual/web_interface/frontend_sections/data_collection/hosts)
-   Clique em *Atualização em massa* abaixo da lista
-   Navegue até a aba com os atributos necessários (*Host*, *IPMI*,
    *Tags*, *Macros*, *Inventory*, *Encryption* ou *Value mapping*)
-   Marque as caixas de seleção de qualquer atributo que deseja atualizar e insira um novo valor
    para eles

![](../../../../assets/en/manual/config/hosts/host_mass.png){width="600"}

As seguintes opções estão disponíveis ao selecionar o respectivo botão
para atualização de vínculo de **template**:

-   *Link* - especifique quais templates adicionais vincular
-   *Replace* - especifique quais templates vincular ao mesmo tempo em que desvincula qualquer
    template que já estava vinculado aos hosts anteriormente
-   *Unlink* - especifique quais templates desvincular

Para especificar os templates a vincular/desvincular, comece a digitar o nome do template
no campo de preenchimento automático até que apareça uma lista suspensa com os
templates correspondentes. Basta rolar para baixo para selecionar o template necessário.

A opção *Clear when unlinking* permitirá não apenas desvincular quaisquer
templates vinculados anteriormente, mas também remover todos os elementos herdados deles
(items, triggers, etc.).

As seguintes opções estão disponíveis ao selecionar o respectivo botão
para atualização de **host group**:

-   *Add* - permite especificar host groups adicionais a partir dos existentes
    ou inserir host groups totalmente novos para os hosts
-   *Replace* - removerá o host de quaisquer host groups existentes e
    os substituirá pelo(s) especificado(s) neste campo (host groups existentes ou
    novos)
-   *Remove* - removerá host groups específicos dos hosts

Esses campos têm preenchimento automático - ao começar a digitar, é exibida uma
lista suspensa com host groups correspondentes. Se o host group for novo, ele também
aparece na lista suspensa e é indicado por *(new)* após a string.
Basta rolar para baixo para selecionar.

![](../../../../assets/en/manual/config/hosts/host_mass_c.png)

![](../../../../assets/en/manual/config/hosts/host_mass_d.png)

As seguintes opções estão disponíveis ao selecionar o respectivo botão
para atualização de tags:

-   *Add* - permite adicionar novas tags aos hosts;
-   *Replace* - removerá quaisquer tags existentes do host e
    as substituirá pela(s) especificada(s) abaixo;
-   *Remove* - removerá as tags especificadas dos hosts.

Macros de usuário, macros {INVENTORY.\*}, {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} e {HOST.ID} são suportadas em [tags](/manual/config/tagging).
Observe que tags com o mesmo nome, mas valores diferentes, não são consideradas "duplicadas" e podem ser adicionadas ao mesmo host.

![](../../../../assets/en/manual/config/hosts/host_mass_e.png)

As seguintes opções estão disponíveis ao selecionar o respectivo botão
para atualização de macros:

-   *Add* - permite especificar macros de usuário adicionais para os hosts. Se a caixa de seleção *Update existing* estiver marcada, o valor, o tipo e a descrição
    do nome de macro especificado serão atualizados. Se estiver desmarcada, se
    uma macro com esse nome já existir no(s) host(s), ela não será
    atualizada.
-   *Update* - substituirá valores, tipos e descrições das macros
    especificadas nesta lista. Se a caixa de seleção *Add missing* estiver marcada, a
    macro que não existia anteriormente em um host será adicionada como nova macro.
    Se estiver desmarcada, somente as macros que já existirem em um host serão
    atualizadas.
-   *Remove* - removerá as macros especificadas dos hosts. Se a caixa
    *Except selected* estiver marcada, todas as macros, exceto as especificadas na lista,
    serão removidas. Se estiver desmarcada, somente as macros especificadas na lista
    serão removidas.
-   *Remove all* - removerá todas as macros de usuário dos hosts. Se a caixa de seleção *I confirm to remove all macros* não estiver marcada, uma nova
    janela pop-up será aberta solicitando a confirmação da remoção de todas as macros.

![](../../../../assets/en/manual/config/hosts/host_mass_f.png)

Para poder atualizar campos de inventory em massa, o *Inventory mode* deve
estar definido como 'Manual' ou 'Automatic'.

![](../../../../assets/en/manual/config/hosts/host_mass_g.png)

![](../../../../assets/en/manual/config/hosts/host_mass_h.png)

Botões com as seguintes opções estão disponíveis para atualização de value map:

-   *Add* - adiciona value maps aos hosts. Se você marcar *Update existing*, todas as propriedades do value map com esse nome serão atualizadas.
    Caso contrário, se um value map com esse nome já existir, ele não será
    atualizado.
-   *Update* - atualiza value maps existentes. Se você marcar *Add missing*, um
    value map que não existia anteriormente em um host será adicionado como um novo value map.
    Caso contrário, somente os value maps que já existirem em um host serão
    atualizados.
-   *Rename* - atribui um novo nome a um value map existente
-   *Remove* - remove os value maps especificados dos hosts. Se você
    marcar *Except selected*, todos os value maps serão removidos **exceto**
    os especificados.
-   *Remove all* - remove todos os value maps dos hosts. Se a caixa de seleção *I confirm to remove all value maps* não estiver marcada, uma nova
    janela pop-up será aberta solicitando a confirmação da remoção.

Quando terminar de fazer todas as alterações necessárias, clique em *Update*. Os atributos
serão atualizados de acordo para todos os hosts selecionados.

[comment]: # ({/38c5e944-929367ac})
