[comment]: # ({8fbfa0cb-1c6301ba})
# 5 Atualização em massa

[comment]: # ({/8fbfa0cb-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]: # ({cca21625-929367ac})
#### Usando atualização em massa

Para atualizar em massa alguns hosts, faça o seguinte:

-   Marque as caixas de seleção antes dos hosts que você deseja atualizar na [lista de host](/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 vinculação de **template**:

-   *Link* - especifique quais templates adicionais vincular
-   *Replace* - especifique quais templates vincular ao mesmo tempo em que desvincula qualquer template que já estivesse vinculado aos hosts antes
-   *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é aparecer 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 neles, é exibida uma lista suspensa com host groups correspondentes. Se o host group for novo, ele também aparecerá na lista suspensa e será 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, caso uma macro com esse nome já exista 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, uma 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 em massa os campos de inventory, 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 já existir um value map com esse nome, 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 todas as alterações necessárias, clique em *Update*. Os atributos serão atualizados de acordo para todos os hosts selecionados.

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