KACE Systems Management Appliance 14.0 Common Documents - Guía de administración

$(KACE_DEPENDENCY_DIR)

Esta es la carpeta en que las dependencias de scripts para este script se descargan para el cliente.

5.2 o superior: $(KACE_DATA_DIR)\kbots_cache\packages\kbots\xxx

5.1:$(KACE_INSTALL)\packages\kbots\xxx

$(KACE_SYS_DIR)

$(KBOX_SYS_DIR)

Directorio de sistema del dispositivo del agente.

Ambos son sinónimos. Preferido: $(KACE_SYS_DIR).

Windows: C:\Windows\System32

Mac OS X: /

Linux: /

$(KACE_MAC_ADDRESS)

$(MAC_ADDRESS)

$(KBOX_MAC_ADDRESS)

Dirección Ethernet MAC primaria del dispositivo del agente.

Todos son sinónimos. Preferido: $(KACE_MAC_ADDRESS)

$(KACE_IP_ADDRESS)

$(KBOX_IP_ADDRESS)

Dirección IP local del agente (de acuerdo con la entrada de red de KACE_MAC_ADDRESS) (http://kace.kbox.com:80).

Ambos son sinónimos. Preferido: $(KACE_IP_ADDRESS)

$(KACE_SERVER_URL)

Combinación de servidor, puerto y prefijo URL. (http://kace.kbox.com:80)

$(KACE_SERVER)

Nombre de host del servidor del dispositivo. (kbox)

$(KACE_SERVER_PORT)

Puerto para conectarse al servidor del dispositivo. (80/433)

$(KACE_SERVER_URLPREFIX)

Protocolo web para conectarse al servidor del dispositivo. (http/https)

$(KACE_COMPANY_NAME)

Copia del agente de los ajustes de la página de configuración del servidor.

$(KACE_KUID)

$(KBOX_MACHINE_ID)

Este es el id. de Quest KACE único asignado a este agente.

Ambos son sinónimos. Preferido: $(KACE_KUID)

$(KACE_APP_DIR)

Directorio de instalación de los complementos y el agente de Quest KACE.

Para los agentes anteriores está asignado a $(KACE_INSTALL).

Windows: C:\Program Files\Quest\KACE\ o C:\Program Files (x86)\Quest\KACE\

SO Mac: /Library/Application Support/Quest/KACE/bin

Linux: /opt/quest/kace/bin

$(KACE_DATA_DIR)

Directorio de instalación para ejecutables, scripts, paquetes y otros.

Para los agentes anteriores está asignado a $(KACE_INSTALL).

Windows Vista y posteriores: C:\ProgramData\Quest\KACE\

SO Mac: /Library/Application Support/Quest/KACE/data

Linux: /var/quest/kace

$(KACE_AGENT_VERSION)

Sustituye el número de versión del agente instalado. "5.2.12345".

5.2 o superior únicamente.

$(KACE_AGENT_ARCH)

Sustituye la arquitectura del agente instalado. "x86/x64".

5.2 o Windows superior únicamente.

$(KACE_HARDWARE_ARCH)

Sustituye la arquitectura del hardware físico. "x86/x64".

5.2 o Windows superior únicamente.

$(KACE_OS_FAMILY)

Sustituye Windows, Mac o Linux según el sistema operativo del dispositivo administrado por el agente.

5.2 o superior únicamente.

$(KACE_OS_ARCH)

Sustituye x86 o x64 según la versión instalada de Microsoft Windows.

5.2 o Windows superior únicamente.

Nombre

Un nombre significativo para el script que lo distingue de los demás Scripts de la lista.

TIP: Puede habilitar o deshabilitar uno o más scripts en la página Scripts. Para ello, selecciónelos en la tabla, haga clic eny, luego, seleccione Habilitar o Deshabilitar según sea necesario.

Habilitado

Si el script está habilitado para ejecutarse en los dispositivos de destino. No habilite el script hasta que termine de editarlo y de probarlo y hasta que esté listo para ejecutarlo. Habilite el script en una etiqueta de prueba antes de habilitarlo en todos los dispositivos.

Categoría

La categoría de script. Elija una categoría existente de la lista desplegable o haga clic en Nueva categoría para agregar una. Si no desea asignar una categoría a este script, asegúrese de que este campo esté configurado en Ninguno.

• Puede asignar una categoría a uno o más scripts en la página Scripts. Para ello, selecciónelos en la tabla, haga clic en Elegir acción > Categoría y, luego, seleccione una categoría de la lista. • Puede eliminar una categoría asignando todos los scripts actualmente en una Categoría a ninguna.

Tipo

El tipo de script. Los tipos de scripts incluyen:

IMPORTANT: Debe asegurarse de que la extensión de archivo adecuada esté asociada con el script para permitir que se ejecute en el sistema operativo de destino. Por ejemplo, puede ejecutar los scripts .sh en dispositivos Mac y Linux, y los scripts .ps1 de PowerShell en dispositivos Windows.

Estado

Si el script está en desarrollo (Borrador) o si se ha introducido en su red (Producción). Use el estado Plantilla si está construyendo un script que se usará como base para futuros scripts.

Descripción

(Opcional) Breve descripción de las acciones que realiza el script. Este campo ayuda a distinguir un script de otro en la lista Scripts.

Notas

Cualquier información adicional que desee proporcionar.

Todos los dispositivos

Implemente en todos los dispositivos. Desactive la casilla de verificación para limitar la implementación a etiquetas o dispositivos específicos.

Restringir a etiquetas

Limite la implementación a los dispositivos que pertenecen a etiquetas especificadas. Para seleccionar las etiquetas, haga clic en Editar, arrastre las etiquetas a la ventana Limitar la implementación a y, luego, haga clic en Aceptar.

Si selecciona una etiqueta que tiene un recurso compartido de replicación o una ubicación de descarga alternativa, el dispositivo copia los activos digitales desde allí, en lugar de descargarlos directamente desde el dispositivo.

NOTE: El dispositivo utiliza un recurso compartido de replicación antes de utilizar la ubicación alternativa de KACE.

Dispositivos

Limite la implementación a uno o más dispositivos. Para buscar dispositivos, comience a escribir en el campo.

Sistemas operativos

Los sistemas operativos en los que se ejecuta la aplicación. Las aplicaciones se implementan solamente en los dispositivos con los sistemas operativos seleccionados.

Tiene la opción de seleccionar versiones de SO por su familia, producto, arquitectura, ID de versión o versión de compilación. Puede elegir una versión de compilación específica, o un nodo de elemento primario, según se necesite. Si selecciona un nodo de elemento primario en el árbol, automáticamente se seleccionan nodos secundarios asociados. Este comportamiento permite seleccionar cualquiera de las futuras versiones del SO, ya que los dispositivos se agregan o actualizan en el entorno administrado. Por ejemplo, para seleccionar todas las versiones actuales y futuras de las compilaciones asociadas con una arquitectura de Windows 10 x64, vaya a Todos, > Windows, > Windows 10 y seleccione x64.

Sistema local

Se ejecuta el script con privilegios administrativos en el dispositivo local. Use este ajuste para todos los scripts creados con una plantilla.

Usuario que inició sesión

Se ejecuta el script como el usuario conectado al dispositivo local. Esto afecta el perfil del usuario.

Todos los usuarios que iniciaron sesión

Se ejecuta el script una vez para cada usuario conectado al dispositivo. Esto afecta los perfiles de todos los usuarios.

Credenciales

Ejecute Script y KScripts de shell en línea en el contexto de las credenciales que se especifican aquí. Seleccione las credenciales existentes de la lista desplegable o seleccione Agregar nueva credencial para agregar credenciales no presentes en la lista.

Consulte Agregue y edite credenciales de usuario/contraseña.

NOTE: Cuando se ejecutan KScripts en línea en dispositivos con Windows, las ventanas de mensajes no se muestran en los dispositivos de destino cuando selecciona la opción de ejecutar el script como un usuario de credencial específico. Para mostrar ventanas de mensajes, ejecute el script como sistema local, usuario conecto o todos los usuarios conectados.

Notificar al usuario antes de ejecutar

Permite al usuario ejecutar la acción, cancelarla o retrasarla. Esto resulta especialmente importante cuando se requieren reinicios. Si ningún usuario inició sesión, el script se ejecuta de inmediato.

Opciones

Las opciones presentadas para el usuario en el diálogo de alerta (disponible cuando selecciona Alertar al usuario antes de ejecutar):

Si transcurre el tiempo especificado en el Tiempo de espera sin una respuesta del usuario, el script se ejecuta en ese momento.

Interacción con Ejecutar como:

Tiempo de espera

El tiempo, en minutos, durante el cual se mostrará el cuadro de diálogo antes de que se lleve a cabo una acción. Si transcurre este período sin que el usuario presione un botón, el dispositivo realiza la acción especificada en la lista desplegable Tiempo de espera.

Acción de tiempo de espera

Acción que se llevará a cabo cuando transcurra el período del Tiempo de espera sin que el usuario haya elegido una opción.

Duración de la postergación

La cantidad de tiempo, en minutos, para el período luego de que el usuario hace clic en Postergar. Una vez transcurrido este período, vuelve a aparecer el cuadro de diálogo.

Mensaje inicial

El mensaje que se mostrará a los usuarios antes de que se ejecute la acción.

Para personalizar el logotipo que aparece en el cuadro de diálogo, consulte Configure los ajustes generales del dispositivo sin el componente Organización habilitado.

Ninguno

Ejecute en combinación con un evento y no en una fecha u hora específicas.

Cada (número) horas

Se ejecuta en un intervalo especificado.

Todos los días/un día específico a las HH:MM

Se ejecuta cada día a una hora especificada o se ejecuta en un día de la semana designado a una hora específica.

Ejecutar el día (número) de cada mes o de un mes específico a las HH:MM

Se ejecuta el mismo día todos los meses o en un mes específico a una hora determinada.

Ejecutar el (número) día de la semana de cada mes o de un mes específico a las HH:MM

Se ejecuta el mismo día de la semana todos los meses o en un mes específico a una hora determinada.

Personalizado

Se ejecuta de acuerdo con un programa personalizado.

Usar el formato cronológico de cinco campos estándar (no se admite el formato cron. extendido):

Utilice lo siguiente al especificar valores:

Ejemplos:

Ver programa de tareas

Haga clic para ver el programa de tareas. En el cuadro de diálogo Programa de tareas, se muestra una lista de tareas programadas. Haga clic en una tarea para revisar sus detalles. Para obtener más información, consulte Ver programas de tareas.

También ejecutar una vez en el siguiente registro del dispositivo (solo para KScript sin conexión)

Ejecuta los KScript sin conexión una vez cuando se descargan nuevos scripts desde el dispositivo.

También ejecutar antes del inicio de sesión (solo para KScripts sin conexión)

Ejecuta el KScript sin conexión cuando el dispositivo se inicia. Esto puede causar que los dispositivos se inicien de forma más lenta que lo normal.

NOTE: Si un dispositivo tiene un ajuste de Active Directory o de objeto de política grupal que muestra un mensaje que el usuario debe confirmar antes de iniciar sesión, los scripts no se ejecutan hasta que el mensaje se confirma.

También ejecutar una vez en el siguiente registro del dispositivo (solo para KScript sin conexión)

Ejecuta el KScript sin conexión una vez que el usuario ingresa las credenciales de inicio de sesión de Windows.

Permitir ejecución sin conexión (solo para KScript sin conexión)

Permite ejecutar el KScript sin conexión incluso si el dispositivo de destino no puede entrar en contacto con el aparato para informar resultados. En ese caso, los resultados se almacenan en el dispositivo y se cargan al aparato durante la siguiente conexión.

Permitir ejecución sin un usuario conectado

Permite ejecutar el script incluso si el usuario no ha iniciado sesión. Para ejecutar el script solo cuando el usuario ha iniciado sesión en el dispositivo, restablezca esta opción.

Ejecutar en la próxima conexión si está desconectado

Para KScripts en línea o scripts de shell, esta opción permite que el script se ejecute en máquinas sin conexión cuando vuelvan a estar en línea de nuevo.

Cuando un script se ejecuta, calcula el número de máquinas en que se supone se ejecutará en función de sus etiquetas, o sus sistemas operativos, o mediante la identificación manual de las máquinas seleccionadas. Dado ese conjunto de máquinas, el script luego determina cuál de esas máquinas se encuentra actualmente en línea y, a continuación, pone en línea una tarea para las máquinas en línea en el Konductor.

Cuando se selecciona esta opción, el script omite el paso que identifica las máquinas en línea y se ejecuta en las máquinas en línea. Para las máquinas sin conexión, la tarea se agrega a la cola del Konductor y se ejecuta cuando esas máquinas vuelven a estar en línea.

Todas las tareas posteriores para ejecutar el mismo script (por ejemplo, para una máquina sin conexión que ya existe en la cola del Konductor) sobrescriben las tareas existentes, de modo que nunca más puede haber una tarea en la cola del Konductor para la misma máquina.

Tener un gran número de tareas en el Konductor puede afectar el rendimiento del dispositivo, de modo que las mejores prácticas son usar scripts sin conexión para aquellas máquinas que generalmente se encuentran sin conexión y solo usar esta opción con scripts en línea cuando se espera que las máquinas objetivo estén en línea, a fin de evitar llenar en exceso la cola del Konductor.

De forma predeterminada, esta opción está deshabilitada.

Intentos

Escriba la cantidad de veces que el dispositivo debe intentar ejecutar el script.

Si el script genera un error, pero la corrección es satisfactoria, puede ejecutar la tarea de nuevo para confirmar el paso de corrección. Para esto, establezca el número de intentos en 2 o más. Si la sección Verificar genera un error, el script se ejecuta la cantidad de veces indicada en este campo.

Con error

Texto de script

Escriba los contenidos del script.

Nombre del archivo de script

Ingrese el nombre y la extensión del archivo que contendrá el script especificado.

IMPORTANT: Debe asegurarse de que la extensión de archivo adecuada esté asociada con el script para permitir que se ejecute en el sistema operativo de destino. Por ejemplo, puede ejecutar los scripts .sh en dispositivos Mac y Linux, y los scripts .ps1 de PowerShell en dispositivos Windows.

Tiempo de espera (minutos)

Especifica la cantidad máxima de minutos que puede ejecutar el script en el dispositivo de destino.

Cargar archivo

Si el script crea un archivo y desea cargarlo en el dispositivo, seleccione esta opción y proporcione la siguiente información:

Eliminar archivos descargados

Si el script requiere que se ejecuten otros archivos, tales como los instaladores, y desea eliminarlos después de la ejecución del script, seleccione esta opción.