zac (1)

Name

zac - Die Befehlszeilen-Verwaltungsschnittstelle für Novell ZENworks Adaptive Agent.

Syntax

zac command options

Beschreibung

Das zac-Dienstprogramm führt Befehlszeilen-Verwaltungsfunktionen auf dem verwalteten ZENworks-Gerät aus, einschließlich Installieren und Entfernen von Software-Bundles, Anwenden von Richtlinien und Registrierung und Registrierungsaufhebung des Geräts.

Anleitung zur Verwendung der Befehle

Die meisten Befehle stehen in Langform und in Kurzform zur Verfügung:

  • Langform: add-reg-key

  • Kurzform: ark

Wenn beide Formen verfügbar sind, wird der Befehl wie folgt aufgeführt:

add-reg-key (ark)Optionen

Wenn Sie den Befehl verwenden, geben Sie entweder nur die Langform oder die Kurzform ein:

zac add-reg-key Optionen

zac ark Optionen

Wenn eine Option ein Leerzeichen enthält, setzen Sie sie in Anführungszeichen ein:

zac ark "Option 1"

Hilfebefehle

/h oder --help

Zeigt Informationen über die Befehle an.

Bundle-Befehle

bundle-install (bin) <Bundle-Anzeigename>

Installiert das angegebene Bundle. Verwenden Sie den Befehl bundle-list, um eine Liste der verfügbaren Bundles und deren Anzeigenamen abzurufen.

Beispiel 1-1 Beispiel:

zac bin bundle1

bundle-launch (bln) <Bundle-Anzeigename> [-noSelfHeal]

Startet das angegebene Bundle. Verwenden Sie den Befehl bundle-list, um eine Liste der verfügbaren Bundles und deren Anzeigenamen abzurufen.

Beispiel 1-2 Beispiel, wie ein Bundle basierend auf dem Anzeigenamen gestartet wird:

zac bln bundle1

Beispiel 1-3 Beispiel, wie ein Bundle basierend auf dem Anzeigenamen gestartet und die Selbstreparatur deaktiviert wird, wenn die Startaktion fehlschlägt (standardmäßig ist die Selbstreparatur aktiviert):

zac bln bundle1 -noSelfHeal

bundle-list (bl)

Zeigt die Liste der Bundles an, die dem Gerät und dem angemeldeten Benutzer zugewiesen sind.

Beispiel 1-4 Beispiel:

zac bl

bundle-props (bp) <Bundle-Anzeigename>

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 1-5 Beispiel:

zac bln bundle1

bundle-refresh (br) <Bundle-Anzeigename oder GUID>

Aktualisiert die Informationen zu dem angegebenen Bundle.

Beispiel 1-6 Beispiel:

zac br bundle1

bundle-remove (brm) <Bundle-Anzeigename>

Deinstalliert das angegebene Bundle. Verwenden Sie den Befehl bundle-list, um eine Liste der installierten Bundles und deren Anzeigenamen abzurufen.

Beispiel 1-7 Beispiel:

zac brm bundle1

bundle-uninstall (bu) <Bundle-Anzeigename>

Deinstalliert das angegebene Bundle. Verwenden Sie den Befehl bundle-list, um eine Liste der installierten Bundles und deren Anzeigenamen abzurufen.

Beispiel 1-8 Beispiel:

zac bu bundle1

bundle-verify (bv) <Bundle-Anzeigename>

Ü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 1-9 Beispiel:

zac bv bundle1

Inhaltsverteilungsbefehle

wake-cdp (cdp) [replicate | cleanup]

Reaktiviert den Arbeitsthread des Inhaltsverteilungspunkts Sie können eine der folgenden Optionen verwenden:

  • replicate - Lädt neue oder geänderte Inhalte vom übergeordneten ZENworks-Server des Inhaltsverteilungspunkts herunter.
  • cleanup - Entfernt alle Inhalte, die nicht mehr auf dem Inhaltsverteilungspunkt gespeichert sein sollten.

Beispiel 1-10 Beispiele:

zac cdp

zac cdp replicate

Datenbankbefehle

statussender CleanUp

Führt die Bereinigung sofort aus und löscht die Einträge in der MDStatus-Datenbank, die nach dem letzten erfolgreichen Rollup 14 Tage lang nicht aktualisiert wurden. Standardmäßig wird die Bereinigung einmal pro Tag ausgeführt und zum ersten Mal beim Starten des Agentendiensts. Die Bereinigungsmethode protokolliert die entsprechenden Meldungen in der Datei zmd-messages.log, falls die Protokollierungsstufe auf DEBUG gesetzt wurde.

Die MDStatus-Datenbank wird dazu verwendet, um ein Rollup des Bundle- und Richtlinienstatus vom verwalteten Gerät zum ZENworks-Server durchzuführen.

statussender RollUp

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.

Imaging-Befehle

file-system-guid (fsg)[-d] [-r]

Entfernt die Arbeitsstation-GUID im Dateisystem und stellt sie wieder her, um die Erstellung eines Image vorzubereiten.

Beispiel 1-11 Beispiel, wie die GUID aus dem Dateisystem entfernt wird:

zac file-system-guid -d

Beispiel 1-12 Beispiel, wie die GUID im Dateisystem wieder hergestellt wird:

zac file-system-guid -r

Beispiel 1-13 Beispiel, wie der GUID-Wert gedruckt wird:

zac fsg

Inventarbefehle

Inventar (inv) Inventar [scannow|cdf]

Führt eine Inventarabsuche aus oder öffnet das Erfassungsdatenformular.

Beispiel 1-14 Beispiel für die Ausführung einer Inventarabsuche:

zac inv scannow

Beispiel 1-15 Beispiel für das Öffnen eines Erfassungsdatenformulars:

zac inv cdf

Protokollierungsbefehle

logger (log) resetlog|level [MANAGED|ERROR|WARN|INFO|DEBUG] |managedlevel , logger

Ändert oder konfiguriert die Konfiguration der Protokollierung für ZENworks Adaptive Agent.

Sie können folgende Optionen verwenden:

  • resetlog – Setzt das Protokoll zurück.
  • level – Falls dieser Befehl ohne Stufe verwendet wird, wird die aktuell verwaltete Protokollstufe angezeigt. Falls er mit einer Stufe verwendet wird, wird die Protokollstufe auf die angegebene Stufe geändert.
  • managedlevel – Zeigt die aktuell verwaltete Protokollstufe an.

Beispiel 1-16 Beispiel, wie die Protokolldatei zurückgesetzt wird:

zac logger resetlog

Beispiel 1-17 Beispiel, wie die aktuelle Protokollstufe angezeigt wird:

zac logger level

Beispiel 1-18 Beispiel, wie die Protokollstufe auf "DEBUG" und höher festgelegt wird.

zac logger level DEBUG

Richtlinienbefehle

policy-export (pe) <Richtlinientyp>

Exportiert die Einstellungen für eine Richtlinie für Browser-Lesezeichen in eine XML-Datei bzw. eine Windows-Gruppenrichtlinie in eine ZIP-Datei.

Der Richtlinientyp muss ein browserbookmarkspolicy-Typ bzw. ein grouppolicy-Typ sein.

Beispiel 1-19 Verwendung der Richtlinie für Browser-Lesezeichen:

zac pe browserbookmarkspolicy <XML-Dateiname exportieren> <Zu exportierender Favoritenordner>

Beispiel 1-20 Beispiel einer Richtlinie für Browser-Lesezeichen:

zac pe browserbookmarkspolicy c:\financial.xml Financial

Beispiel 1-21 Beispiel einer Windows-Gruppenrichtlinie:

zac pe grouppolicy <Optionen> <ZIP-Dateiname exportieren>

where <Optionen> are:

  • all - Exportiert sowohl die Einstellungen des Computers als auch die der Benutzerkonfiguration.
  • computer (cmp) - Exportiert nur die Einstellungen der Computerkonfiguration.
  • user (usr) - Exportiert nur die Einstellungen der Benutzerkonfiguration.
  • active-directory (ad) [Active Directory-Gruppenrichtlinienpfad] - Exportiert die Active Directory-Gruppenrichtlinie; erfordert die Angabe eines Active Directory-Gruppenrichtlinienpfads.

Beispiel 1-22 Beispiel einer Windows-Gruppenrichtlinie:

zac pe grouppolicy all c:\policy.zip

policy-list (pl)

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.

Beispiel 1-23 Beispiele:

zac pl

zac pl --all

policy-refresh (pr)

Wendet alle Richtlinien an, die dem Gerät und dem Benutzer zugewiesen sind.

Beispiel 1-24 Beispiel:

zac pr

Registrierungsbefehle

add-reg-key (ark) <Registrierungsschlüssel>

Registriert das Gerät mithilfe des angegebenen Schlüssels. Die Registrierung mithilfe von Schlüsseln ist additiv. Wenn das Gerät früher mit einem Schlüssel registriert wurde und Sie es nun mit einem neuen Schlüssel registrieren, erhält das Gerät alle Gruppenzuweisungen, die beiden Schlüsseln zugeordnet sind.

Beispiel 1-25 Beispiel:

zac ark key12

get-settings (gs) <Registrierungsschlüssel>

Listet die dem angegebenen Registrierungsschlüssel zugeordneten Einstellungen auf.

Beispiel 1-26 Beispiel:

zac gs key1

register (reg) [-k <Schlüssel>] [-u <Benutzername> -p <Passwort] [-makenewguid] <ZENworks-Serveradresse:Port>

Registriert das Gerät in einer Verwaltungszone.

Sie können folgende Optionen verwenden:

  • k – Sie können hiermit das Gerät mithilfe des angegebenen Registrierungsschlüssels registrieren.
  • u – Sie können hiermit den Benutzernamen des Verwaltungszonenadministrators angeben.
  • p – Sie können hiermit das Passwort des Verwaltungszonenadministrators angeben.
  • makenewguid – Sie können hiermit eine GUID für das Gerät erstellen, falls Sie mehrere Geräte mit derselben GUID haben. Diese Option können Sie nicht zum Erstellen einer neuer GUID für einen Primärserver oder ein Satellitengerät verwenden. Der lokale Benutzer muss über lokale Administratorrechte verfügen, um diese Option verwenden zu können.

Beispiel 1-27 Beispiele:

zac reg -k key1 https://123.456.78.90

zac reg -k key1 -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.

reregister (rereg)[-u <Benutzername> -p <Passwort>] <Neue GUID>

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.

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.

Beispiel 1-28 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

unregister (unr) [-f] [-u <Benutzername> -p <Passwort>]

Entfernt die Registrierung des Geräts aus der Verwaltungszone.

Beispiel 1-29 Beispiel:

zac unr -u administrator -p novell

Die Parameter -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.

Statusbefehle

cache-clear (cc)

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 1-30 Beispiel:

zac cc

dump-prop-pages (dpp) <Zielverzeichnis>

Gibt die auf den Eigenschaftenseiten des ZENworks-Symbols angezeigten HTML-Seiten in Dateien im angegebenen Zielverzeichnis aus.

Beispiel 1-31 Beispiel:

zac dpp c:\temp

refresh (ref)[allgemein [bypasscache] | teilweise [bypasscache]

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.

Beispiel 1-32 Beispiele:

zac ref general

zac ref partial bypasscache

set-proxy (sp) [Optionen] <IP-Adresse:Port> [Benutzername] [Passwort]

Gibt einen Proxy an, über den ein Kontakt hergestellt werden kann, statt einen ZENworks-Server direkt zu kontaktieren. Die Optionen sind:

  • /Standard - Legt einen Proxy fest, der mit Proxy-Einstellungen der Verwaltungszone überschrieben werden kann.
  • /Löschen - Löscht den aktuellen Proxy, verwendet jedoch die Proxyeinstellungen der Verwaltungszone.

Beispiel 1-33 Beispiele:

zac sp 123.456.78.90 administrator novell

zac sp /Standard 123.456.78.90

Ist der Benutzername und das Passwort nicht angegeben, werden Sie zur Eingabe aufgefordert.

winproxy-refresh (wpr)

Fragt die Verwaltungszone nach Proxy-Arbeit ab, die diesem Gerät zugewiesen wurde.

Beispiel 1-34 Beispiel:

zac wpr

zenhttp-status(zhs)

Listet den Port und die Tags für registrierte Behandlungsroutinen auf.

Beispiel 1-35 Beispiel:

zac zhs

zeninfo-collect [<Zieldatei>]

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 Novell möglicherweise dazu aufgefordert, diesen Befehl auszuführen und die daraus resultierende ZIP-Datei an Novell zu senden, damit Ihnen bei der Lösung des Problems geholfen werden kann.

zone-config (zc) [-l]

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.

Beispiel 1-36 Beispiele:

zac zc

zac zc -l

Autoren

Copyright 2008-2009 Novell, Inc. Alle Rechte vorbehalten. http://www.novell.com