zac - Die Befehlszeilen-Verwaltungsschnittstelle für den Micro Focus ZENworks Agent, der auf unter Windows verwalteten Geräten installiert ist und ausgeführt wird.
zac command options
Das Dienstprogramm zac führt Befehlszeilen-Verwaltungsfunktionen auf dem verwalteten ZENworks-Gerät aus. Hierzu zählen die Installation und Deinstallation von Software-Bundles, die Anwendung von Richtlinien und die Registrierung des Geräts bzw. die Aufhebung von dessen Registrierung.
Die meisten Befehle stehen in Langform und in Kurzform zur Verfügung:
Langform: add-reg-key
Kurzform: ark
Wenn beide Formen möglich sind, wird der Befehl wie folgt aufgeführt:
add-reg-key (ark)-Argumente
Bei der Eingabe des Befehls dürfen Sie nur die lange oder nur die kurze, nicht aber beide Formen verwenden:
zac add-reg-key-Argumente
zac ark-Argumente
Argumente können erforderlich oder optional sein. Erforderliche Argumente sind in spitze Klammern eingeschlossen: <Argument>. Optionale Argumente sind in eckige Klammern eingeschlossen: [Argument]. Wenn ein Argument ein Leerzeichen enthält, muss das gesamte Argument in Anführungszeichen stehen:
zac ark „Arg 1“
Konfiguriert einen bereits aktivierten Satelliten mit der Rolle „Authentifizierung“ neu.
Beispiele:
So rufen Sie die Konfigurationsdateien vom Server ab:
zac asr -t config
So konfigurieren Sie das Zertifikat zum Signieren von CASA neu:
zac asr -t casa
So konfigurieren Sie den gesamten Satelliten neu:
zac asr -t all -u Administrator -p Passwort
Wenn Benutzername und Passwort erforderlich, aber nicht in der Befehlszeile angegeben sind, werden Sie danach gefragt.
Konfiguriert den Jetty-Webserver neu.
So konfigurieren Sie den Jetty-Webserver neu:
zac ssr -t jetty -u Administrator -p Passwort
Konfiguriert ein Satellitengerät mit extern signierten Zertifikaten.
-rc – bestätigt die Neukonfiguration des Satellitenservers, sodass der Administrator nicht zur erneuten Konfiguration aufgefordert wird.
Installiert das angegebene Bundle. Verwenden Sie den Befehl bundle-list, um eine Liste der verfügbaren Bundles und deren Anzeigenamen abzurufen.
Beispiel:
zac bin Bundle1
Startet das angegebene Bundle. Verwenden Sie den Befehl bundle-list, um eine Liste der verfügbaren Bundles und deren Anzeigenamen abzurufen.
Beispiel für das Starten eines Bundles auf der Basis des Anzeigenamens:
zac bln bundle1
Beispiel für das Starten eines Bundles auf der Basis des Anzeigenamens und das Deaktivieren der Selbstreparatur des Bundles bei einem Fehler in der Aufrufaktion (standardmäßig ist die Selbstreparatur aktiviert):
zac bln bundle1 -noSelfHeal
Zeigt die Liste der Bundles an, die dem Gerät und dem angemeldeten Benutzer zugewiesen sind.
Beispiel:
zac bl
Zeigt die Informationen zu Status, Version, GUID und Anforderungen für das angegebene Bundle an. Verwenden Sie den Befehl bundle-list, um eine Liste der verfügbaren Bundles und deren Anzeigenamen abzurufen.
Beispiel:
zac bln Bundle1
Aktualisiert die Informationen zu dem angegebenen Bundle.
Beispiel:
zac br bundle1
Deinstalliert das angegebene Bundle. Verwenden Sie den Befehl bundle-list, um eine Liste der installierten Bundles und deren Anzeigenamen abzurufen.
Beispiel:
zac bu Bundle1
Überprüft ein installiertes Bundle (angegeben anhand des Bundle-Anzeigenamen), um sicher zu stellen, dass keine Dateien entfernt wurden oder beschädigt sind. Verwenden Sie den Befehl bundle-list, um eine Liste der installierten Bundles und deren Anzeigenamen abzurufen.
Beispiel:
zac bv Bundle1
Listet Informationen zum Zertifikat mit öffentlichem Schlüssel für die einzelnen bekannten ZENworks-Server auf bzw. fügt ein vertrauenswürdiges Stammzertifikat zum vertrauenswürdigen Speicher des Geräts hinzu. Die Datei kann das Format ASN.1 DER aufweisen oder base-64-verschlüsselt sein mit den Begrenzungen ‑‑‑‑BEGIN CERTIFICATE‑‑‑‑ und ‑‑‑‑END CERTIFICATE‑‑.
Beispiel:
So listen Sie die Zertifikate für die einzelnen bekannten ZENworks-Server auf:
zac ci
So fügen Sie ein vertrauenswürdiges Stammzertifikat zum vertrauenswürdigen Speicher der Geräte hinzu:
zac ci c:\certs\mytrustcacert.der -u myuser -p mypassword
Überprüft, ob das in das Neuzusammenstellungs-Repository kopierte Serverzertifikat und die Schlüsseldatei gültig sind und gibt die Ergebnisse an den Server weiter.
Zeigt den Status und die Konfiguration der Erfassungsrolle.
Beispiel:
collection-point [wake]
wake – Weckt das Modul auf, das die Erfassung durchführt (Inventar, MD-Status, Nachrichtensender)
Sucht auf dem Satellitengerät nach nicht mehr verwendeten Dateien und führt dafür ein Rollup an den übergeordneten Erfassungsserver durch bzw. löscht die Dateien, falls bereits ein Rollup dafür durchgeführt wurde.
Mit diesem Befehl wird eine Liste der Dateien in den Ordnern unter%zenworks_home%\work\collection erstellt; anschließend werden Informationen zum ursprünglichen Upload für die einzelnen Einträge in der Erfassungsstatusdatenbank gesucht.
Wenn in der Datenbank ein Eintrag für eine Datei vorhanden ist und es sich herausstellt, dass für die Datei kein Rollup durchgeführt wurde, so wird der Datei-Rollup nun durchgeführt. Wenn der Eintrag zeigt, dass bereits ein Rollup für die Datei durchgeführt wurde, wird die Datei am Satellitengerät gelöscht. Wenn in der Datenbank kein Eintrag für eine Datei vorhanden ist, wird ein Rollup für die Datei durchgeführt. Dieser Befehl führt auch alle Dateien auf, die nicht hochgeladen oder gelöscht wurden.
Bevor Sie diesen Befehl ausführen, sollten Sie den Befehl zac crw ausführen, um alle ausstehenden Dateien an den übergeordneten Server zu senden.
Beispiel:
zac cuo
Überprüft den Inhalt des Satelliten durch Berechnen der Prüfsumme jeder einzelnen Datei.
Die optionalen Protokolldatei-Details ergeben sich aus dem Prüfsummenvergleich.
Beispiel:
zac cchk -l:"C:\Programme\Novell\ZENworks\logs\cchk.log"
Vergleicht die Liste der Inhalts-IDs und deren Synchronisierungsstatusinformationen auf diesem CDP mit den Informationen, die dieser laut Primärserver haben sollte.
Sie können folgende Optionen verwenden:
Beispiel:
zac cvc -l:"C:\Programme\Novell\ZENworks\logs\cvc.log"
Importiert fehlende Inhalte aus dem durch „Inhaltspfad“ angegebenen Verzeichnis, wobei Meldungen in der durch „Protokollpfad“ angegebenen Datei aufgezeichnet werden.
Beispiel:
zac cic c:\Quellverzeichnis_importieren -l:„C:\Programme\Novell\ZENworks\logs\cic.log"
Reaktiviert den Arbeitsthread des Inhaltsverteilungspunkts. Sie können eine der folgenden Optionen verwenden:
Beispiele:
zac cdp
zac cdp replicate
Dieser Befehl kann nur verwendet werden, wenn dem Agenten die Rolle eines Satelliten zugewiesen wurde.
Führt ein Rollup für diejenigen Statusmeldungen an die MDStatus-Datenbank durch, die seit dem letzten erfolgreichen Rollup des Status aktualisiert wurden. Standardmäßig führt der Statussender alle 5 Minuten einen automatischen Rollup durch.
Die MDStatus-Datenbank wird dazu verwendet, den Bundle- und Richtlinienstatus vom verwalteten Gerät zum ZENworks-Server zu übertragen.
Zeigt die Arbeitsstations-GUID im Dateisystem an, entfernt sie oder stellt sie wieder her (zur Vorbereitung auf die Erstellung eines Image).
Beispiel:
So zeigen Sie den GUID-Wert an:
zac fsg
So entfernen Sie die GUID und die Datei conninfo.dat aus dem Dateisystem:
zac file-system-guid -d
So stellen Sie die GUID im Dateisystem wieder her:
zac file-system-guid -r
So zeigen Sie den GUID-Wert an:
zac fsg
Führt eine Inventarabsuche aus oder öffnet das Erfassungsdatenformular.
Beispiel für die Ausführung einer Inventarabsuche:
zac inv scannow
Beispiel für das Öffnen eines Erfassungsdatenformulars:
zac inv cdf
Beispiel zum Ausführen einer Komplettabsuche:
zac inv -f scannow
Zeigt den Konfigurationsstandort an. Der Konfigurationsstandort bestimmt den ZENworks-Server (bzw. auch mehrere Server), zu dem das Gerät zu Authentifizierungs-, Konfigurations-, Inhalts- und Erfassungszwecken eine Verbindung herstellt.
Beispiele:
zac config-location
zac cl
Bearbeitet einen vorhandenen Standort.
<Standortname>: Geben Sie einen Namen für den Standort an.
Akzeptiert die folgenden Optionen:
IPv4: Wenn die Geräte an diesem Standort zunächst über IPv4-URLs und dann erst über IPv6-URLs mit den Servern kommunizieren sollen, geben Sie IPv4 an.
IPv6: Wenn die Geräte an diesem Standort zunächst über IPv6-URLs und dann erst über IPv4-URLs mit den Servern kommunizieren sollen, geben Sie IPv6 an.
Ändert oder konfiguriert die Konfiguration der Protokollierung für ZENworks Agent.
Sie können folgende Optionen verwenden:
Beispiel (Zurücksetzen der Protokolldatei):
zac logger resetlog
Beispiel (Anzeigen des aktuellen Protokollierumfangs):
zac logger level
Beispiel (Einstellen des Protokollierumfangs auf DEBUG und höher):
zac logger level DEBUG
Zeigt den ostarget-Datensatz für das Betriebssystem der Arbeitsstation oder eine definierte Versionszeichenfolge an.
Beispiele:
Versionszeichenfolge und zugehörige ostarget-Informationen für die Arbeitsstation anzeigen:
zac ostarget
Zugehörige ostarget-Informationen für eine bestimmte Versionszeichenfolge anzeigen:
zac ostarget "Windows XP Professional Service Pack 2 (Build 2600)"
Sucht das Gerät anhand der aktuellen Patch-Signaturdatei (DAU) nach Patches ab, die noch nicht angewendet wurden. Die Ergebnisse werden dann auf den Server hochgeladen.
Beispiel für die Ausführung einer Patchdurchsuchung:
zac ps
Lädt die letzten Absuchergebnisse auf den Server hoch; es wird keine neue Erkennungsabsuche ausgeführt.
Beispiel für die Ausführung einer Schnell-Patchdurchsuchung:
zac ps ‑‑quick
Aktualisiert die Geräte mit der aktuellen Version aller Patch-Richtlinien.
Beispiel für die Ausführung einer Patch-Ausführungs-Richtlinie:
zac pap
Gibt alle Patches aus der Quarantäne auf dem Gerät frei, auf dem der Befehl ausgeführt wurde, sodass ein einmaliger Installationsversuch gestartet werden kann, entweder über einen Patch-Richtlinienzeitplan oder über einen Fehlerbehebungszeitplan.
Beispiel für die Ausführung einer Freigabe von Patches aus der Quarantäne:
zac pqr
Listet die Richtlinien auf, die zurzeit auf dem Gerät durchgesetzt werden (wirksame Richtlinien). Verwenden Sie die Option „‑‑all“, um alle Richtlinien (wirksame und nicht wirksame) aufzulisten.
Beispiele:
zac pl
zac pl ‑‑all
Wendet alle Richtlinien an, die dem Gerät und dem Benutzer zugewiesen sind.
Beispiel:
zac pr
Registriert das Gerät mithilfe des angegebenen Schlüssels. Ein Gerät kann auch mit mehreren Schlüsseln registriert werden. Wenn das Gerät bereits mit einem Schlüssel registriert wurde und Sie es danach mit einem neuen Schlüssel registrieren, erhält das Gerät die Gruppenzuweisungen beider Schlüssel.
Beispiel:
zac ark Schlüssel12
Registriert das Gerät in einer Verwaltungszone.
Zum Ausführen dieses Befehls benötigen Sie die Geräterechte Erstellen/Löschen für den zu registrierenden Ordner.
Sie können folgende Optionen verwenden:
Beispiele:
zac reg -k Schlüssel1 https://123.456.78.90
zac reg -k Schlüssel1 -u Administrator -p novell https://zenserver.novell.com:8080
Die Portnummer ist nur erforderlich, wenn der ZENworks-Server nicht den Standard-HTTP-Port (80) verwendet. Wenn der Benutzername und das Passwort nicht angegeben sind, werden Sie zur Eingabe aufgefordert.
Registriert ein Gerät in der aktuellen Zone und weist es der GUID eines vorhandenen Geräteobjekts zu. Das aktuell zugeordnete Geräteobjekt wird gelöscht.
Zum Ausführen dieses Befehls benötigen Sie die Geräterechte Erstellen/Löschen für den zu registrierenden Ordner.
Wenn Sie beispielsweise nach dem Austausch der Festplatte ein Image für ein Gerät erstellen, erhält das Gerät möglicherweise eine neue GUID. Wenn Sie jedoch den Befehl zur Neuregistrierung verwenden, können Sie die GUID des Geräts zuweisen, die es vor Austausch der Festplatte hatte.
Beispiele:
Geben Sie zur Neuregistrierung einen Benutzernamen und ein Passwort an:
zac reregister -u myuser -p mypassword eaa6a76814d650439c648d597280d5d4
So registrieren Sie das Gerät neu und werden aufgefordert, einen Benutzernamen und ein Passwort einzugeben:
zac reregister eaa6a76814d650439c648d597280d5d4
HINWEIS:Die Optionen -g und -k werden nicht berücksichtigt, wenn das entsprechende Geräteobjekt bereits auf dem Server vorhanden ist und ein Abgleich mit diesem Geräteobjekt stattfindet.
Entfernt die Registrierung des Geräts aus der Verwaltungszone.
Zum Ausführen dieses Befehls benötigen Sie die Geräterechte Erstellen/Löschen für den Ordner, dessen Registrierung aufgehoben werden soll.
Beispiel:
So erzwingen Sie das Aufheben der Registrierung lokal, wenn keine Verbindung mit dem Server hergestellt werden kann:
zac unr -f -u myuser -p mypassword
So können Sie die Registrierung lokal aufheben und die Aufforderung zur Eingabe eines Benutzernamens und Passworts unterdrücken:
zac unr -s
Zum asynchronen Aufheben Ihrer Registrierung verwenden Sie die Option -a. Mit dieser Option löscht der Server das Gerät asynchron.
Die Parameter -a, -f, -u und -p sind optional. Wenn Sie die Parameter -u und -p nicht verwenden, werden Sie zur Eingabe von Benutzername und Passwort aufgefordert. Der Parameter -f ignoriert die ZENworks-Datenbank und erzwingt die lokale Aufhebung der Registrierung. Diese Option ist nur erforderlich, wenn das Geräteobjekt bereits aus der ZENworks-Datenbank gelöscht wurde oder wenn das Gerät keine Verbindung zur Datenbank herstellen kann. Bei Angabe der Option „-a“ wird der Aufruf zum Aufheben der Registrierung vom ZENworks-Server schnell zurückgegeben, das Geräteobjekt wird jedoch asynchron zu einem späteren Zeitpunkt aus der Datenbank gelöscht. Wenn das Löschen des Geräts nicht vollständig ist und eine erneute Registrierung des Geräts versucht wird, zeigt der ZENworks-Server einen Fehler an. Ist mit dem Gerät in der Datenbank eine große Datenmenge verbunden, kann das Löschen des Geräts einige Zeit dauern. Stellen Sie sicher, dass die Option „-a“ verwendet wird, falls das tatsächliche Löschen des Geräts auf dem Server lange dauert und der Befehl zum Aufheben der Registrierung eine Zeitüberschreitung verursacht.
HINWEIS:Das Ausführen des UNR-Befehls kann zu einer starken Datenbankauslastung führen. Dieser Fall kann aus den folgenden Gründen eintreten:
Der UNR-Befehl wird auf dem Server ausgeführt.
Die Zone enthält eine große Anzahl von verwalteten Geräten.
Die verwalteten Geräte haben einen sehr großen Verlauf.
Die Patch-Verwaltung ist aktiviert.
Definiert die aktuelle Verwaltungszone wieder als verbürgt. Der verwendete Benutzername und das verwendete Passwort müssen vom Zonenadministrator stammen.
Beispiel:
zac retr -u myuser -p mypassword
Die Parameter -u und -p sind optional. Wenn Sie die Parameter -u und -p nicht verwenden, werden Sie zur Eingabe von Benutzername und Passwort aufgefordert.
Fordert eine Fernverwaltungssitzung vom verwalteten Gerät an, auch wenn das Z-Symbol fehlt. Dieser Befehl ist für verwaltete Geräte mit der Version 11.3.1 oder höher verfügbar.
Beispiele:
zac request-remote-session
zac rrs
Löscht den ZENworks-Cache auf dem Gerät. Dadurch werden alle Einträge aus der Cache-Datenbank entfernt und alle diesen Einträgen zugeordneten Cache-Dateien gelöscht.
Beispiel:
zac cc
HINWEIS:Wenn der ZENworks-Administrator die Selbstverteidigungsfunktion für den ZENworks Agent aktiviert hat, müssen Sie ein Überschreibungspasswort angeben, bevor Sie den Befehl zac cc ausführen können. Ansonsten erhalten Sie folgende Meldung:
You do not have permission to clear the cache. Please contact your ZENworks administrator.
Fordern Sie das Überschreibungspasswort beim ZENworks-Administrator an. Falls er kein Überschreibungspasswort festgelegt hat, muss dieses Passwort festgelegt werden, bevor Sie den Befehl verwenden können. Nach Erhalt des Passworts:
Doppelklicken Sie auf das ZENworks-Symbol (z-Symbol) in der Taskleiste, klicken Sie auf Agent (unter Status), und klicken Sie dann auf den Link Policy Override (Richtlinie überschreiben) im Abschnitt Einstellungen für die Agentensicherheit. Das Info-Feld wird angezeigt.
Klicken Sie auf Override Policy (Richtlinie überschreiben), geben Sie das Überschreibungspasswort ein, und klicken Sie auf Überschreiben.
Öffnen Sie eine Befehlszeile, und führen Sie den Befehl zac cc aus.
Sobald der Cache erfolgreich gelöscht wurde, wechseln Sie wieder zurück zum Info-Feld, und klicken Sie auf Load Policy (Richtlinie laden). Damit wird die Passwortüberschreibung deaktiviert.
Gibt die auf den Eigenschaftenseiten des ZENworks-Symbols angezeigten HTML-Seiten in Dateien im angegebenen Zielverzeichnis aus.
Beispiel:
zac dpp c:\temp
Die Einstellungen werden durch das Einstellungsmodul bei jeder Aktualisierung in den lokalen Cache heruntergeladen. Damit werden die geltenden Einstellungen zurückgegeben, die mit dem angegebenen Schlüssel verknüpft sind.
Beispiel:
zac gs Schlüssel1
Alle gültigen ZENworks-Einstellungsschlüssel werden im Verzeichnis %ZENWORKS_HOME%\cache\zmd\settings gespeichert.
Der folgende Befehl listet zum Beispiel die Fernverwaltungseinstellungen auf:
zac gs RemoteManagement
Initiiert eine allgemeine Aktualisierung, um alle Bundle-, Richtlinien-, Registrierungs- und Konfigurationseinstellungen zu aktualisieren, bzw. initiiert eine teilweise Aktualisierung, um alle Richtlinien-, Registrierungs- und Konfigurationseinstellungen zu aktualisieren.
Verwenden Sie bypasscache, um zu vermeiden, dass Sie Daten vom Servercache während der Aktualisierung verwenden. Diese Option ist hilfreich zu Testzwecken oder zur Fehlersuche.
Beispiele:
zac ref general bypasscache
zac ref partial bypasscache
Gibt einen Proxy an, über den ein Kontakt hergestellt werden kann, statt einen ZENworks-Server direkt zu kontaktieren.
Folgende Optionen sind möglich:
Beispiele:
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
zac sp /default /ipv6 [2001:db8:0:1:1:1:1:1]:2349
zac sp /clear /ipv6
Wenn Benutzername und Passwort nicht angegeben werden, werden Sie aufgefordert, sie einzugeben.
Fragt die Verwaltungszone nach Proxy-Arbeit ab, die diesem Gerät zugewiesen wurde.
Beispiel:
zac wpr
Listet den Port und die Tags für registrierte Behandlungsroutinen auf.
Beispiel:
zac zhs
Dieser Befehl kann nur verwendet werden, wenn dem Agenten die Rolle eines Satelliten zugewiesen wurde.
Erfasst ZENworks-Support-Informationen, einschließlich Cache-Daten, Konfigurationsdaten, Debug-Protokolle, Produktinstallationsinformationen, Aktualisierungszeiten, Statusereignisse und grundlegende Systeminformationen. Die Informationen werden in einer ZIP-Datei verpackt und an dem von Ihnen angegebenen Ort gespeichert. Wenn Sie keinen Speicherort angeben, wird ${TEMP}\zeninfo-${Datum Uhrzeit}.zip für Windows und ${TMPDIR}\zeninfo-${Datum Uhrzeit}.zip für Linux verwendet. Wenn bei einem verwalteten Gerät Probleme auftreten, werden Sie vom technischen Support von Micro Focus möglicherweise dazu aufgefordert, diesen Befehl auszuführen und die daraus resultierende ZIP-Datei an Micro Focus zu senden, damit Ihnen bei der Lösung des Problems geholfen werden kann.
Sie können folgende Option verwenden:
Der Befehl zeninfo kann von den lokalen Administratoren ausgeführt werden. Wenn Sie kein lokaler Administrator sind und den Befehl ausführen, werden Sie vom System aufgefordert, die Administratorberechtigung einzugeben. Sie können auch den Wert der Zeichenkette AllowZenInfoWithoutAdminPwd auf True setzen, wodurch allen Benutzern die Ausführung des Befehls zeninfo gestattet wird. Gehen Sie wie folgt vor, um den Wert der Zeichenkette AllowZenInfoWithoutAdminPwd festzulegen:
Öffnen Sie den Registrierungseditor.
Wechseln Sie zu HKLM\Software\Novell\ZCM\.
Setzen Sie den Wert der Zeichenkette AllowZenInfoWithoutAdminPwd auf True.
ACHTUNG:Wenn der Wert der Zeichenkette AllowZenInfoWithoutAdminPwdauf True gesetzt ist, sind die kritischen Einstellungen und Konfigurationsinformationen von ZENworks Configuration Management auch für Benutzer sichtbar, die keine lokalen Administratoren sind.
Zeigt Informationen zu dem ZENworks-Server an, auf den das Gerät zugreift, um Konfigurationsinformationen zu erhalten (Konfigurationsserver), oder listet die Informationen für den Konfigurationsserver auf.
Beispiele:
zac zc
zac zc -l
Dieser Befehl führt ein Rollup der Statusinformationen an den Primärserver durch. Sie können wahlweise ein Rollup für die Informationen, die seit dem letzten Status-Rollup aktualisiert wurden, oder für die gesamten Statusinformationen durchführen.
Beispiele:
Rollup für Statusinformationen durchführen, die seit dem letzten erfolgreichen Status-Rollup aktualisiert wurden:
zac sts rollup
Rollup für Statusinformationen in demselben Thread durchführen:
zac sts rollup syn
Rollup für die gesamten Statusinformationen durchführen:
zac sts rollup full
HINWEIS:Ab ZENworks 2020 steht der Befehl zac bsr nicht mehr zur Verfügung. Führen Sie das Rollup der Bundle-Statusinformationen mit dem Befehl zac sts durch.
Ruft die Systemaktualisierung ab, wenn sie einem Gerät zugewiesen wird.
Setzt den ZENworks Endpoint Security Management-Cache auf den verwalteten Geräten zurück.