zac para Macintosh (1)

Name

zac - La interfaz de gestión de línea de comandos para el agente ZENworks de Micro Focus instalada y en ejecución en los dispositivos gestionados con Macintosh.

Sintaxis

zac command options

Descripción

La utilidad zac lleva a cabo funciones de gestión de línea de comandos sobre los dispositivos gestionados de ZENworks, incluida la instalación y desinstalación de lotes de software, la aplicación de directivas y el registro y anulación del registro de los dispositivos.

Guía de uso

Esta sección incluye información sobre las convenciones y el formato general de los comandos.

La mayoría de los comandos cuenta con una forma larga y otra corta:

  • Forma larga: add-reg-key
  • Forma corta: ark

Si las dos formas están disponibles, el comando se describe del modo siguiente:

add-reg-key (ark) opciones

Para utilizar el comando, emplee solo la forma larga o la corta:

zac add-reg-key opciones

zac ark opciones

Si una opción incluye un espacio, utilice comillas:

zac ark "opción 1"

Argumentos obligatorios y opcionales

Los argumentos incluidos entre paréntesis ( ) son obligatorios, mientras que los que se incluyen entre corchetes [ ] son opcionales.

Puntos suspensivos (...)

Los puntos suspensivos indican que un comando acepta varias entradas del último tipo de argumento. Los argumentos se deben separar mediante espacios o comas, según el comando. Por ejemplo:

zman server-add-bundle [opciones] (servidor) (lote) [...]

Los puntos suspensivos indican que server-add-bundle puede aceptar varios lotes. En la ayuda del nivel de comandos, la ayuda de argumento de entrada múltiple se indica como [(lote) (lote) ... (lote)] para que sea más clara.

Comandos de lotes

bundle-install (bin)

Instala los lotes especificados según el nombre de visualización que coincida con la expresión exacta o la cadena o con el GUID del lote.

Utilice el comando bundle-list para obtener una lista de los lotes disponibles y sus nombres de visualización.

Ejemplo para instalar un lote:

zac bin LoteMac

bundle-launch (bln)

Lanza el lote especificado. Se ejecutan las acciones del conjunto de acciones Lanzar. Si intenta lanzar un lote que no esté instalado, primero se instala el lote y luego se lanza.

Utilice el comando bundle-list para obtener una lista de los lotes disponibles y sus nombres de visualización.

Ejemplo de lanzamiento de un lote basado en el nombre de visualización:

zac bln LoteMac

bundle-list (bl)

Muestra la lista de los lotes asignados al dispositivo y a los usuarios que han entrado en la sesión.

El resultado de este comando se muestra en columnas, que proporcionan información de todos los lotes asignados o disponibles para el dispositivo gestionado. Las columnas Nombre de visualización, Versión y Tipo de lote representan el nombre de visualización del lote, el número de versión del lote o la zona protegida y el tipo de lote, respectivamente.

La columna Estado muestra los siguientes estados.

Disponible: muestra este estado si el lote está instalado.

No instalado: muestra este estado si la versión concreta del lote no está instalada.

Descargado: muestra este estado si el contenido está descargado pero la acción del conjunto Instalar acciones no se ha ejecutado.

Un ejemplo para mostrar todos los lotes:

zac bl

bundle-lock-add (bla) [opciones] [nombre de lote] [...]

Bloquea los lotes especificados que coincidan con la expresión exacta o la cadena y evita que se actualicen o se eliminen.

Los bloqueos de lotes solo son aplicables al conjunto de acciones Instalar.

Acepta las siguientes opciones:

-li, ‑‑lock-install: bloquea el lote e impide la instalación del lote especificado en el bloqueo.

-t, ‑‑type: especifique el tipo de lote que se debe bloquear. Los tipos disponibles son Mac y Patch. Si no se especifica ningún tipo, se seleccionará el tipo de lote.

bundle-lock-list (bll)

Muestra una lista con los bloqueos de lotes. Los bloqueos de lotes están ordenados por ID.

Ejemplo para mostrar los lotes bloqueados:

zac bll

bundle-lock-remove (blr)

Elimina el bloqueo de lote que ha especificado según su número. Puede buscar el número para cada bloqueo usando el comando bundle-lock-list.

Ejemplo para eliminar todos los bloqueos de lotes:

zac blr ‑‑remove-all

bundle-props (bp)

Devuelve información de propiedad de un lote.

Ejemplo para obtener las propiedades de un lote especificado:

zac bp LoteMac

bundle-refresh (br)

Actualiza la información acerca del lote especificado.

Ejemplo para actualizar un lote:

zac br LoteMac

bundle-search (bse)

Busca lotes que coincidan con la cadena o expresión regular java especificada.

bundle-uninstall (bu)

Desinstala el lote especificado. Las acciones que admiten la acción Deshacer se ejecutan mientras se desinstala el lote. Cuando se completa la desinstalación del lote, el estado del lote indica No instalado.

Utilice el comando bundle-list para obtener una lista de los lotes instalados y sus nombres de visualización.

Ejemplo para desinstalar un lote:

zac bu LoteMac

bundle-verify (bv)

Vuelve a instalar el lote y ejecuta los conjuntos de acciones Verificar para garantizar que no se ha eliminado ni dañado ningún archivo. Utilice el comando bundle-list para obtener una lista de los lotes instalados y sus nombres de visualización.

Ejemplo para verificar un lote:

zac bv LoteMac

Comandos principales

add-reg-key (ark)

Este comando registra un dispositivo mediante la clave de registro especificada.

Ejemplo: zac add-reg-key

agent-properties (agp)

Este comando proporciona información sobre el agente ZENworks.

Ejemplo: zac agent-properties

cache-clear (cc)

Borra el caché de este dispositivo.

Ejemplo: zac cc

cert-info (ci)

Muestra información de certificados de claves públicas de cada servidor de ZCM conocido o añade un certificado raíz de confianza al almacén de la máquina.

Ejemplo:

Para mostrar el certificado de cada usuario de ZENworks conocido:

zac ci

Para añadir un certificado raíz de confianza al almacén de confianza del dispositivo:

zac ci <ubicación> -u misuario -p micontraseña

config-location (cl)

Muestra la ubicación actual.

Ejemplo:

zac config-location

file-system-guid (fsg)

Elimina y restaura el GUID de la estación de trabajo en el sistema de archivo como preparación para tomar una imagen.

Ejemplo:

Para mostrar el valor de GUID:

zac fsg

Para eliminar el GUID y el archivo conninfo.dat del sistema de archivos:

zac file-system-guid -d

Para restaurar el GUID en el sistema de archivos:

zac file-system-guid -r

No especificar ninguna opción para imprimir el valor de GUID:

zac fsg

get-pref (get)

Muestra las preferencias que están definidas en cada momento.

Ejemplo para mostrar todas las preferencias cuyo nombre comienza con abc:

zac get-pref abc

get-settings (gs)

El módulo de configuración descarga los valores en la caché local en cada actualización. Este comando devuelve la configuración en vigor asociada con la clave especificada.

Ejemplo:

zac gs clave1

También se puede usar el comando get-settings (gs) para que se enumeren los valores de configuración utilizando varias claves. Para obtener más información, consulte get-settings (gs) <clave> en la sección Comandos de estado.

logger [resetlog | level [MANAGED|ERROR|WARN|INFO|DEBUG] | managedlevel]

Cambia la configuración del registrador.

Puede emplear las siguientes opciones:

  • resetlog - Restaura el registro.
  • level - Si se utiliza sin un nivel, muestra el nivel de registro gestionado actualmente. Si se utiliza con uno de los niveles, cambia el nivel de registro al nivel especificado.
  • managedlevel: muestra el nivel de registro global de la zona.

Ejemplo para restaurar el archivo de registro:

zac logger resetlog

Ejemplo para mostrar el nivel de registro actual:

zac logger level

Ejemplo para establecer el nivel de registro como DEBUG y superiores:

zac logger level DEBUG

reestablish-trust (retr)

Este comando restablece la confianza en la zona actual.

Restablece la confianza con la zona de gestión actual. El nombre de usuario y la contraseña deben corresponder al administrador de la zona.

Ejemplo:

zac retr -u usuario -p contraseña

Los parámetros -u y -p son opcionales. Si no utiliza los parámetros -u ni -p, se le pedirá que introduzca un nombre de usuario y una contraseña.

refresh (ref)[general | partial bundle <nombre de visualización del lote> [bypasscache]

Inicia una actualización general o parcial para actualizar todos los lotes, directivas y valores de registro y de configuración.

Utilice bypasscache para que no se utilicen los datos del caché del servidor durante la actualización. Esta opción es útil para realizar pruebas o solucionar problemas.

Ejemplos:

zac ref general bypasscache

zac ref partial bypasscache

register (reg)

Este comando registra un dispositivo en una zona especificada.

Para ejecutar este comando, debe tener los derechos de dispositivo Crear/Suprimir para la carpeta que intenta registrar.

Ejemplo:

zac reg -k clave1 https://123.456.78.90

reregister (rereg)

Este comando registra un dispositivo en la zona actual y lo asigna al GUID de un objeto de dispositivo existente. El objeto de dispositivo asociado actualmente se suprime. Para ejecutar este comando, debe tener los derechos de dispositivo Crear/Suprimir para la carpeta en la que se intenta volver a registrar.

Para volver a registrar, especifique un nombre de usuario y una contraseña:

zac reregister -u miusuario -p micontraseña eaa6a76814d650439c648d597280d5d4

set-pref (set)

Define el valor para una preferencia.

Ejemplo para definir el valor de la preferencia abc como 123:

zac set-pref abc 123

set-proxy (sp) [opciones] <dirección IP/nombre de host:puerto>

Permite especificar un servidor proxy de contacto en lugar de contactar directamente con un servidor ZENworks.

Las opciones son:

  • ‑‑default - Establece un servidor proxy que se puede anular mediante los ajustes de proxy de la zona de gestión.
  • ‑‑clear - Borra el servidor proxy actual, pero utiliza los ajustes de proxy de la zona de gestión.
  • --ipv6 - Establece un servidor proxy IPv6.

Ejemplos:

IPv4:

zac sp 123.456.78.90:2349 administrator novell

zac sp /default 123.456.78.90:2349

zac sp /clear

IPv6:

zac sp /ipv6 [2001:db8:0:1:1:1:1:1]:2349 administrator novell

Si no se especifica un nombre de usuario y una contraseña, se le pedirá que introduzca esos datos.

unregister (unr)

Este comando anula el registro de un dispositivo de la zona actual.

Para ejecutar este comando, debe tener los derechos de dispositivo Crear/Suprimir para la carpeta cuyo registro intenta anular.

Ejemplo:

zac unr -u administrador -p novell

NOTA:al ejecutar el comando UNR se produce un uso elevado de la base de datos. Esto puede deberse a uno de los siguientes motivos:

  • El comando UNR se ejecuta en el servidor.

  • La zona contiene un gran número de dispositivos gestionados.

  • Los dispositivos gestionados tienen una historia enorme.

  • Está habilitada la gestión de parches.

zone-config (zc)

Este comando muestra el servidor de configuración de zonas o la configuración de zonas actual.

zac zc

Comandos de inventario

inventory (inv) [scannow]

Ejecuta un escáner de inventario.

Ejemplo para ejecutar un escáner de inventario:

zac inv scannow

Comandos solo de inventario

Estos comandos se usan solo para los agentes de solo inventario (IOA).

zac ioa cfg <IP del servidor>

Configura el dispositivo de IOA de Mac en la IP de servidor mencionada.

Un ejemplo para registrar un dispositivo de solo inventario de MAC para el servidor <10.70.13.124>

zac ioa cfg 10.70.13.124

zac ioa version

Muestra la versión del agente de solo inventario (IOA).

inventory (inv) [scannow]

Ejecuta un escáner de inventario.

Ejemplo para ejecutar un escáner de inventario:

zac inv scannow

Comandos de gestión de revisiones

patch-scan (ps)

Explora el dispositivo en busca de parches que no se hayan aplicado. Para ello, usa el archivo de firma de parche (DAU) actual del dispositivo. Los resultados se cargan en el servidor.

Ejemplo para ejecutar una exploración de parches:

zac ps

patch-scan ‑‑quick (ps ‑‑quick)

Carga los resultados de la última exploración en el servidor. No ejecuta una exploración de detección nueva.

Ejemplo para ejecutar una exploración de parches rápida:

zac ps ‑‑quick

patch-apply-policy (pap)

Actualiza los dispositivos con la versión más reciente de todas las directivas de parches.

Ejemplo para ejecutar una directiva de aplicación de parches:

zac pap

patch-quarantine-release (pqr)

Libera todos los parches en cuarentena en el dispositivo donde se ejecuta el comando para que se pueda realizar un único intento de instalación, ya sea mediante una programación de directiva de parches o una programación de correcciones.

Ejemplo para ejecutar una liberación de cuarentena de parches:

zac pqr

Comandos de funciones de satélite

satellite-cachecfg (satcfg)

Lee las funciones de satélite del caché.

Ejemplo para leer las funciones de satélite del caché:

zac satcfg

satellite-clearcache (satcc)

Borra la información de configuración de satélite del caché.

Ejemplo para borrar la información de configuración del satélite del caché:

zac satcc

satellite-refreshcfg (satrc)

Actualiza las funciones de satélite.

Ejemplo para actualizar las funciones de satélite:

zac satrc

satellite-roles (satr)

Informa sobre las funciones de satélite en uso y su estado.

Ejemplo para crear un informe sobre las funciones de satélite actuales y sus estados:

zac satr

Comandos de estado

zenhttp-status (zhs)

Muestra una lista de puertos y etiquetas de los gestores registrados.

Ejemplo para mostrar los puertos y etiquetas de los gestores registrados:

zac zhs

Este comando solo es aplicable si el agente sube de nivel a satélite.

Comandos de actualización del sistema

zac zeus-refresh / zeus-ref

Recupera la actualización del sistema cuando se asigna a un dispositivo.

Comandos de certificado de ZENworks

zac certificate-verify / cv

Verifica si el certificado de servidor y el archivo de clave copiados en el repositorio de reacuñación son válidos y actualiza los resultados del servidor.