zac (1)

Name

zac - L'interface de gestion de ligne de commande pour Novell ZENworks Adaptive Agent.

Syntaxe

zac command options

Description

L'utilitaire zac effectue les fonctions de gestion de ligne de commande sur le périphérique géré ZENworks, y compris l'installation et la suppression d'ensembles logiciels, l'application de stratégies et l'enregistrement et l'annulation de l'enregistrement du périphérique.

Guide d'utilisation

La plupart des commandes possèdent une forme longue et une forme courte :

  • Forme longue : add-reg-key

  • Forme courte :ark

Lorsque les deux formes sont disponibles, la commande est répertoriée comme suit :

add-reg-key (ark) arguments

Lorsque vous utilisez la commande, ne saisissez que sa forme longue ou sa forme courte :

zac add-reg-key arguments

zac ark arguments

Les arguments peuvent être obligatoires ou facultatifs. Les arguments obligatoires sont entre crochets angulaires <argument>. Les arguments facultatifs sont entre crochets [argument]. Si un argument contient un espace, saisissez-le entre guillemets :

zac ark "arg 1"

Commandes d'aide

/h ou --help

Affiche des informations au sujet des commandes.

Commandes de serveur satellite d'authentification

authentication server reconfigure (asr) [-t all|config|jetty|casa] [-u nom_utilisateur] [-p mot_de_passe]

Reconfigure un serveur satellite d'authentification activé.

Exemples :

Pour récupérer les fichiers de configuration du serveur :

zac asr -t config

Pour reconfigurer le certificat de signature CASA :

zac asr -t casa

Pour reconfigurer le serveur Web Jetty :

zac asr -t jetty -u Administrateur -p mot_de_passe

Pour reconfigurer tout le serveur satellite :

zac asr -t all -u Administrateur -p mot_de_passe

Si un nom d'utilisateur et un mot de passe sont requis mais non spécifiés dans la ligne de commande, une invite s'affiche.

import-authentication-cert(iac)[-pk <clé_privée.der>] [-c <certificat_serveur_signé.der>] [-ca <certificat_public_autorité_signature.der>] [-ks <keystore.jks>] [-ksp <phrase_secrète_keystore>] [-a <alias_certificat_signé>] [-ks <phrase_secrète_certificat_signé>] [-u nom_utilisateur] [-p mot_de_passe]

Configure un périphérique satellite d'authentification avec des certificats signés en externe.

Commandes d'ensemble

bundle-install (bin) <nom d'affichage de l'ensemble>

Installe l'ensemble spécifié. Utilisez la commande bundle-list pour obtenir une liste des ensembles disponibles et leurs noms d'affichage.

Exemple :

zac bin bundle1

bundle-launch (bln) <nom d'affichage de l'ensemble> [-noSelfHeal]

Lance l'ensemble spécifié. Utilisez la commande bundle-list pour afficher une liste de tous les ensembles disponibles avec leur nom d'affichage.

Exemple de lancement d'un ensemble en fonction de son nom d'affichage :

zac bln bundle1

Exemple de lancement d'un ensemble en fonction de son nom d'affichage avec désactivation de l'auto-dépannage si l'opération de lancement échoue (l'auto-dépannage est activé par défaut) :

zac bln bundle1 -noSelfHeal

bundle-list (bl)

Affiche la liste des ensembles assignés au périphérique et à l'utilisateur logué.

Exemple :

zac bl

bundle-props (bp) <nom d'affichage de l'ensemble>

Affiche l'état, la version, le GUID et les conditions requises de l'ensemble spécifié. Utilisez la commande bundle-list pour obtenir une liste des ensembles disponibles et leurs noms d'affichage.

Exemple :

zac bln bundle1

bundle-refresh (br) <GUID ou nom d'affichage de l'ensemble>

Rafraîchit les informations sur l'ensemble spécifié.

Exemple :

zac br bundle1

bundle-remove (brm) <nom d'affichage de l'ensemble>

Désinstalle l'ensemble spécifié. Utiliser la commande bundle-list pour obtenir une liste des ensembles installés et leur nom d'affichage.

Exemple :

zac brm bundle1

bundle-uninstall (bu) <nom d'affichage de l'ensemble>

Désinstalle l'ensemble spécifié. Utiliser la commande bundle-list pour obtenir une liste des ensembles installés et leur nom d'affichage.

Exemple :

zac bu bundle1

bundle-verify (bv) <nom d'affichage de l'ensemble>

Vérifie un ensemble installé (spécifié par son nom d'affichage) pour s'assurer qu'aucun fichier n'a été supprimé ou endommagé. Utilisez la commande bundle-list pour obtenir une liste des ensembles installés et leurs noms d'affichage.

Exemple :

zac bv bundle1

Commandes de distribution de contenu

cdp-checksum (cchk) [-l:<chemin d'accès au journal>]

Valide le contenu du satellite en effectuant le contrôle de cohérence sur chaque fichier.

Le fichier journal optionnel détaille les résultats de la comparaison de ces contrôles.

Exemple :

zac cchk -l:"C:\Program Files\Novell\ZENworks\logs\cchk.log”

cdp-verify-content (cvc) [-c] [-l:<chemin d'accès au journal>]

Compare la liste des ID de contenu et leur état de synchronisation sur ce CDP avec les valeurs attendues par les serveurs primaires.

Vous pouvez utiliser les options suivantes :

  • c - Effectue le contrôle de cohérence sur le contenu local.

Exemple :

zac cvc -l:"C:\Program Files\Novell\ZENworks\logs\cvc.log”

cdp-import-content (cic) <chemin d'accès au contenu> [-l:<chemin d'accès au journal>]

Importe le contenu manquant depuis le répertoire spécifié par le chemin d'accès au contenu en se loguant au fichier spécifié par le chemin d'accès au journal.

Exemple :

zac cic c:\répertoire_source_importation -l:"C:\Program Files\Novell\ZENworks\logs\cic.log”

wake-cdp (cdp) [replicate | cleanup]

Réveille le thread de travail du point de distribution de contenu. Vous pouvez utiliser l'une des options suivantes :

  • replicate : télécharge tout nouveau contenu ou contenu modifié à partir du serveur ZENworks parent du point de distribution de contenu.
  • cleanup : supprime tout contenu qui ne doit plus être stocké sur le point de distribution de contenu.

Exemples :

zac cdp

zac cdp replicate

Cette commande n'est applicable que si l'agent est promu au niveau de satellite.

Commandes de base de données

statussender CleanUp

Démarre le nettoyage immédiatement et supprime les entrées de la base de données MDStatus qui n'ont pas été mises à jour au cours des 14 jours suivant le dernier transfert en amont réussi. Par défaut, le nettoyage est effectué une fois par jour et s'exécute au premier démarrage du service de l'agent. La méthode de nettoyage consigne les messages appropriés dans le fichier zmd-messages.log lorsque le niveau de consignation est défini sur DEBUG.

La base de données MDStatus permet de transférer des états d'ensemble et de stratégie du périphérique géré vers le serveur ZENworks.

statussender RollUp

Transfère en amont vers la base de données MDStatus les états qui ont été mis à jour depuis leur dernier transfert en amont réussi. Par défaut, l'expéditeur de l'état transfère les états en amont toutes les 5 minutes.

La base de données MDStatus permet de transférer des états d'ensemble et de stratégie du périphérique géré vers le serveur ZENworks.

Commandes de création d'image

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

Affiche, supprime ou restaure le GUID du poste de travail dans le système de fichiers en vue de créer une image.

Exemple d'affichage de la valeur du GUID :

zac fsg

Exemple de suppression du GUID du système de fichiers :

zac file-system-guid -d

Exemple de restauration du GUID sur le système de fichiers :

zac file-system-guid -r

Commandes d'inventaire

inventory (inv) inventory [scannow|cdf]

Exécute une analyse d'inventaire ou ouvre le formulaire des données de collecte.

Exemple d'exécution d'une analyse d'inventaire :

zac inv scannow

Exemple d'ouverture du formulaire de données de collecte :

zac inv cdf

Commandes d'emplacement

config-location (cl)

Affiche l'emplacement de configuration. L'emplacement de configuration détermine à quel(s) serveur(s) ZENworks le périphérique se connecte à des fins d'authentification, de configuration, de contenu et de collecte.

Exemples :

zac config-location

zac cl

security-location (sl) [view | list | set <emplacement>]

Affiche ou modifie l'emplacement de sécurité pour le périphérique. L'emplacement de sécurité détermine quelles stratégies (paramètres) de sécurité sont appliquées au périphérique.

Accepte les arguments facultatifs suivants : Si aucun argument n'est spécifié, l'argument view est utilisé.

  • view : affiche l'emplacement actuel.
  • list : affiche tous les emplacements définis.
  • set <emplacement> : passe à l'emplacement spécifié. <emplacement> doit être l'un des emplacements définis.

Exemples :

  • zac security-location view
  • zac sl
  • zac sl list
  • zac sl set office

Commandes de consignation

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

Modifie ou affiche la configuration du Logger de ZENworks Adaptive Agent.

Vous pouvez utiliser les options suivantes :

  • resetlog : réinitialise le journal.
  • level : si aucun niveau n'est spécifié pour cette option, elle affiche le niveau de consignation géré actuel. Si un des niveaux est spécifié, celui-ci remplace le niveau de consignation précédent.
  • managedlevel : affiche le niveau de consignation géré actuel.

Exemple de réinitialisation du fichier journal :

zac logger resetlog

Exemple d'affichage du niveau de consignation actuel :

zac logger level

Exemple de paramétrage du niveau de log à DEBUG et au-dessus :

zac logger level DEBUG

Commandes de stratégies

policy-export (pe) <type de stratégie>

Exporte les paramètres d'une stratégie des signets du navigateur vers un fichier XML ou ceux d'une stratégie de groupe Windows vers un fichier ZIP.

La stratégie doit être de type browserbookmarkspolicy ou grouppolicy.

Utilisation pour stratégie de signets du navigateur :

zac pe browserbookmarkspolicy <exporter le fichier XML> <dossier Favoris à exporter>

Exemple d'une stratégie de signets du navigateur :

zac pe browserbookmarkspolicy c:\financial.xml Financial

Exemple d'une stratégie de groupe Windows :

zac pe grouppolicy <options> <exporter le fichier ZIP>

où les options sont :

  • all : exporte à la fois les paramètres de configuration de l'ordinateur et ceux de l'utilisateur.
  • computer (cmp) : exporte seulement les paramètres de configuration de l'ordinateur.
  • user (usr) -Exporte seulement les paramètres de configuration de l'utilisateur.
  • active-directory (ad) [chemin de la stratégie de groupe d'Active Directory] : exporte la stratégie de groupe d'Active Directory. Vous devez spécifier le chemin d'accès à la stratégie de groupe d'Active Directory.

Exemple d'une stratégie de groupe Windows :

zac pe grouppolicy all c:\policy.zip

policy-list (pl)

Répertorie les stratégies qui sont actuellement appliquées sur le périphérique (stratégies effectives). Pour répertorier toutes les stratégies (effectives et non-effectives), utilisez l'option --all

Exemples :

zac pl

zac pl --all

policy-refresh (pr)

Applique toutes les stratégies assignées au périphérique et à l'utilisateur.

Exemple :

zac pr

Commandes d'enregistrement

add-reg-key (ark) <clé d'enregistrement>

Enregistre le périphérique à l'aide de la clé spécifiée. L'enregistrement avec des clés est additif. Si le périphérique a déjà été enregistré avec une clé et que vous l'enregistrez avec une nouvelle clé, le périphérique reçoit toutes les assignations de groupe associées aux deux clés.

Exemple :

zac ark key12

get-settings (gs) <clé d'enregistrement>

Répertorie les paramètres associés à la clé d'enregistrement spécifiée.

Exemple:

zac gs key1

Vous pouvez également exécuter la commande get-settings (gs) pour lister les paramètres associés à plusieurs clés. Pour plus d'informations, reportez-vous à la commande get-settings (gs) <clé> de la section Commandes d'état.

register (reg) [-g] [-k <key>] [-u <nom_utilisateur> -p <mot_de_passe] <adresse_serveur_ZENworks:port>

Enregistre le périphérique dans une zone de gestion.

Vous pouvez utiliser les options suivantes :

  • g : permet de créer un nouvel objet Périphérique avec des nouveaux GUID et mot de passe si vous disposez de plusieurs périphériques portant le même GUID. Lorsque vous enregistrez un périphérique à l'aide de ce paramètre, toutes les associations (stratégies et ensembles) assignées à l'objet Périphérique initial sont supprimées. Vous ne pouvez toutefois pas utiliser cette option en vue de créer un GUID pour un serveur primaire ou un périphérique satellite. L'utilisateur local doit disposer de droits d'administrateur local pour utiliser cette option.
  • k : permet d'enregistrer le périphérique à l'aide de la clé d'enregistrement spécifiée.
  • p : permet de spécifier le mot de passe de l'administrateur de la zone de gestion.
  • u : permet de spécifier le nom d'utilisateur de l'administrateur de la zone de gestion.

Exemples :

zac reg -k key1 https://123.456.78.90

zac reg -k key1 -u administrator -p novell https://zenserver.novell.com:8080

Le numéro de port n'est requis que si le serveur ZENworks n'utilise pas le port standard HTTP (80). Si aucun nom d'utilisateur ni mot de passe ne sont fournis, vous êtes invité à les indiquer.

reregister (rereg)[-u <nom_utilisateur> -p <mot_de_passe>] <nouveau guid>

Enregistre un périphérique dans la zone en cours et lui assigne le GUID d'un objet Périphérique existant. L'objet Périphérique actuellement sélectionné est supprimé.

Par exemple, si vous créez l'image d'un périphérique après avoir remplacé le disque dur, le périphérique est susceptible d'avoir un nouveau GUID. Par contre, grâce à la commande reregister, vous pouvez assigner au périphérique le GUID qu'il avait avant que vous ne remplaciez le disque dur.

Exemples :

Vous devez spécifier un nom d'utilisateur et un mot de passe :

zac reregister -u myuser -p mypassword eaa6a76814d650439c648d597280d5d4

Pour être invité à fournir un nom d'utilisateur et un mot de passe :

zac reregister eaa6a76814d650439c648d597280d5d4

unregister (unr) [-f] [-u <nom d'utilisateur> -p <mot de passe>]

Supprime l'enregistrement du périphérique de la zone de gestion.

Exemple :

zac unr -u administrator -p novell

Les paramètres -f, -u et -p sont facultatifs. Si vous n'utilisez pas les paramètres -u et -p, vous êtes invités à saisir un nom d'utilisateur et un mot de passe. Le paramètre -f ignore la base de données ZENworks et force l'annulation de l'enregistrement local du périphérique. Cette option est nécessaire uniquement si l'objet Périphérique a déjà été supprimé de la base de données ZENworks ou si le périphérique ne peut pas se connecter à la base.

Commandes d'état

cache-clear (cc)

Efface le cache ZENworks sur le périphérique. Cela supprime toutes les entrées de la base de données du cache ainsi que tous les fichiers du cache associé à ces entrées.

Exemple :

zac cc

dump-prop-pages (dpp) <répertoire cible>

Enregistre dans des fichiers du répertoire cible spécifié les pages HTML qui s'affichent dans les pages de propriété de l'icône ZENworks.

Exemple :

zac dpp c:\temp

get-settings (gs) <clé>

Répertorie les paramètres associés à la clé spécifiée.

Exemple:

zac gs key1

Toutes les clés des paramètres ZENworks valides sont stockées dans le répertoire \Program Files\Novell\ZENworks\cache\zmd\settings.

Exemple pour répertorier les paramètres de gestion à distance :

zac gs RemoteManagement

refresh (ref)[general | partial bundle <nom d'affichage de l'ensemble> [bypasscache]

Initie un rafraîchissement général de tous les ensembles, de toutes les stratégies ainsi que de tous les paramètres d'enregistrement et de configuration | Initie un rafraîchissement partiel de toutes les stratégies ainsi que de tous les paramètres d'enregistrement et de configuration.

Utilisez bypasscache pour éviter l'emploi des données du cache du serveur lors du rafraîchissement. Cette option est utile pour les tests ou le dépannage.

Exemples :

zac ref general bypasscache

zac ref partial bypasscache

set-proxy (sp) [options] <adresse IP:port> [nom d'utilisateur] [mot de passe]

Spécifie un proxy à contacter plutôt que de contacter directement le serveur ZENworks. Les options sont :

  • /default : définit un proxy qui peut être remplacé par les paramètres proxy de la zone de gestion.
  • /clear : efface le proxy actuel. Les paramètres proxy de la zone de gestion seront utilisés.

Exemples :

zac sp 123.456.78.90 administrator novell

zac sp /default 123.456.78.90

Si aucun nom d'utilisateur ni mot de passe ne sont fournis, vous êtes invité à les indiquer.

winproxy-refresh (wpr)

Interroge la zone de gestion au sujet d'un travail de proxy assigné à ce périphérique.

Exemple :

zac wpr

zenhttp-status(zhs)

Permet de répertorier les ports et les étiquettes pour les gestionnaires enregistrés.

Exemple :

zac zhs

Cette commande n'est applicable que si l'agent est promu au niveau de satellite.

info-collect (zeninfo) [<fichier_cible>]

Collecte les informations de support ZENworks, y compris les données du cache, les données de configuration, les journaux de débogage, les informations sur l'installation du produit, les temps de rafraîchissement, les événements d'état et les informations système de base. Les informations sont compressées dans un fichier ZIP et enregistrées à l'emplacement spécifié. Si vous ne précisez pas d'emplacement, ce fichier est enregistré dans ${TEMP}\zeninfo-${DateTime}.zip pour Windows et dans ${TMPDIR}\zeninfo-${DateTime}.zip pour Linux. Si vous rencontrez des difficultés avec un périphérique géré, le support Novell peut vous demander d'exécuter cette commande et de lui envoyer le fichier ZIP ainsi obtenu pour vous aider à résoudre votre problème.

zone-config (zc) [-l]

Affiche des informations au sujet du serveur ZENworks auquel le périphérique accède pour obtenir des informations de configuration (le serveur de configuration) ou affiche les informations du serveur de configuration.

Exemples :

zac zc

zac zc -l

Auteurs

Copyright 2008-2010, Novell, Inc. Tous droits réservés. http://www.novell.com