zac - L'interfaccia di gestione da riga di comando per l'agente Micro Focus ZENworks installato e in esecuzione sui dispositivi gestiti Macintosh.
zac command options
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.
Questa sezione fornisce una descrizione generale della formattazione e delle convenzioni.
La maggior parte dei comandi ha un formato esteso e un formato breve:
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"
Gli argomenti racchiusi tra parentesi ( ) sono obbligatori, mentre quelli racchiusi tra parentesi quadre [ ] sono facoltativi.
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)].
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
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
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
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.
Elenca i blocchi del pacchetto. I blocchi pacchetti vengono ordinati per numero di ID.
Esempio in cui vengono elencati i pacchetti bloccati:
zac bll
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
Restituisce le informazioni relative alle proprietà di un pacchetto.
Esempio di recupero delle proprietà del pacchetto specificato:
zac bp MacBundle
Aggiorna le informazioni sul pacchetto specificato.
Esempio di aggiornamento di un pacchetto:
zac br MacBundle
Ricerca i pacchetti corrispondenti alla stringa o all'espressione regolare Java specificata.
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
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
Questo comando consente di registrare un dispositivo utilizzando la chiave di registrazione specificata.
Esempio: zac add-reg-key
Questo comando fornisce informazioni sull'agente ZENworks.
Esempio: zac agent-properties
Svuota la cache sul dispositivo.
Esempio: zac cc
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
Visualizza l'ubicazione attuale.
Esempio:
zac config-location
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
Visualizza le preferenze attualmente impostate.
Ad esempio, per visualizzare tutte le preferenze le cui denominazioni iniziano con "abc":
zac get-pref abc
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.
Modifica la configurazione del logger.
Sono disponibili le seguenti opzioni:
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
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.
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
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
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
Imposta il valore per una preferenza.
Ad esempio, per impostare il valore della preferenza "abc" su "123":
zac set-pref abc 123
Specifica un proxy da contattare invece di contattare direttamente un server ZENworks.
Le opzioni disponibili includono:
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.
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.
Questo comando consente di visualizzare il server di configurazione della zona oppure di elencare la configurazione della zona attuale.
zac zc
Esegue una scansione dell'inventario.
Esempio di esecuzione di una scansione dell'inventario:
zac inv scannow
Questi comandi vengono utilizzati solo per gli agenti IOA (Inventory-Only Agent).
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
Visualizza la versione dell'agente IOA (Inventory-Only Agent).
Esegue una scansione dell'inventario.
Esempio di esecuzione di una scansione dell'inventario:
zac inv scannow
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
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
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
Aggiorna i dispositivi con l'ultima versione di tutte le policy patch.
Esempio di esecuzione di una policy di applicazione patch:
zac pap
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
Legge i ruoli del satellite dalla cache.
Esempio di lettura dei ruoli del satellite dalla cache:
zac satcfg
Elimina le informazioni di configurazione del satellite dalla cache.
Esempio di eliminazione delle informazioni di configurazione del satellite dalla cache:
zac satcc
Aggiorna i ruoli del satellite.
Esempio di aggiornamento dei ruoli del satellite:
zac satrc
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
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.
Recupera gli aggiornamenti di sistema quando vengono assegnati al dispositivo.
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.