zac - Interface de gestion de ligne de commande de l'agent Micro Focus ZENworks installé et exécuté sur des périphériques gérés Macintosh.
zac command options
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.
Cette section présente la mise en forme et les conventions adoptées pour les commandes générales.
La plupart des commandes possèdent une forme longue et une forme courte :
Lorsque les deux formes sont disponibles, la commande est répertoriée comme suit :
add-reg-key (ark)options
Lorsque vous utilisez la commande, ne saisissez que sa forme longue ou sa forme courte :
zac add-reg-key options
zac ark options
Si une option comprend un espace, faites-le apparaître entre guillemets :
zac ark "option 1"
Les arguments entre parenthèses ( ) sont obligatoires, tandis que ceux entre crochets [ ] sont facultatifs.
Les points de suspension indiquent qu'une commande accepte plusieurs entrées du type du dernier argument. Les arguments doivent être séparés par un espace ou par une virgule, selon la commande. Par exemple :
zman server-add-bundle [options] (serveur) (ensemble) [...]
Les points de suspension indiquent que server-add-bundle peut accepter plusieurs ensembles. Dans l'aide au niveau de la commande, l'aide de l'argument à plusieurs entrées est fournie sous la forme [(ensemble) (ensemble) ... (ensemble)] pour plus de clarté.
Installe les ensembles spécifiés selon le nom d'affichage qui correspond à l'expression ou la chaîne régulière ou au GUID d'ensemble.
Utilisez la commande bundle-list pour obtenir une liste des ensembles disponibles et leurs noms d'affichage.
Exemple d'installation d'un ensemble :
zac bin MacBundle
Lance l'ensemble spécifié. Les opérations de l'ensemble d'opérations de lancement sont exécutées. Si vous tentez de lancer un ensemble qui n'est pas encore installé, ce dernier est d'abord installé puis lancé.
Utilisez la commande bundle-list pour obtenir une liste des ensembles disponibles et leurs noms d'affichage.
Exemple pour lancer un ensemble en fonction de son nom d'affichage :
zac bln MacBundle
Affiche la liste des ensembles assignés au périphérique et à l'utilisateur connecté.
Le résultat de cette commande s'affiche en colonnes et fournit les détails de chaque ensemble assigné ou disponible pour le périphérique géré. Les colonnes Nom d'affichage, Version et Type d'ensemble représentent respectivement le nom d'affichage, le numéro de version de l'ensemble ou du sandbox si l'ensemble est une version en sandbox, ainsi que le type d'ensemble.
La colonne État affiche les états suivants :
Disponible : affiche cet état si l'ensemble est installé.
Non installé : affiche cet état si la version particulière de l'ensemble n'est pas installée.
Téléchargé : affiche cet état si le contenu est téléchargé mais que l'opération dans l'ensemble d'opérations d'installation n'a pas été exécutée.
Exemple pour répertorier tous les ensembles :
zac bl
Verrouille les ensembles spécifiés qui correspondent à l'expression ou chaîne régulière indiquée pour empêcher leur mise à niveau ou leur suppression.
Les verrous d'ensembles ne sont applicables que pour l'ensemble d'opérations d'installation.
Accepte les options suivantes :
-li, --lock-install : verrouille l'ensemble et empêche l'installation de l'ensemble spécifié dans le verrou.
-t, --type : spécifiez le type d'ensemble à verrouiller. Les types disponibles sont Mac et Correctif. Si aucun type n'est spécifié, le type Ensemble est sélectionné.
Répertorie les verrous d'ensembles. Les verrous d'ensembles sont triés par numéro ID.
Exemple pour répertorier les ensembles verrouillés :
zac bll
Supprime le verrou de l'ensemble spécifié par le numéro. Vous pouvez trouver le numéro de chaque verrou grâce à la commande bundle-lock-list.
Exemple pour supprimer tous les verrous d'ensembles :
zac blr --remove-all
Renvoie les propriétés d'un ensemble.
Exemple pour obtenir les propriétés d'un ensemble spécifié :
zac bp MacBundle
Rafraîchit les informations sur l'ensemble spécifié.
Exemple pour rafraîchir un ensemble :
zac br MacBundle
Recherche les ensembles qui correspondent à une chaîne ou une expression régulière Java spécifiée.
Désinstalle l'ensemble spécifié. Les opérations qui prennent en charge l'opération Annuler sont exécutées lors de la désinstallation de l'ensemble. Une fois la désinstallation de l'ensemble terminée, l'état de l'ensemble affiché est Non installé.
Utilisez la commande bundle-list pour obtenir une liste des ensembles installés et leurs noms d'affichage.
Exemple pour désinstaller un ensemble :
zac bu MacBundle
Réinstalle l'ensemble et exécute les ensembles d'opérations Vérifier pour garantir qu'aucun fichier n'a été supprimé ou corrompu. Utilisez la commande bundle-list pour obtenir une liste des ensembles installés et leurs noms d'affichage.
Exemple pour vérifier un ensemble :
zac bv MacBundle
Cette commande enregistre un périphérique avec la clé d'enregistrement spécifiée.
Exemple : zac add-reg-key
Cette commande fournit des informations sur l'agent ZENworks.
Exemple : zac agent-properties
Efface le cache sur ce périphérique.
Exemple : zac cc
Liste les informations de certificat de clé publique pour chaque serveur ZCM connu ou ajoute un certificat de racine approuvée au magasin de la machine.
Exemple :
Pour répertorier les certificats pour chaque utilisateur ZENworks connu :
zac ci
Pour ajouter un certificat racine approuvé à la zone de stockage de périphériques approuvée :
zac ci <emplacement> -u myuser -p mypassword
Affiche l'emplacement en cours.
Exemple :
zac config-location
Supprime et restaure le GUID du poste de travail sur le système de fichiers en vue de prendre une image.
Exemple :
Pour afficher la valeur du GUID :
zac fsg
Pour supprimer le GUID et le fichier conninfo.dat du système de fichiers :
zac file-system-guid -d
Pour restaurer le GUID sur le système de fichiers :
zac file-system-guid -r
Ne spécifiez pas d'option pour imprimer la valeur du GUID :
zac fsg
Affiche les préférences actuellement définies.
Exemple d'affichage de toutes les préférences dont le nom commence par abc :
zac get-pre abc
Les paramètres sont téléchargés par le module de paramètres dans le cache local à chaque rafraîchissement. Cette opération renvoie les paramètres effectifs associés à la clé donné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.
Modifie la configuration de l'enregistreur.
Vous pouvez utiliser les options suivantes :
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
Cette commande rétablit la fiabilité dans la zone actuelle.
Rétablit la confiance vis-à-vis de la zone de gestion actuelle. Le nom d'utilisateur et le mot de passe utilisés doivent être ceux de l'administrateur de zone.
Exemple :
zac retr -u myuser -p mypassword
Les paramètres -u et -p sont facultatifs. Si vous n'utilisez pas les paramètres -u et -p, vous êtes invité à saisir un nom d'utilisateur et un mot de passe.
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
Cette commande enregistre un périphérique dans la zone spécifiée.
Pour exécuter cette commande, vous devez disposer de droits de périphérique Créer/supprimer sur le dossier pour lequel vous tentez d'enregistrer
Exemple :
zac reg -k key1 https://123.456.78.90
Cette commande enregistre un périphérique dans la zone actuelle et l'assigne au GUID d'un objet Périphérique existant. L'objet Périphérique actuellement sélectionné est supprimé. Pour exécuter cette commande, vous devez disposer de droits de périphérique Créer/supprimer sur le dossier que vous tentez de réenregistrer.
Vous devez spécifier un nom d'utilisateur et un mot de passe :
zac reregister -u myuser -p mypassword eaa6a76814d650439c648d597280d5d4
Définit la valeur d'une préférence.
Exemple de définition de la valeur de préférence abc sur 123 :
zac set-pref abc 123
Spécifie un proxy à contacter plutôt que de contacter directement le serveur ZENworks.
Les options sont les suivantes :
Exemples :
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
Si le nom d'utilisateur et le mot de passe ne sont pas spécifiés, vous serez invité à les entrer.
Cette commande annule l'enregistrement d'un périphérique dans la zone actuelle.
Pour exécuter cette commande, vous devez disposer de droits de périphérique Créer/supprimer sur le dossier pour lequel vous tentez d'annuler l'enregistrement.
Exemple :
zac unr -u administrator -p novell
REMARQUE :l'exécution de la commande UNR peut entraîner une utilisation élevée de la base de données. Cela peut être dû à l'une des raisons suivantes :
La commande UNR est en cours d'exécution sur le serveur.
La zone contient un nombre élevé de périphériques gérés.
Les périphériques gérés ont un historique volumineux.
La gestion des correctifs est activée.
Cette commande affiche le serveur de configuration de zone ou liste la configuration de zone actuelle.
zac zc
Exécute une analyse d'inventaire.
Exemple pour l'exécution d'une analyse d'inventaire :
zac inv scannow
Ces commandes ne sont utilisées que pour les agents Inventaire uniquement (IOA).
Configure le périphérique IOA Mac sur l'adresse IP de serveur mentionnée.
Exemple pour enregistrer un périphérique Mac d'inventaire seulement sur le serveur <10.70.13.124>
zac ioa cfg 10.70.13.124
Affiche la version de l'agent Inventaire uniquement.
Exécute une analyse d'inventaire.
Exemple pour l'exécution d'une analyse d'inventaire :
zac inv scannow
Analyse le périphérique à la recherche des correctifs qui n'ont pas encore été appliqués, à l'aide du fichier (DAU) de signature du correctif actuel du périphérique. Les résultats sont ensuite téléchargés sur le serveur.
Exemple pour l'exécution d'une analyse des correctifs :
zac ps
Télécharge les résultats de la dernière analyse sur le serveur sans exécuter de nouvelle analyse de détection.
Exemple pour l'exécution d'une analyse rapide des correctifs :
zac ps --quick
Met les périphériques à jour avec la dernière version de toutes les stratégies de correctifs.
Exemple pour l'exécution d'une stratégie d'application des correctifs :
zac pap
Sort de la quarantaine tous les correctifs mis en quarantaine sur chaque périphérique sur lequel la commande est exécutée de manière à permettre une tentative d'installation unique, à partir soit d'une planification de stratégie de correctif, soit d'une planification du traitement.
Exemple pour l'exécution d'une libération des correctifs mis en quarantaine :
zac pqr
Lit les rôles de satellite à partir du cache.
Exemple pour la lecture des rôles de satellite à partir du cache :
zac satcfg
Efface les informations de configuration satellite du cache.
Exemple pour la suppression des informations de configuration de satellite à partir du cache :
zac satcc
Rafraîchit les rôles de satellite.
Exemple pour le rafraîchissement des rôles de satellite :
zac satrc
Signale les rôles de satellite actuels et leur état.
Exemple pour le signalement des rôles de satellite actuels et de leur état :
zac satr
Répertorie les ports et les étiquettes pour les gestionnaires enregistrés.
Exemple pour le listage du port et des balises des gestionnaires enregistrés :
zac zhs
Cette commande n'est applicable que si l'agent est promu en tant que satellite.
Récupère la mise à jour système lorsqu'elle est assignée à un périphérique.
Vérifie si le certificat du serveur et le fichier de clé copiés dans l'espace de stockage de renouvellement sont valides, et met à jour les résultats sur le serveur.