> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Interfaz de línea de comandos del Iru Agent

> Usa la CLI del Iru Agent para comprobar el estado, desencadenar acciones y solucionar problemas en computadoras Mac desde Terminal.

<Callout icon="apple" color="#B84A7A" iconType="regular">Esta guía se aplica a computadoras Mac</Callout>

### Acerca de la CLI del Iru Agent

El Iru Agent ofrece un conjunto de potentes comandos de Terminal que brindan a los administradores control e información adicionales sobre su flota de dispositivos. Aunque algunos comandos solo se pueden ejecutar localmente en un dispositivo mediante Terminal, otros se pueden implementar mediante un Library Item Custom Script para obtener una mayor flexibilidad.

<Note>
  Desde el **8 de abril de 2026**, las aplicaciones se actualizaron de la marca **Kandji** <img className="inline dark:hidden" src="https://mintcdn.com/iru/20OhJ3wZmF4DKbOd/assets/media/images/kandji-bee-light-icon.png?fit=max&auto=format&n=20OhJ3wZmF4DKbOd&q=85&s=3ac73eb9098c090ac2838a4902a70e35" alt="" style={{ height: '1em', width: 'auto', maxHeight: '1em', verticalAlign: '-0.125em', margin: '0 0.05em' }} width="400" height="284" data-path="assets/media/images/kandji-bee-light-icon.png" /><img className="hidden dark:inline" src="https://mintcdn.com/iru/20OhJ3wZmF4DKbOd/assets/media/images/kandji-bee-dark-icon.png?fit=max&auto=format&n=20OhJ3wZmF4DKbOd&q=85&s=1d4b643c8e1903aabdb072fdf211f2de" alt="" style={{ height: '1em', width: 'auto', maxHeight: '1em', verticalAlign: '-0.125em', margin: '0 0.05em' }} width="400" height="284" data-path="assets/media/images/kandji-bee-dark-icon.png" /> a la marca **Iru** <img src="https://mintcdn.com/iru/8j4H0SpqtcKJ5JUM/assets/media/svgs/Iru-Logomark-OnLight-16-Dashboard.svg?fit=max&auto=format&n=8j4H0SpqtcKJ5JUM&q=85&s=befa6ce99e1df18d397deb65aec8edaf" alt="" style={{ display: 'inline', height: '1em', width: 'auto', maxHeight: '1em', verticalAlign: '-0.125em', margin: '0 -0.08em 0 0', padding: 0 }} width="14" height="15" data-path="assets/media/svgs/Iru-Logomark-OnLight-16-Dashboard.svg" />. El nombre de la aplicación **Agent** cambió de **Kandji Agent** a **Iru Agent**. Actualiza los **scripts, automatizaciones y utilidades** que aún hagan referencia a los nombres antiguos de las aplicaciones.
</Note>

### Comandos solo locales

Los siguientes comandos deben ejecutarse directamente en un dispositivo en Terminal. No se pueden implementar mediante un Library Item Custom Script ni Custom App.

#### Modo interactivo (TUI)

Ejecuta **`sudo iru`** **sin subcomando ni opciones** para abrir una **interfaz de usuario de terminal** (TUI): un flujo de pantalla completa basado en menús en Terminal para que puedas explorar y desencadenar acciones habituales del agente sin escribir comandos ni indicadores completos.

```bash Terminal icon="terminal" theme={null}
sudo iru
```

#### Run

El agente se ejecutará y realizará un check-in de inmediato. Normalmente, el agente realiza un check-in cada 15 minutos. Sin conexión a Internet, el agente se ejecutará en modo sin conexión.

```bash Terminal icon="terminal" theme={null}
sudo iru run
```

Agrega `--reset-daily` para forzar la ejecución del trabajo diario del agente aunque ya se haya ejecutado en las últimas 24 horas:

* **Blueprint Parameters:** los Parameters diarios se ejecutan aunque ya se hayan ejecutado en las últimas 24 horas.
* **Scripts personalizados**: también se ejecutan los Custom Scripts cuya frecuencia es diaria, no solo los scripts que se ejecutan en cada check-in o que se aplican de forma continua.
* **Inventario de aplicaciones:** recopila el inventario de aplicaciones (incluidos los comandos MDM) e ignora la programación de inventario de una vez al día.

```bash Terminal icon="terminal" theme={null}
sudo iru run --reset-daily
```

### Ejecutar la actualización diaria del inventario de MDM

El agente solicitará al servidor MDM que inicie sus comandos MDM diarios, como la validación de Apps & Books de Apple Business o Apple School Manager, así como la consulta de cierta información del dispositivo.

```bash Terminal icon="terminal" theme={null}
sudo iru update-mdm
```

### Recopilar aplicaciones

Recopila el inventario completo de aplicaciones de la Mac.

```bash Terminal icon="terminal" theme={null}
sudo iru collect-apps
```

### Ejecutar Library Items

Comprueba si hay Library Items para ejecutar.

```bash Terminal icon="terminal" theme={null}
sudo iru library
```

Para forzar la ejecución de un solo Library Item aunque no esté programado, usa `--item` con `--reset-daily` (igual que `-F`):

```bash Terminal icon="terminal" theme={null}
sudo iru library --item <name or ID> --reset-daily
```

Opciones disponibles del comando *library*:

| <Icon icon="code" size={14} /> **Opción** | <Icon icon="circle-info" size={14} /> **Descripción** |
| - | - |
| `--list` | Enumera todos los Library Items asignados a la computadora. |
| `--state` | Obtiene el estado actual del administrador de Library del Iru Agent. |
| `--item` | Ejecuta un Library Item específico por nombre o por ID de Library Item. Usa `-F` o `--reset-daily` para forzar la ejecución aunque el elemento no esté programado. |
| `--reset-daily` | Con `--item`, fuerza la ejecución del elemento aunque no esté programado. Igual que `-F`. |
| `--cancel` | Cancela el Library Item que se está ejecutando y borra la cola actual. |

### Imprimir los registros del Iru Agent

Imprime las entradas de registro del subsistema del Iru Agent desde el sistema de registro unificado. La opción `--last` es **obligatoria** y especifica el número de segundos anteriores de los que se imprimirán los registros. Reemplaza \<seconds> por un número, como 300. (Los resultados que se muestran realmente están limitados según el almacenamiento disponible del registro unificado).

Redirige la salida del comando con > para guardarla en un archivo de registro externo.

```bash Terminal icon="terminal" theme={null}
sudo iru logs --last <seconds>
```

Opciones disponibles del comando *logs*:

| <Icon icon="code" size={14} /> **Opción** | <Icon icon="circle-info" size={14} /> **Descripción** |
| - | - |
| `--no-format` | Imprime las entradas de registro sin formato de color ANSI. |
| `--debug` | Incluye los registros de nivel de depuración; el registro de depuración debe habilitarse previamente. |

<Callout icon="circle-info" color="#B84A7A" iconType="regular">
  El **registro unificado** es independiente de la marca del producto: los identificadores de subsistema en la Mac siguen usando el prefijo **`io.kandji`** en los predicados de `log show` y en `log config --subsystem`, como en los ejemplos siguientes. Usa esas cadenas para que los comandos coincidan con lo que registra el sistema.
</Callout>

Habilita el registro de depuración para un subsistema; los subsistemas se enumeran en la sección **Subsistemas de registro**.

```bash Terminal icon="terminal" theme={null}
sudo log config --mode "level:debug" --subsystem io.kandji.installer
```

Ejemplo de uso del comando de registro de depuración.

```bash Terminal icon="terminal" theme={null}
sudo iru logs --no-format --debug --last 10000 > ~/Desktop/iru.log
```

**Subsistemas de registro**

Los subsistemas de registro disponibles en el Iru Agent ofrecen un registro granular y específico.

Comando de registro con predicado de subsistema.

```bash Terminal icon="terminal" theme={null}
sudo log show --predicate 'subsystem beginsWith "io.kandji"'
```

Opciones disponibles del comando de registro con predicado:

| <Icon icon="code" size={14} /> **Opción** | <Icon icon="circle-info" size={14} /> **Descripción** |
| - | - |
| `--info` | Incluye los registros de nivel informativo cuando están disponibles. |
| `--debug` | Incluye los registros de nivel de depuración; el registro de depuración debe habilitarse previamente. |
| `--help` | Muestra una lista completa de las opciones disponibles. |

Comando de registro con predicado de subsistema y opciones.

```bash Terminal icon="terminal" theme={null}
sudo log show --predicate 'subsystem beginsWith "io.kandji.daemon"' --info --debug
```

Subsistemas de registro disponibles:

* io.kandji.beekeeper
* io.kandji.cli
* io.kandji.daemon
* io.kandji.installer
* io.kandji.library-manager
* io.kandji.menu
* io.kandji.passport
* io.kandji.parameter-agent
* io.kandji.self-service
* io.kandji.liftoff

### EDR

Enumera los archivos en cuarentena.

```bash Terminal icon="terminal" theme={null}
sudo iru avert --list-quarantine
```

Elimina los archivos en cuarentena.

```bash Terminal icon="terminal" theme={null}
sudo iru avert --delete-quarantine
```

### Comandos que se pueden usar en scripts

Estos comandos se pueden ejecutar mediante un Library Item Custom Script o Custom App. También se pueden ejecutar localmente en una Mac en Terminal.

<Warning>
  Cuando uses las opciones para scripts que se indican a continuación, por ejemplo dentro de un Library Item Custom Script, debes reemplazar **sudo iru** por la ruta completa al binario: /usr/local/bin/iru
</Warning>

### Reiniciar

Esta opción se puede usar en flujos de trabajo con scripts para forzar un reinicio aprovechando el Iru Agent y la aplicación de la barra de menús. Visualmente es similar al reinicio forzado durante la habilitación de FileVault o una actualización de Managed OS.

Esto inicia un reinicio mostrando al usuario que tiene la sesión iniciada un temporizador de cuenta regresiva. Si no se especifica ningún retraso, se usará el valor predeterminado de 1800 (30 minutos). Si no hay ningún usuario con la sesión iniciada, se ignorará el retraso y la Mac se reiniciará de inmediato.

Reemplaza `<seconds>` por la duración de la cuenta regresiva en segundos (por ejemplo, `300` para cinco minutos).

```bash Terminal icon="terminal" theme={null}
sudo iru reboot --delaySeconds <seconds>
```

Fuerza un reinicio sin dar a los usuarios la opción de aplazarlo.

```bash Terminal icon="terminal" theme={null}
sudo iru reboot --no-deferral
```

### Dock

Esta opción se puede usar en flujos de trabajo con scripts para agregar elementos al final del Dock de macOS o quitar elementos del Dock de macOS del usuario que tiene la sesión iniciada.

La aplicación a la que hace referencia el identificador de paquete debe estar en la carpeta /Applications.

Si especificas opcionalmente la opción *--all*, el icono se agrega al final del Dock para todas las cuentas de usuario.

```bash Terminal icon="terminal" theme={null}
sudo iru dock [--add <bundle_id>] [--remove <bundle_id>] [--all]
```

Si usas varias opciones a la vez, usa un solo comando y separa las opciones con comillas y espacios, como se muestra en el ejemplo siguiente.

```bash Terminal icon="terminal" theme={null}
/usr/local/bin/iru dock --add "com.google.Chrome us.zoom.xos com.tinyspeck.slackmacgap"
```

### Alerta

Este comando se puede usar en flujos de trabajo con scripts para mostrar una alerta a los usuarios.

```bash Terminal icon="terminal" theme={null}
sudo iru display-alert [--title <text>] [--message <text>] [--icon <path>] [--suppression-key <string>] [--help-url <url>] [--no-wait]
```

Tiene varias opciones, que se describen a continuación.

| <Icon icon="code" size={14} /> **Opción** | <Icon icon="circle-info" size={14} /> **Descripción** | <Icon icon="star" size={14} /> **Valor predeterminado si no se proporciona** |
| - | - | - |
| `--title` | Especifica un título personalizado para la ventana de alerta | "Alert" |
| `--message` | Especifica un mensaje personalizado para la ventana de alerta | Sin valor predeterminado |
| `--icon` | Especifica un icono personalizado para la ventana de alerta. Se recomienda usar archivos .jpg, .png o .icns | Icono del Iru Agent |
| `--suppression-key` | Si se proporciona, mostrará una opción al usuario: "Do not show this message again". Si esta clave de supresión se proporciona en una alerta futura y el usuario elige no volver a verla, la alerta no se mostrará. | Sin valor predeterminado. Si no se especifica ninguna clave de supresión, no se muestra la opción "Do not show this message again". |
| `--help-url` | Permite especificar una URL personalizada para el botón Help de la alerta. Debe ser una URL HTTPS. | Sin valor predeterminado. Si no se especifica ninguna URL, no se muestra el botón Help. |
| `--no-wait` | Permite que se muestre la alerta, pero mantiene en ejecución el resto del script sin esperar la interacción del usuario con la alerta | La alerta se mostrará y esperará la interacción del usuario antes de que el script continúe. |

A continuación se muestra un ejemplo del comando subyacente para una alerta y la experiencia resultante en macOS Tahoe:

```bash Terminal icon="terminal" wrap lines theme={null}
sudo /usr/local/bin/iru display-alert --title "Low Disk Space" --message "Your Mac computer's Hard Drive is running critically low on space, please contact Accuhive IT as soon as possible." --suppression-key accuhive --help-url https://iru.com --no-wait
```

<Frame>
  <img src="https://mintcdn.com/iru/MkDfHiR-OnSWToLO/assets/media/images/iru-command-line-pop-up-example.png?fit=max&auto=format&n=MkDfHiR-OnSWToLO&q=85&s=8b0ee025c521cc249cd2c0d7261a77b0" alt="Cuadro de diálogo de alerta en macOS Tahoe con el título Low Disk Space, el mensaje de advertencia, el botón Help y OK después de ejecutar el comando display-alert" width="520" height="562" data-path="assets/media/images/iru-command-line-pop-up-example.png" />
</Frame>

### Enviar diagnósticos

[Envía diagnósticos](/es/endpoint/agent/how-to-submit-iru-agent-diagnostics) a Iru Endpoint. Equivale al elemento del menú de acciones (engranaje) disponible en el menú de Iru.

```bash Terminal icon="terminal" theme={null}
sudo iru submit-diagnostics [--comment <text>]
```

Opción disponible del comando submit-diagnostics:

| <Icon icon="code" size={14} /> **Opción** | <Icon icon="circle-info" size={14} /> **Descripción** | <Icon icon="star" size={14} /> **Valor predeterminado si no se proporciona** |
| - | - | - |
| `--comment` | Especifica un comentario que se presentará en los diagnósticos | Sin valor predeterminado |

### Versión

Muestra la versión instalada del Iru Agent.

```bash Terminal icon="terminal" theme={null}
sudo iru version
```

### Ayuda

Muestra el texto de ayuda.

```bash Terminal icon="terminal" theme={null}
sudo iru help
```