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

# Ejecutar acciones en muchos dispositivos

Envíe un comando, un script o una acción de actualización a todos los dispositivos de un cliente, un sitio, una lista elegida o todo su alcance, filtrando por sistema operativo y tipo.

## Qué es y cuándo usarlo

Las tres herramientas masivas del menú **Tools** envían la misma acción a muchos dispositivos en un solo paso:

| Herramienta                       | Título del cuadro de diálogo | Qué envía                                                                               |
| --------------------------------- | ---------------------------- | --------------------------------------------------------------------------------------- |
| **Tools › Bulk Command**          | **Run Bulk Command**         | Una línea de comandos                                                                   |
| **Tools › Bulk Script**           | **Run Bulk Script**          | Un script de la [biblioteca de scripts](/es/sonar/administration/automation/scripts.md) |
| **Tools › Bulk Patch Management** | **Bulk Patch Management**    | Un análisis de Windows Update, o la instalación de las actualizaciones aprobadas        |

Úselas para trabajos puntuales en todo el parque: recoger un valor de todas las estaciones de trabajo de un cliente, aplicar una corrección a un sitio o forzar un análisis de actualizaciones antes de una ventana de mantenimiento. Para el trabajo que debe repetirse, use en su lugar las [tareas automatizadas](/es/sonar/administration/automation/automated-tasks.md).

## Antes de empezar

* Un rol con **Run Bulk Operations** (grupo **System** de **Admin Center › Roles**), más el permiso de la propia acción: **Send Command** para **Bulk Command**, **Run Scripts** para **Bulk Script**, **Manage Windows Updates** para **Bulk Patch Management**. Sin ambos, la entrada del menú y el botón **Run** siguen desactivados.
* El destino solo incluye dispositivos que su rol puede ver. Un cliente o un sitio fuera de su alcance se rechaza.
* Para **Bulk Script**, el script debe existir en **Management › Scripts**.
* Los dispositivos deben estar en línea cuando hace clic en **Run**. La acción se envía una sola vez, en ese momento. Un dispositivo fuera de línea no la recibe y no la ejecuta más tarde, cuando se vuelve a conectar.

## Pasos

1. Abra el menú **Tools** en el encabezado (icono de engranaje) y elija **Bulk Command**, **Bulk Script** o **Bulk Patch Management**. El cuadro de diálogo se abre como un panel a la derecha.
2. En **Choose Target**, elija **Client**, **Site**, **Selected Agents** o **All**.
3. Elija el cliente en **Select Client**, el sitio en **Select Site** o los dispositivos en **Select Agents**. **All** no necesita selección: significa todos los dispositivos que su rol puede ver.
4. En **Agent OS**, elija la plataforma. **Bulk Command** ofrece **Windows**, **Linux** y **macOS**; **Bulk Script** ofrece además **All**; **Bulk Patch Management** es solo para Windows.
5. En **Agent Type**, elija **All**, **Servers** o **Workstations**. Este filtro no se muestra para **Selected Agents**.
6. Rellene la acción:
   * **Bulk Command**: elija el **Shell** (**CMD** o **Powershell** para Windows, **Bash** o **Custom** para Linux y macOS) y escriba el comando en **Command**.
   * **Bulk Script**: elija el script en **Select Script** y luego revise **Script Arguments** y **Environment vars**, rellenados con los valores predeterminados del script. Marque **Save results to Custom Field** (y elija el campo en **Select custom field**) o **Save results to Agent Note** si la salida debe conservarse en cada dispositivo.
   * **Bulk Patch Management**: elija **Scan** o **Install** en **Action**.
7. Para comandos y scripts en Windows, marque **Run As User** en **Privileged Execution** si la acción debe ejecutarse como el usuario que ha iniciado sesión.
8. Compruebe **Timeout (seconds)** para los comandos y los scripts.
9. Haga clic en **Run**.

El botón **Bulk Actions** de **Devices › Windows Updates** abre el mismo cuadro de diálogo **Bulk Patch Management**.

## Qué debe ver

El panel se cierra y una confirmación indica cuántos dispositivos seleccionaron el destino y los 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`

El número es la cantidad de dispositivos que coincidían cuando hizo clic en **Run**, en línea o no. Cada dispositivo ejecuta la acción por su cuenta e informa cuando termina.

## Cómo verificar que funcionó

1. Abra **Reports & Audits › Audits**. La ejecución se registra como **Bulk Action** con un mensaje como `<user> executed bulk command on all agents within client: CLIENT-A` o `<user> executed bulk script: <script> on multiple agents`. Los detalles registrados incluyen la solicitud completa y, para **Selected Agents**, los nombres de los dispositivos.
2. Para comandos y scripts, abra algunos dispositivos de destino y su pestaña **HISTORY**. Cada dispositivo tiene una línea **Cmd Run** o **Script Run** para la ejecución, con la salida detrás de **Output** en cuanto el dispositivo ha informado. Hay una línea por dispositivo; los resultados se leen dispositivo por dispositivo.
3. Para **Save results to Custom Field** o **Save results to Agent Note**, compruebe el campo personalizado o la pestaña **NOTES** de un dispositivo de destino.
4. Para las acciones de actualización, abra la pestaña **UPDATES** del dispositivo o **Devices › Windows Updates** después de que los dispositivos informen los resultados del análisis o de la instalación.

Una línea de **History** que se queda en `No output is available yet` corresponde a un dispositivo que no ejecutó la acción, normalmente porque estaba fuera de línea. Vuelva a ejecutar la acción para ese dispositivo cuando esté en línea.

## Errores comunes

| Síntoma                                                                                            | Causa                                                                                                    | Solución                                                                                         |
| -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| La entrada de **Tools** o **Run** está desactivada con `You don't have permission for this action` | El rol no tiene **Run Bulk Operations** o el permiso propio de la acción                                 | Añada ambos permisos al rol                                                                      |
| `Must select at least 1 agent`                                                                     | **Selected Agents** con la lista vacía                                                                   | Elija al menos un dispositivo                                                                    |
| `No agents were found meeting the selected criteria`                                               | El destino y los filtros **Agent OS** / **Agent Type** no coinciden con ningún dispositivo de su alcance | Amplíe los filtros, o compruebe que el cliente o el sitio tiene dispositivos de esa plataforma   |
| Un error de permisos al elegir un cliente o un sitio                                               | El cliente o el sitio está fuera del alcance de su rol                                                   | Elija un destino que su rol cubra                                                                |
| Algunos dispositivos nunca muestran un resultado                                                   | Estaban fuera de línea cuando se envió la acción                                                         | Vuelva a ejecutarla para esos dispositivos cuando estén en línea                                 |
| Falta un script en **Select Script**                                                               | No es compatible con el **Agent OS** elegido, o está oculto                                              | Cambie **Agent OS** a la plataforma del script o a **All**, o muestre el script en la biblioteca |

## Referencia de campos

| Campo                                       | Herramienta     | Qué hace                                                                                                                                                                                                                                     | Valores aceptados                                                                                        | Predeterminado                           |
| ------------------------------------------- | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | ---------------------------------------- |
| Choose Target                               | Todas           | A qué dispositivos se envía la acción                                                                                                                                                                                                        | **Client**, **Site**, **Selected Agents**, **All**                                                       | **Client**                               |
| Select Client / Select Site / Select Agents | Todas           | El cliente, el sitio o los dispositivos del destino                                                                                                                                                                                          | Elementos de su alcance                                                                                  | Ninguno. Obligatorio para ese destino    |
| Agent OS                                    | Todas           | Conserva solo los dispositivos de esta plataforma                                                                                                                                                                                            | Comando: **Windows**, **Linux**, **macOS**. Script: los mismos más **All**. Actualizaciones: **Windows** | **Windows**                              |
| Agent Type                                  | Todas           | Conserva solo los servidores o solo las estaciones de trabajo. Oculto para **Selected Agents**                                                                                                                                               | **All**, **Servers**, **Workstations**                                                                   | **All**                                  |
| Shell                                       | Comando         | Intérprete                                                                                                                                                                                                                                   | Windows: **CMD**, **Powershell**. Linux y macOS: **Bash**, **Custom**                                    | **CMD** o **Bash**                       |
| Custom shell                                | Comando         | Ruta del intérprete para **Custom**                                                                                                                                                                                                          | Ruta absoluta, por ejemplo `/usr/bin/python3`                                                            | Vacío                                    |
| Command                                     | Comando         | La línea de comandos                                                                                                                                                                                                                         | Texto                                                                                                    | Vacío                                    |
| Select Script                               | Script          | El script de la biblioteca                                                                                                                                                                                                                   | Scripts compatibles con la plataforma elegida                                                            | Ninguno                                  |
| Script Arguments                            | Script          | Argumentos para todos los dispositivos. Las variables se resuelven por dispositivo                                                                                                                                                           | Texto, con [variables de script](/es/sonar/reference/script-variables.md)                                | Los valores predeterminados del script   |
| Environment vars                            | Script          | Variables de entorno, como `KEY=VALUE`                                                                                                                                                                                                       | Texto, con variables de script                                                                           | Los valores predeterminados del script   |
| Save results to Custom Field                | Script          | Escribe la última línea de la salida de cada dispositivo en un campo personalizado, o toda la salida con **Save all output**                                                                                                                 | Activado o desactivado, más un campo personalizado de dispositivo, de sitio o de cliente                 | Desactivado                              |
| Save results to Agent Note                  | Script          | Guarda la salida de cada dispositivo como una nota en ese dispositivo                                                                                                                                                                        | Activado o desactivado                                                                                   | Desactivado                              |
| Run As User                                 | Comando, Script | Solo Windows. Ejecuta como el usuario que ha iniciado sesión; si no hay ninguno, ejecuta como SYSTEM                                                                                                                                         | Activado o desactivado                                                                                   | Desactivado                              |
| Timeout (seconds)                           | Comando, Script | Tiempo máximo de ejecución en cada dispositivo                                                                                                                                                                                               | Número entero de segundos                                                                                | 30, o el valor predeterminado del script |
| Action                                      | Actualizaciones | **Scan** pide a cada dispositivo el estado de sus actualizaciones. **Install** aprueba las actualizaciones según la [política de actualizaciones](/es/sonar/administration/patching/patch-policy.md) del dispositivo e instala las aprobadas | **Scan**, **Install**                                                                                    | **Scan**                                 |

## Páginas relacionadas

* [Ejecutar un comando o un script en un dispositivo](/es/sonar/administration/automation/run-commands-and-scripts.md)
* [Biblioteca de scripts](/es/sonar/administration/automation/scripts.md)
* [Windows Updates en todo el parque](/es/sonar/administration/patching/windows-updates.md)
* [Variables de script](/es/sonar/reference/script-variables.md)
* [Registro de auditoría](/es/sonar/administration/audit/audit-trail.md)