zac per Macintosh (1)

Name

zac - L'interfaccia di gestione da riga di comando per l'agente Micro Focus ZENworks installato e in esecuzione sui dispositivi gestiti Macintosh.

Sintassi

zac command options

Descrizione

L'utility zac svolge funzioni di gestione della riga di comando sul dispositivo gestito ZENworks, ossia installazione e rimozione di pacchetti software, applicazione di policy, registrazione e annullamento della registrazione del dispositivo.

Guida per l'uso

Questa sezione fornisce una descrizione generale della formattazione e delle convenzioni.

La maggior parte dei comandi ha un formato esteso e un formato breve:

  • Forma estesa: add-reg-key
  • Forma abbreviata: ark

Laddove entrambi i formati siano disponibili, il comando viene indicato come segue:

add-reg-key (ark) opzioni

Quando si utilizza il comando, immettere solo il formato esteso o solo il formato breve:

zac add-reg-key opzioni

zac ark opzioni

Se un'opzione comprende uno spazio, è necessario indicarla fra virgolette:

zac ark "opzione 1"

Argomenti obbligatori e facoltativi

Gli argomenti racchiusi tra parentesi ( ) sono obbligatori, mentre quelli racchiusi tra parentesi quadre [ ] sono facoltativi.

Ellissi (...)

L'ellissi indica che il comando può accettare più voci dell'ultimo tipo di argomento. Gli argomenti devono essere separati da uno spazio o da virgole, a seconda del comando. Ad esempio:

zman server-add-bundle [opzioni] (server) (pacchetto) [...]

I punti di sospensione indicano che server-add-bundle può accettare più pacchetti. Per maggiore chiarezza nella guida dei comandi, le voci multiple sono indicate nel formato [(pacchetto) (pacchetto) ... (pacchetto)].

Comandi per i pacchetti

bundle-install (bin)

Installa i pacchetti specificati in base al nome visualizzato che corrisponde alla stringa o all'espressione regolare specificata oppure al GUID del pacchetto.

Utilizzare il comando bundle-list per ottenere l'elenco dei pacchetti disponibili e dei loro nomi visualizzati.

Esempio di installazione di un pacchetto:

zac bin MacBundle

bundle-launch (bln)

Avvia il pacchetto specificato. Vengono eseguite le azioni del gruppo di azioni di avvio. Se si tenta di avviare un pacchetto che non è stato installato, il pacchetto viene prima installato e quindi avviato.

Utilizzare il comando bundle-list per ottenere l'elenco dei pacchetti disponibili e dei loro nomi visualizzati.

Esempio di avvio di un pacchetto basato sul nome visualizzato:

zac bln MacBundle

bundle-list (bl)

Visualizza l'elenco di pacchetti assegnati al dispositivo e all'utente che ha eseguito il login.

L'output di questo comando viene visualizzato in colonne e fornisce i dettagli di ogni pacchetto assegnato o disponibile per il dispositivo gestito. Le colonne Nome visualizzato, Versione e Tipo pacchetto rappresentano rispettivamente il nome visualizzato del pacchetto, il numero di versione del pacchetto o sandbox se il pacchetto è una versione sandbox e il tipo di pacchetto.

Nella colonna Stato vengono visualizzati i seguenti stati:

Disponibile: visualizza questo stato se è stato installato il pacchetto.

Non installato: visualizza questo stato se non è stata installata la versione specifica del pacchetto.

Download effettuato: visualizza questo stato se è stato eseguito il download del contenuto ma l'azione del gruppo di azioni di avvio non è stata eseguita.

Un esempio in cui vengono elencati tutti i pacchetti:

zac bl

bundle-lock-add (bla) [opzioni] [nome pacchetto] [...]

Blocca l'aggiornamento o la rimozione dei pacchetti specificati che corrispondono alla stringa o all'espressione regolare specificata.

i blocchi del pacchetto sono applicabili solo per il gruppo di azioni di installazione.

Accetta le seguenti opzioni:

-li, --lock-install - Blocca il pacchetto e impedisce l'installazione del pacchetto specificato nel blocco.

-t, --type - Specificare il tipo di pacchetto da bloccare. I tipi disponibili sono MAC e Patch. Se non viene specificato un tipo, viene selezionato il tipo di pacchetto di default.

bundle-lock-list (bll)

Elenca i blocchi del pacchetto. I blocchi pacchetti vengono ordinati per numero di ID.

Esempio in cui vengono elencati i pacchetti bloccati:

zac bll

bundle-lock-remove (blr)

Rimuove il blocco pacchetti specificato in base al numero. Per trovare il numero di ogni blocco, è possibile utilizzare il comando bundle-lock-list.

Esempio di rimozione di tutti i blocchi pacchetti:

zac blr --remove-all

bundle-props (bp)

Restituisce le informazioni relative alle proprietà di un pacchetto.

Esempio di recupero delle proprietà del pacchetto specificato:

zac bp MacBundle

bundle-refresh (br)

Aggiorna le informazioni sul pacchetto specificato.

Esempio di aggiornamento di un pacchetto:

zac br MacBundle

bundle-search (bse)

Ricerca i pacchetti corrispondenti alla stringa o all'espressione regolare Java specificata.

bundle-uninstall (bu)

Disinstalla il pacchetto specificato. Le azioni che supportano l'azione Annulla vengono eseguite durante la disinstallazione del pacchetto. Una volta completata tale disinstallazione, come stato del pacchetto viene visualizzato Non installato.

Utilizzare il comando bundle-list per ottenere l'elenco dei pacchetti installati e i loro nomi visualizzati.

Esempio di disinstallazione di un pacchetto:

zac bu MacBundle

bundle-verify (bv)

Reinstalla il pacchetto ed esegue i gruppi di azioni Verifica per controllare che non sia stato rimosso o danneggiato alcun file. Utilizzare il comando bundle-list per ottenere l'elenco dei pacchetti installati e i loro nomi visualizzati.

Esempio di verifica di un pacchetto:

zac bv MacBundle

Comandi core

add-reg-key (ark)

Questo comando consente di registrare un dispositivo utilizzando la chiave di registrazione specificata.

Esempio: zac add-reg-key

agent-properties (agp)

Questo comando fornisce informazioni sull'agente ZENworks.

Esempio: zac agent-properties

cache-clear (cc)

Svuota la cache sul dispositivo.

Esempio: zac cc

cert-info (ci)

Elenca le informazioni sul certificato a chiave pubblica per ciascun server ZCM noto o aggiunge un certificato radice attendibile all'archivio del computer.

Esempio:

Per elencare il certificato per ciascun utente ZENworks noto:

zac ci

Per aggiungere un certificato radice attendibile all'archivio attendibile dei dispositivi:

zac ci <ubicazione> -u myuser -p mypassword

config-location (cl)

Visualizza l'ubicazione attuale.

Esempio:

zac config-location

file-system-guid (fsg)

Rimuove e ripristina il GUID della workstation nel file system prima di acquisire un'immagine.

Esempio:

Per visualizzare il valore GUID:

zac fsg

Per rimuovere il GUID e conninfo.dat from dal file system:

zac file-system-guid -d

Per ripristinare il GUID nel file system:

zac file-system-guid -r

Non specificare un'opzione per stampare il valore GUID:

zac fsg

get-pref (get)

Visualizza le preferenze attualmente impostate.

Ad esempio, per visualizzare tutte le preferenze le cui denominazioni iniziano con "abc":

zac get-pref abc

get-settings (gs)

Dopo ogni aggiornamento viene effettuato il download delle impostazioni dal modulo impostazioni nella cache locale. Questa operazione restituisce le impostazioni effettive associate alla chiave specificata.

Esempio:

zac gs chiave1

È inoltre possibile utilizzare il comando get-settings (gs) per elencare le impostazioni utilizzando chiavi diverse. Per ulteriori informazioni, vedere get-settings (gs) <chiave> nella sezione Comandi di stato.

logger [resetlog | livello [GESTITO|ERRORE|AVVISA|INFO|DEBUG] |managedlevel]

Modifica la configurazione del logger.

Sono disponibili le seguenti opzioni:

  • resetlog - Reimposta il log.
  • level - Se usato senza un livello, visualizza il livello di log correntemente gestito. Se usato con uno dei livelli, imposta il livello di log su quello specificato.
  • managedlevel - Visualizza il livello log globale della zona.

Esempio per reimpostare il file di log:

zac logger resetlog

Esempio per visualizzare il livello di log attuale:

zac logger level

Esempio per impostare il livello di log su DEBUG e superiore:

zac logger level DEBUG

reestablish-trust (retr)

Questo comando consente di ristabilire l'attendibilità con la zona attuale.

Ristabilisce l'attendibilità con la zona di gestione corrente. Nome utente e password utilizzati devono corrispondere a quelli dell'amministratore della zona.

Esempio:

zac retr -u utente -p password

I parametri -u e -p sono facoltativi. Se non si utilizzano i parametri -u e -p, verrà chiesto di immettere un nome utente e una password.

refresh (ref)[general | partial bundle <Nome visualizzato pacchetto> [bypasscache]

Avvia un aggiornamento generale di tutte le impostazioni di pacchetti, policy, registrazione e configurazione; avvia un aggiornamento parziale di tutte le impostazioni di policy, registrazione e configurazione.

Mediante il comando bypasscache è possibile evitare di utilizzare i dati della cache del server durante l'aggiornamento. Questa opzione è utile per i test o la soluzione dei problemi.

Esempi:

zac ref general bypasscache

zac ref partial bypasscache

register (reg)

Questo comando consente di registrare un dispositivo nella zona specificata.

Per eseguire questo comando, è necessario disporre dei diritti dispositivo Crea/Cancella per la cartella sulla quale si sta tentando di eseguire la registrazione.

Esempio:

zac reg -k key1 https://123.456.78.90

reregister (rereg)

Questo comando consente di registrare un dispositivo nella zona attuale e di assegnarlo al GUID di un oggetto dispositivo esistente. L'oggetto Dispositivo attualmente associato viene cancellato. Per eseguire questo comando, è necessario disporre dei diritti dispositivo Crea/Cancella per la cartella sulla quale si sta tentando di eseguire di nuovo la registrazione.

Per effettuare di nuovo la registrazione, specificare un nome utente e una password:

zac reregister -u myuser -p mypassword eaa6a76814d650439c648d597280d5d4

set-pref (set)

Imposta il valore per una preferenza.

Ad esempio, per impostare il valore della preferenza "abc" su "123":

zac set-pref abc 123

set-proxy (sp) [opzioni] <indirizzo IP/Nome host:porta>

Specifica un proxy da contattare invece di contattare direttamente un server ZENworks.

Le opzioni disponibili includono:

  • --default - Imposta un proxy che può essere ignorato dalle impostazioni del proxy della zona di gestione.
  • --clear - Elimina il proxy attuale, ma utilizzerà le impostazioni del proxy della Zona di gestione.
  • --ipv6 - imposta un proxy IPv6.

Esempi:

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

Se non nome utente e password non sono specificati, verrà richiesto di immetterli.

unregister (unr)

Questo comando consente di annullare la registrazione di un dispositivo dalla zona attuale.

Per eseguire questo comando, è necessario disporre dei diritti dispositivo Crea/Cancella per la cartella sulla quale si sta tentando di annullare la registrazione.

Esempio:

zac unr -u administrator -p novell

NOTA:l'esecuzione del comando UNR può causare l'utilizzo del database. Ciò può essere dovuto a uno dei seguenti motivi:

  • Il comando UNR è in esecuzione sul server.

  • La zona contiene un numero elevato di dispositivi gestiti.

  • I dispositivi gestiti contengono una cronologia molto lunga.

  • La gestione delle patch è disabilitata.

zone-config (zc)

Questo comando consente di visualizzare il server di configurazione della zona oppure di elencare la configurazione della zona attuale.

zac zc

Comandi per l'inventario

inventory (inv) [scannow]

Esegue una scansione dell'inventario.

Esempio di esecuzione di una scansione dell'inventario:

zac inv scannow

Comandi solo per l'inventario

Questi comandi vengono utilizzati solo per gli agenti IOA (Inventory-Only Agent).

zac ioa cfg <IP server>

Configura il dispositivo IOA MAC sull'IP del server specificato.

Esempio di registrazione di un dispositivo MAC solo inventario nel server <10.70.13.124>

zac ioa cfg 10.70.13.124

zac ioa version

Visualizza la versione dell'agente IOA (Inventory-Only Agent).

inventory (inv) [scannow]

Esegue una scansione dell'inventario.

Esempio di esecuzione di una scansione dell'inventario:

zac inv scannow

Comandi per la gestione delle patch

patch-scan (ps)

Esegue la scansione del dispositivo per le patch non applicate utilizzando l'attuale file di firma (DAU) patch del dispositivo. Viene quindi effettuato l'upload dei risultati nel server.

Esempio di esecuzione di una scansione per la ricerca di patch:

zac ps

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

Effettua l'upload dei risultati dell'ultima scansione nel server; non esegue una nuova scansione di rilevamento.

Esempio di esecuzione di una scansione rapida per la ricerca di patch:

zac ps --quick

patch-scan --complete (ps --complete)

Esegue la scansione del dispositivo per le patch non applicate utilizzando un file di firma (DAU) patch aggiornato. Viene quindi effettuato l'upload dei risultati nel server.

Esempio di esecuzione di una scansione completa per la ricerca di patch:

zac ps --complete

patch-apply-policy (pap)

Aggiorna i dispositivi con l'ultima versione di tutte le policy patch.

Esempio di esecuzione di una policy di applicazione patch:

zac pap

patch-quarantine-release (pqr)

Rilascia eventuali patch in quarantena sul dispositivo in cui il comando viene eseguito dalla quarantena per consentire un tentativo di installazione con singola occorrenza da una pianificazione di policy per la patch o di soluzioni.

Esempio di esecuzione di un rilascio di patch dalla quarantena:

zac pq

Comandi per i ruoli del satellite

satellite-cachecfg (satcfg)

Legge i ruoli del satellite dalla cache.

Esempio di lettura dei ruoli del satellite dalla cache:

zac satcfg

satellite-clearcache (satcc)

Elimina le informazioni di configurazione del satellite dalla cache.

Esempio di eliminazione delle informazioni di configurazione del satellite dalla cache:

zac satcc

satellite-refreshcfg (satrc)

Aggiorna i ruoli del satellite.

Esempio di aggiornamento dei ruoli del satellite:

zac satrc

satellite-roles (satr)

Visualizza un rapporto sui ruoli correnti del satellite e sul loro stato.

Esempio di visualizzazione di un report sui ruoli attuali del satellite e sul relativo stato:

zac satr

Comandi di stato

zenhttp-status(zhs)

Elenca la porta e i tag dei gestori registrati.

Esempio in cui vengono elencati la porta e i tag per i gestori registrati:

zac zhs

Questo comando è applicabile solo se l'agente è promosso a satellite.

Comandi per l'aggiornamento di sistema

zac zeus-refresh / zeus-ref

Recupera gli aggiornamenti di sistema quando vengono assegnati al dispositivo.

Comandi dei certificati ZENworks

zac certificate-verify / cv

Verifica che il certificato del server e il file della chiave copiati nell'archivio di creazione del nuovo certificato siano validi e aggiorna i risultati nel server.