zac pour Macintosh (1)

Name

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.

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

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 :

  • 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)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"

Arguments obligatoires et facultatifs

Les arguments entre parenthèses ( ) sont obligatoires, tandis que ceux entre crochets [ ] sont facultatifs.

Points de suspension (...)

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é.

Commandes d'ensemble

bundle-install (bin)

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

bundle-launch (bln)

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

bundle-list (bl)

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

bundle-lock-add (bla) [options] [nom ensemble] [[relation] [...]

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é.

bundle-lock-list (bll)

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

bundle-lock-remove (blr)

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

bundle-props (bp)

Renvoie les propriétés d'un ensemble.

Exemple pour obtenir les propriétés d'un ensemble spécifié :

zac bp MacBundle

bundle-refresh (br)

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

Exemple pour rafraîchir un ensemble :

zac br MacBundle

bundle-search (bse)

Recherche les ensembles qui correspondent à une chaîne ou une expression régulière Java spécifiée.

bundle-uninstall (bu)

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

bundle-verify (bv)

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

Commandes principales

add-reg-key (ark)

Cette commande enregistre un périphérique avec la clé d'enregistrement spécifiée.

Exemple : zac add-reg-key

agent-properties (agp)

Cette commande fournit des informations sur l'agent ZENworks.

Exemple : zac agent-properties

cache-clear (cc)

Efface le cache sur ce périphérique.

Exemple : zac cc

cert-info (ci)

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

config-location (cl)

Affiche l'emplacement en cours.

Exemple :

zac config-location

file-system-guid (fsg)

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

get-pref (get)

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

get-settings (gs)

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.

logger [resetlog | level [GÉRÉ|ERREUR|AVERTISSEMENT|INFO|DÉBOGAGE] |managedlevel]

Modifie la configuration de l'enregistreur.

Vous pouvez utiliser les options suivantes :

  • resetlog : réinitialise le journal.
  • level : si aucun niveau n'est spécifié, 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 global de la zone.

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

reestablish-trust (retr)

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.

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

register (reg)

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

reregister (rereg)

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

set-pref (set)

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

set-proxy (sp) [options] <adresse_IP/nom_hôte:port>

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

Les options sont les suivantes :

  • --default : paramétrez un proxy qui peut être neutralisé par des paramètres de proxy provenant de la zone de gestion.
  • --clear : supprime le proxy actuel, mais utilise ensuite des paramètres de proxy provenant de la zone de gestion.
  • --ipv6 - définit un proxy IPv6.

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.

unregister (unr)

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.

zone-config (zc)

Cette commande affiche le serveur de configuration de zone ou liste la configuration de zone actuelle.

zac zc

Commandes d'inventaire

inventory (inv) [scannow]

Exécute une analyse d'inventaire.

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

zac inv scannow

Commandes pour les agents Inventaire uniquement

Ces commandes ne sont utilisées que pour les agents Inventaire uniquement (IOA).

zac ioa cfg <adresse IP de serveur>

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

zac ioa version

Affiche la version de l'agent Inventaire uniquement.

inventory (inv) [scannow]

Exécute une analyse d'inventaire.

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

zac inv scannow

Commandes de gestion des correctifs

patch-scan (ps)

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

patch-scan --quick (ps --quick)

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

patch-scan --complete (ps --complete)

Analyse le périphérique pour détecter les correctifs non appliqués à l'aide d'un fichier (DAU) de signature de correctif mis à jour. Les résultats sont ensuite téléchargés sur le serveur.

Exemple pour l'exécution d'une analyse complète des correctifs :

zac ps --complete

patch-apply-policy (pap)

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

patch-quarantine-release (pqr)

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 pq

Commandes des rôles de satellite

satellite-cachecfg (satcfg)

Lit les rôles de satellite à partir du cache.

Exemple pour la lecture des rôles de satellite à partir du cache :

zac satcfg

satellite-clearcache (satcc)

Efface les informations de configuration satellite du cache.

Exemple pour la suppression des informations de configuration de satellite à partir du cache :

zac satcc

satellite-refreshcfg (satrc)

Rafraîchit les rôles de satellite.

Exemple pour le rafraîchissement des rôles de satellite :

zac satrc

satellite-roles (satr)

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

Commandes d'état

zenhttp-status(zhs)

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.

Commandes de mise à jour système

zac zeus-refresh / zeus-ref

Récupère la mise à jour système lorsqu'elle est assignée à un périphérique.

Commandes de certificat ZENworks

zac certificate-verify / cv

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.