--- title: "Interfaz de línea de comandos del Kandji Agent" slug: "kandji-agent-command-line-interface" updated: 2025-03-18T12:39:53Z published: 2025-03-18T12:39:53Z canonical: "support.kandji.io/kandji-agent-command-line-interface" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.kandji.io/kb/llms.txt > Use this file to discover all available pages before exploring further. # Interfaz de línea de comandos del agente Kandji El Kandji Agent ofrece un conjunto de potentes comandos de Terminal que brindan a los administradores control e información adicionales para su flota de dispositivos. Si bien algunos comandos solo se pueden ejecutar localmente en un dispositivo que usa Terminal, otros se pueden implementar a través de un Library Item de script personalizado para una mayor flexibilidad. ### Comandos de solo local Los siguientes comandos deben ejecutarse directamente en un dispositivo en Terminal. No se pueden implementar a través de un script personalizado o un Custom App Library Item. #### Correr El agente se ejecutará y se registrará inmediatamente. Normalmente, el agente se registra cada 15 minutos. Sin una conexión a Internet, el agente se ejecutará en modo sin conexión. ```bash sudo kandji run ``` Al agregar --reset-daily al comando run, se ejecutarán todas las Parameters, incluidas las que se ejecutan solo una vez al día. ```bash sudo kandji run --reset-daily ``` #### Ejecutar diariamente MDM actualización de inventario El agente solicitará al servidor de MDM que inicie sus comandos de MDM diarios, como validar Apps y Libros de Apple Business Manager, así como consultar cierta información del dispositivo. ```bash sudo kandji update-mdm ``` #### Recopilar aplicaciones Recopila el inventario completo de aplicaciones del Mac. ```bash sudo kandji collect-apps ``` #### Ejecutar Library Items Comprueba los elementos de biblioteca que se van a ejecutar. ```bash sudo kandji library ``` Opciones de comandos *de biblioteca* disponibles: | **Opción** | **Descripción** | | --- | --- | | `--list` | Enumere todos los elementos de biblioteca asignados al equipo. | | `--state` | Obtenga el estado actual del administrador de bibliotecas de Kandji Agent . | | `--item` | Ejecutar un elemento de biblioteca específico por nombre o ID de elemento de biblioteca; especifique *-F* para forzar la ejecución. | | `--cancel` | Cancela el elemento de biblioteca que se está ejecutando actualmente y borra la cola actual. | #### Imprimir registros de Kandji Imprime entradas de registro para el subsistema de Kandji Agent desde el sistema de registro unificado. La opción '--last' es **obligatoria** y especifica el número de segundos anteriores desde los que se imprimirán los registros. Reemplace por un número, como 300. (Los resultados reales que se muestran están limitados en función del almacenamiento de registros unificado disponible). Redirija la salida del comando mediante > para guardarlo en un archivo de registro externo. ```bash sudo kandji logs --last ``` Opciones *de comando de registros* disponibles: | **Opción** | **Descripción** | | --- | --- | | `--no-format` | Imprima entradas de registro sin formato de color ANSI. | | `--debug` | Incluye registros de nivel de depuración, el registro de depuración debe estar habilitado antes. | Habilite el registro de depuración. ```bash sudo log config --mode "level:debug" --subsystem io.kandji.KandjiAgent ``` Deshabilite el registro de depuración. ```bash sudo log config --mode "level:default" --subsystem io.kandji.KandjiAgent ``` Ejemplo de uso del comando de registro de depuración. ```bash sudo kandji logs --no-format --debug --last 10000 >~/Desktop/kandji.log ``` #### Evitar Enumerar los archivos en cuarentena. ```bash sudo kandji avert --list-quarantine ``` Eliminar archivos en cuarentena. ```bash sudo kandji avert --delete-quarantine ``` ### Comandos programables Estos comandos se pueden ejecutar a través de un script personalizado o un Custom App Library Item. También se pueden ejecutar localmente en una Mac en Terminal. > [!WARNING] > Al utilizar las siguientes opciones de scripts, como dentro de un Library Itemde script personalizado, debe reemplazar **sudo kandji** con la ruta completa al binario: /usr/local/bin/kandji #### Reiniciar Esta opción se puede utilizar en flujos de trabajo con scripts para forzar un reinicio aprovechando la aplicación de Kandji Agent y barra de menús. Es visualmente similar al reinicio forzado durante la habilitación de FileVault o una actualización Managed OS . Esto inicia un reinicio solicitando al usuario que ha iniciado sesión un temporizador de cuenta regresiva. Si no se especifica ningún retraso, se utilizará el valor predeterminado 1800 (30 minutos). Si ningún usuario ha iniciado sesión, el retraso se ignorará y el Mac se reiniciará inmediatamente. ```bash sudo kandji reboot --delaySeconds NumberOfSeconds ``` Fuerza un reinicio sin dar a los usuarios la opción de retrasarlo. ```bash sudo kandji reboot --no-deferral ``` #### Dársena Esta opción se puede utilizar en flujos de trabajo con scripts para agregar elementos al final del Dock de macOS o eliminar elementos del Dock de macOS del usuario que ha iniciado sesión actualmente. La aplicación a la que hace referencia el identificador de paquete debe estar en la carpeta /Applications. Opcionalmente, si se especifica la opción *--all* , se agrega el icono al final del Dock para todas las cuentas de usuario. ```bash sudo kandji dock [--add bundle identifier] [--remove bundle identifier] [--all] ``` Si usa varias opciones a la vez, use un solo comando y separe las opciones usando comillas y espacios separados, como se muestra en el ejemplo a continuación. ```bash /usr/local/bin/kandji dock --add "com.google.Chrome us.zoom.xos com.tinyspeck.slackmacgap" ``` #### Alerta Este comando se puede utilizar en flujos de trabajo con scripts para presentar una alerta a los usuarios. ```bash sudo kandji display-alert [--title text] [--message text] [--icon path_to_image] [--suppression-key string] [--help-url url] [--no-wait] ``` Tiene varias opciones, que se describen a continuación. | **Opción** | **Descripción** | **Predeterminado si no se proporciona** | | --- | --- | --- | | `--title` | Especifica un título personalizado para la ventana de alerta | "Alerta" | | `--message` | Especifica un mensaje personalizado para la ventana de alerta | No hay valor predeterminado | | `--icon` | Especifica un icono personalizado para la ventana de alerta. Se recomienda utilizar archivos .jpg, .png o .icns | Icono de Kandji Agent | | `--suppression-key` | Si se proporciona, mostrará una opción al usuario: "No volver a mostrar este mensaje" Si esta clave de supresión se proporciona en una alerta futura y el usuario opta por no volver a verla, la alerta no se mostrará. | No hay valor predeterminado Si no se especifica ninguna clave de supresión, no se muestra la opción "No volver a mostrar este mensaje". | | `--help-url` | Permite especificar una dirección URL personalizada para el botón de ayuda de alerta. Debe ser una URL HTTPS | No hay valor predeterminado Si no se especifica ninguna dirección URL, no se muestra el botón Ayuda. | | `--no-wait` | Permite que se muestre la alerta, pero mantiene el resto del script en ejecución sin esperar la interacción del usuario en 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 Sequoia: ```bash sudo /usr/local/bin/kandji 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://kandji.io --no-wait ``` ![](https://cdn.document360.io/0844b095-d720-4a7b-bb17-ec97d9bc6e41/Images/Documentation/Kandji-Support-KB-01-02.png) #### Enviar diagnósticos [Enviar diagnósticos](/v1/docs/es-mx/how-to-submit-kandji-agent-diagnostics) a Kandji. Equivalente al elemento del menú de acción (equipo) disponible en el menú Kandji . ```bash sudo kandji submit-diagnostics [--comment text] ``` Opción de comando submit-diagnostics disponible: | **Opción** | **Descripción** | **Predeterminado si no se proporciona** | | --- | --- | --- | | `--comment` | Especifica un comentario que se presentará en el diagnóstico | No hay valor predeterminado | #### Versión Muestra la versión de Kandji Agent instalada. ```bash sudo kandji version ``` #### Ayuda Mostrar texto de ayuda. ```bash sudo kandji help ```