Interfaz de línea de comandos del Iru Agent

Esta guía se aplica a computadoras Mac

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.

Desde el 8 de abril de 2026, las aplicaciones se actualizaron de la marca Kandji

a la marca Iru

. 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.

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.

Terminal

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.

Terminal

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.

Terminal

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.

Terminal

sudo iru update-mdm

Recopilar aplicaciones

Recopila el inventario completo de aplicaciones de la Mac.

Terminal

sudo iru collect-apps

Ejecutar Library Items

Comprueba si hay Library Items para ejecutar.

Terminal

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):

Terminal

sudo iru library --item <name or ID> --reset-daily

Opciones disponibles del comando library:

Opción	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.

Terminal

sudo iru logs --last <seconds>

Opciones disponibles del comando logs:

Opción	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.

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.

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

Terminal

sudo log config --mode "level:debug" --subsystem io.kandji.installer

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

Terminal

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.

Terminal

sudo log show --predicate 'subsystem beginsWith "io.kandji"'

Opciones disponibles del comando de registro con predicado:

Opción	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.

Terminal

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.

Terminal

sudo iru avert --list-quarantine

Elimina los archivos en cuarentena.

Terminal

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.

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

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).

Terminal

sudo iru reboot --delaySeconds <seconds>

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

Terminal

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.

Terminal

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.

Terminal

/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.

Terminal

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.

Opción	Descripción	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:

Terminal

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

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

Enviar diagnósticos

Envía diagnósticos a Iru Endpoint. Equivale al elemento del menú de acciones (engranaje) disponible en el menú de Iru.

Terminal

sudo iru submit-diagnostics [--comment <text>]

Opción disponible del comando submit-diagnostics:

Opción	Descripción	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.

Terminal

sudo iru version

Ayuda

Muestra el texto de ayuda.

Terminal

sudo iru help

Primeros pasos

Dispositivos

Agente

Blueprints

Inscripción

Library

Guías de implementación

Configuración

Integraciones

Endpoint Detection & Response

Gestión de vulnerabilidades

Interfaz de línea de comandos del Iru Agent

Acerca de la CLI del Iru Agent

Comandos solo locales

Modo interactivo (TUI)

Run

Ejecutar la actualización diaria del inventario de MDM

Recopilar aplicaciones

Ejecutar Library Items

Imprimir los registros del Iru Agent

EDR

Comandos que se pueden usar en scripts

Reiniciar

Dock

Alerta

Enviar diagnósticos

Versión

Ayuda

​Acerca de la CLI del Iru Agent

​Comandos solo locales

​Modo interactivo (TUI)

​Run

​Ejecutar la actualización diaria del inventario de MDM

​Recopilar aplicaciones

​Ejecutar Library Items

​Imprimir los registros del Iru Agent

​EDR

​Comandos que se pueden usar en scripts

​Reiniciar

​Dock

​Alerta

​Enviar diagnósticos

​Versión

​Ayuda

Acerca de la CLI del Iru Agent

Comandos solo locales

Modo interactivo (TUI)

Run

Ejecutar la actualización diaria del inventario de MDM

Recopilar aplicaciones

Ejecutar Library Items

Imprimir los registros del Iru Agent

EDR

Comandos que se pueden usar en scripts

Reiniciar

Dock

Alerta

Enviar diagnósticos

Versión

Ayuda