> 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/automation/bulk-actions.md).

# Executar ações em muitos dispositivos

Envie um comando, um script ou uma ação de atualização a todos os dispositivos de um cliente, de um site, de uma lista escolhida ou de todo o seu escopo, filtrando por sistema operacional e tipo.

## O que é e quando usar

As três ferramentas em massa do menu **Tools** enviam a mesma ação a muitos dispositivos em uma só etapa:

| Ferramenta                        | Título da caixa de diálogo | O que envia                                                                                                   |
| --------------------------------- | -------------------------- | ------------------------------------------------------------------------------------------------------------- |
| **Tools › Bulk Command**          | **Run Bulk Command**       | Uma linha de comando                                                                                          |
| **Tools › Bulk Script**           | **Run Bulk Script**        | Um script da [biblioteca de scripts](https://wiki.datadike.com/pt/sonar/administration/automation/scripts.md) |
| **Tools › Bulk Patch Management** | **Bulk Patch Management**  | Uma verificação do Windows Update, ou a instalação das atualizações aprovadas                                 |

Use-as para trabalhos pontuais em todo o parque: coletar um valor de todas as estações de trabalho de um cliente, aplicar uma correção a um site ou forçar uma verificação de atualizações antes de uma janela de manutenção. Para trabalhos que precisam se repetir, use as [tarefas automatizadas](https://wiki.datadike.com/pt/sonar/administration/automation/automated-tasks.md).

## Antes de começar

* Um papel com **Run Bulk Operations** (grupo **System** de **Admin Center › Roles**), mais a permissão da própria ação: **Send Command** para **Bulk Command**, **Run Scripts** para **Bulk Script**, **Manage Windows Updates** para **Bulk Patch Management**. Sem as duas, o item de menu e o botão **Run** ficam desativados.
* O alvo só inclui os dispositivos que o seu papel pode ver. Um cliente ou um site fora do seu escopo é recusado.
* Para **Bulk Script**, o script precisa existir em **Management › Scripts**.
* Os dispositivos precisam estar online quando você clica em **Run**. A ação é enviada uma única vez, naquele momento. Um dispositivo offline não a recebe e não a executa mais tarde, quando se reconecta.

## Passos

1. Abra o menu **Tools** no cabeçalho (ícone de engrenagem) e escolha **Bulk Command**, **Bulk Script** ou **Bulk Patch Management**. A caixa de diálogo abre como um painel à direita.
2. Em **Choose Target**, escolha **Client**, **Site**, **Selected Agents** ou **All**.
3. Escolha o cliente em **Select Client**, o site em **Select Site** ou os dispositivos em **Select Agents**. **All** não exige seleção: significa todos os dispositivos que o seu papel pode ver.
4. Em **Agent OS**, escolha a plataforma. **Bulk Command** oferece **Windows**, **Linux** e **macOS**; **Bulk Script** também oferece **All**; **Bulk Patch Management** é só para Windows.
5. Em **Agent Type**, escolha **All**, **Servers** ou **Workstations**. Esse filtro não aparece para **Selected Agents**.
6. Preencha a ação:
   * **Bulk Command**: escolha o **Shell** (**CMD** ou **Powershell** para Windows, **Bash** ou **Custom** para Linux e macOS) e digite o comando em **Command**.
   * **Bulk Script**: escolha o script em **Select Script** e depois revise **Script Arguments** e **Environment vars**, preenchidos com os valores padrão do script. Marque **Save results to Custom Field** (e escolha o campo em **Select custom field**) ou **Save results to Agent Note** se a saída precisar ficar guardada em cada dispositivo.
   * **Bulk Patch Management**: escolha **Scan** ou **Install** em **Action**.
7. Para comandos e scripts no Windows, marque **Run As User** em **Privileged Execution** se a ação precisar ser executada como o usuário conectado.
8. Confira **Timeout (seconds)** para comandos e scripts.
9. Clique em **Run**.

O botão **Bulk Actions** de **Devices › Windows Updates** abre a mesma caixa de diálogo **Bulk Patch Management**.

## O que você deve ver

O painel fecha e uma confirmação informa quantos dispositivos foram selecionados pelo alvo e pelos filtros:

* `Command will now be run on <n> agents. Check the History tab on the agent to view the results.`
* `<script> will now be run on <n> agents. Check the History tab on the agent to view the results.`
* `Patch status scan will now run on <n> agents`
* `Pending updates will now be installed on <n> agents`

O número é a quantidade de dispositivos encontrados no momento em que você clicou em **Run**, online ou não. Cada dispositivo executa a ação por conta própria e retorna o resultado quando termina.

## Como verificar se funcionou

1. Abra **Reports & Audits › Audits**. A execução é registrada como **Bulk Action**, com uma mensagem como `<user> executed bulk command on all agents within client: CLIENT-A` ou `<user> executed bulk script: <script> on multiple agents`. Os detalhes registrados incluem a requisição completa e, para **Selected Agents**, os nomes dos dispositivos.
2. Para comandos e scripts, abra alguns dispositivos do alvo e a aba **HISTORY** de cada um. Cada dispositivo tem uma linha **Cmd Run** ou **Script Run** para a execução, com a saída em **Output** assim que o dispositivo retornar. Há uma linha por dispositivo; os resultados são lidos dispositivo por dispositivo.
3. Para **Save results to Custom Field** ou **Save results to Agent Note**, confira o campo personalizado ou a aba **NOTES** de um dispositivo do alvo.
4. Para ações de atualização, abra a aba **UPDATES** do dispositivo ou **Devices › Windows Updates** depois que os dispositivos retornarem os resultados da verificação ou da instalação.

Uma linha de **History** que continua em `No output is available yet` pertence a um dispositivo que não executou a ação, normalmente porque estava offline. Execute a ação de novo para esse dispositivo quando ele estiver online.

## Erros comuns

| Sintoma                                                                                         | Causa                                                                                                 | Correção                                                                                        |
| ----------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| O item de **Tools** ou **Run** está desativado, com `You don't have permission for this action` | O papel não tem **Run Bulk Operations** ou a permissão da própria ação                                | Adicione as duas permissões ao papel                                                            |
| `Must select at least 1 agent`                                                                  | **Selected Agents** com a lista vazia                                                                 | Escolha pelo menos um dispositivo                                                               |
| `No agents were found meeting the selected criteria`                                            | O alvo e os filtros **Agent OS** / **Agent Type** não correspondem a nenhum dispositivo do seu escopo | Amplie os filtros, ou confira se o cliente ou o site tem dispositivos dessa plataforma          |
| Um erro de permissão ao escolher um cliente ou um site                                          | O cliente ou o site está fora do escopo do seu papel                                                  | Escolha um alvo que o seu papel cubra                                                           |
| Alguns dispositivos nunca mostram resultado                                                     | Eles estavam offline quando a ação foi enviada                                                        | Execute-a de novo para esses dispositivos quando estiverem online                               |
| Um script não aparece em **Select Script**                                                      | Ele não suporta o **Agent OS** escolhido, ou está oculto                                              | Mude **Agent OS** para a plataforma do script ou para **All**, ou mostre o script na biblioteca |

## Referência de campos

| Campo                                       | Ferramenta      | O que faz                                                                                                                                                                                                                                                   | Valores aceitos                                                                                        | Padrão                             |
| ------------------------------------------- | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | ---------------------------------- |
| Choose Target                               | Todas           | Para quais dispositivos a ação é enviada                                                                                                                                                                                                                    | **Client**, **Site**, **Selected Agents**, **All**                                                     | **Client**                         |
| Select Client / Select Site / Select Agents | Todas           | O cliente, o site ou os dispositivos do alvo                                                                                                                                                                                                                | Itens do seu escopo                                                                                    | Nenhum. Obrigatório para esse alvo |
| Agent OS                                    | Todas           | Mantém só os dispositivos dessa plataforma                                                                                                                                                                                                                  | Comando: **Windows**, **Linux**, **macOS**. Script: os mesmos, mais **All**. Atualizações: **Windows** | **Windows**                        |
| Agent Type                                  | Todas           | Mantém só os servidores ou só as estações de trabalho. Oculto para **Selected Agents**                                                                                                                                                                      | **All**, **Servers**, **Workstations**                                                                 | **All**                            |
| Shell                                       | Comando         | Interpretador                                                                                                                                                                                                                                               | Windows: **CMD**, **Powershell**. Linux e macOS: **Bash**, **Custom**                                  | **CMD** ou **Bash**                |
| Custom shell                                | Comando         | Caminho do interpretador para **Custom**                                                                                                                                                                                                                    | Caminho absoluto, por exemplo `/usr/bin/python3`                                                       | Vazio                              |
| Command                                     | Comando         | A linha de comando                                                                                                                                                                                                                                          | Texto                                                                                                  | Vazio                              |
| Select Script                               | Script          | O script da biblioteca                                                                                                                                                                                                                                      | Scripts que suportam a plataforma escolhida                                                            | Nenhum                             |
| Script Arguments                            | Script          | Argumentos para todos os dispositivos. As variáveis são resolvidas por dispositivo                                                                                                                                                                          | Texto, com [variáveis de script](https://wiki.datadike.com/pt/sonar/reference/script-variables.md)     | Os padrões do script               |
| Environment vars                            | Script          | Variáveis de ambiente, no formato `KEY=VALUE`                                                                                                                                                                                                               | Texto, com variáveis de script                                                                         | Os padrões do script               |
| Save results to Custom Field                | Script          | Grava a última linha da saída de cada dispositivo em um campo personalizado, ou a saída inteira com **Save all output**                                                                                                                                     | Ligado ou desligado, mais um campo personalizado de dispositivo, de site ou de cliente                 | Desligado                          |
| Save results to Agent Note                  | Script          | Salva a saída de cada dispositivo como uma nota nesse dispositivo                                                                                                                                                                                           | Ligado ou desligado                                                                                    | Desligado                          |
| Run As User                                 | Comando, Script | Só no Windows. Executa como o usuário conectado; se não houver nenhum, executa como SYSTEM                                                                                                                                                                  | Ligado ou desligado                                                                                    | Desligado                          |
| Timeout (seconds)                           | Comando, Script | Tempo máximo de execução em cada dispositivo                                                                                                                                                                                                                | Número inteiro de segundos                                                                             | 30, ou o padrão do script          |
| Action                                      | Atualizações    | **Scan** pede a cada dispositivo o status das atualizações. **Install** aprova as atualizações de acordo com a [política de atualizações](https://wiki.datadike.com/pt/sonar/administration/patching/patch-policy.md) do dispositivo e instala as aprovadas | **Scan**, **Install**                                                                                  | **Scan**                           |

## Páginas relacionadas

* [Executar um comando ou um script em um dispositivo](https://wiki.datadike.com/pt/sonar/administration/automation/run-commands-and-scripts.md)
* [Biblioteca de scripts](https://wiki.datadike.com/pt/sonar/administration/automation/scripts.md)
* [Windows Updates em todo o parque](https://wiki.datadike.com/pt/sonar/administration/patching/windows-updates.md)
* [Variáveis de script](https://wiki.datadike.com/pt/sonar/reference/script-variables.md)
* [Trilha de auditoria](https://wiki.datadike.com/pt/sonar/administration/audit/audit-trail.md)
