Ces commandes sont utilisées du côté gestionnaire d'entreprise ou du gestionnaire de domaines pour générer et exécuter un job d'installation, de configuration, d'activation ou de désinstallation dans un conteneur de jobs.
Au niveau d'un gestionnaire d'enterprise, ce conteneur de jobs est affecté à une distribution.
Dans le gestionnaire de domaines, cette commande est au format suivant :
{install|configure|activate|uninstall}
item=nom_élément
version=version_élément
procedure=nom_procédure
[installedWith=procédure_installation]
{{computer=nom_ordinateur }
|{{compgrp=nom_groupe_ordinateurs
| ccompgrp=(nom_groupe_ordinateurs.nom_domaine)}}}
[sep=signe_séparateur]
[cname=nom]
{nolinkage|transaction|synchronized}
[rollback=y|n]
[cascade=y|n]
[unsealed]
after={exacttime|boottime}
[globalTime=y|n]
[deliveryTime="AAAA-MM-JJ hh:mm"]
[atTime="AAAA-MM-JJ hh:mm"]
[promptUser[={y|n}]]
[allowCancel[={y|n}]]
[execTimedOut[={y|n}]]
[prompt=jours.heures]
[{preaction={none|reboot|logoff}|bootbefore}]
[{postaction={none|reboot|logoff|rebootAtEnd|logoffAtEnd|shutdownAtEnd}|bootafter}]
[{jobTimeOut=jours.heures | timeout=heures}]
[offline[={y|n}]]
[runAtShutdown[={y|n}]]
[preventLogon[={y|n}]]
[resolveQuery[={y|n}]]
[calendarname=calendrier_livraison]
[nocalendar[={y|n}]]
[stagingServer[={y|n}]]
[parameters=paramètres_utilisateur]
jcPriority={1-10}
[reinstall[={y|n}]]
[userJobMessage]
[userMessage]
Dans le gestionnaire d'entreprise, cette commande est au format suivant :
{install|configure|activate|uninstall}
item=nom_élément
version=version_élément
procedure=nom_procédure
[installedWith=procédure_installation]
|{{compgrp=nom_groupe_ordinateurs
| ccompgrp=(nom_groupe_ordinateurs.nom_domaine)}}}
[sep=signe_séparateur]
after={exacttime|boottime}
[globalTime=y|n]
{{area=nom_zone} | {domain=nom_domaine} | toAllAreas}
[deliveryTime="AAAA-MM-JJ hh:mm"]
[atTime="AAAA-MM-JJ hh:mm"]
cname=[nom]
{nolinkage|transaction|synchronized}
[rollback=y|n]
[cascade=y|n]
[sendTime="AAAA-MM-JJ hh:mm"]
[haltTime="AAAA-MM-JJ hh:mm"]
[promptUser[={y|n}]]
[allowCancel[={y|n}]]
[execTimedOut[={y|n}]]
[prompt=jours.heures]
[{preaction={none|reboot|logoff}|bootbefore}]
[{postaction={none|reboot|logoff|rebootAtEnd|logoffAtEnd|shutdownAtEnd}|bootafter}]
[{jobTimeOut=jours.heures | timeout=heures}]
[offline[={y|n}]]
[runAtShutdown[={y|n}]]
[preventLogon[={y|n}]]
[resolveQuery[={y|n}]]
[calendarname=calendrier_livraison]
[nocalendar[={y|n}]]
[stagingServer[={y|n}]]
[parameters=paramètres_utilisateur]
[jcPriority={1,...,10}]
[distPriority={1,...,10}]
[reinstall[={y|n}]]
[userJobMessage]
[userMessage]
Job d'activation pour l'élément spécifié. La tâche associée de la procédure spécifiée doit être de type activate.
Heure de début de la procédure sur le système cible.
Les valeurs suivantes sont autorisées :
La procédure démarre immédiatement après avoir atteint la valeur atTime.
Le démarrage de la procédure est repoussé jusqu'à la première transmission de redémarrage après atTime.
Si allowCancel ou allowCancel =y est codé, l'utilisateur est invité à annuler l'exécution du job.
Si allowCancel =n est codé, l'utilisateur est refusé.
Si le paramètre n'apparaît pas dans le script, la valeur utilisée par défaut est la valeur de l'option du job de procédure associé.
Spécifie le nom d'un domaine CA ITCM en tant que cible pour la distribution.
Vous pouvez spécifier ce paramètre plusieurs fois pour désigner une liste de domaines CA ITCM.
(gestionnaire d'entreprise uniquement).
Spécifie le Spécifie la date et l'heure à laquelle l'action doit démarrer.
La date est au format ISO AAAA-MM-JJ hh:mm.
Spécifie le nom du calendrier contrôlant l'heure d'exécution de l'évaluation.
Si cascade ou cascade=y est codé, la liaison de jobs du conteneur passe de la résolution des dépendances à l'installation en cascade.
Si la définition cascade=n est utilisée, aucune résolution n'est appliquée à la liaison de jobs.
Spécifie le le nom unique facultatif de conteneur de job.
Si un conteneur / une distribution de jobs portant le nom spécifié existe déjà, une erreur sera signalée.
Si la commande cname n'est pas codée, un nom générique est créé.
Remarques :
Sur le gestionnaire de domaines :
Si un conteneur de jobs portant le nom spécifié existe et est descellé, le job généré sera affecté à ce conteneur. Si le conteneur déjà scellé, un message d'erreur apparaîtra.
Si un conteneur de jobs portant nom spécifié n'existe pas, il sera créé en fonction des options de liaison des jobs spécifiées.
Si la commande cname n'est pas codée, un nom générique est créé.
Sur le gestionnaire d'entreprise :
"cname" est utilisé pour nommer la distribution et le conteneur de jobs associé. La distribution et le conteneur de jobs sont supposés ne pas exister et vont être créés. Le conteneur de jobs est créé en fonction des options de liaison des jobs spécifiées.
Si la commande cname n'est pas codée, un nom générique est créé.
Spécifie le nom d'un groupe d'ordinateurs. Celui-ci sera désigné par le job.
Vous pouvez utiliser ce paramètre plusieurs fois. pour affecter une liste de groupes d'ordinateurs.
Indique le groupe d'ordinateurs à désigner comme une paire nom/champ du groupe. Par défaut, le nom et la portée sont séparés par un point ("."). Un autre séparateur peut cependant être défini à l'aide de l'option sep. Le séparateur ne doit pas faire partie des noms.
Les valeurs suivantes sont autorisées pour le champ groupe :
Le groupe est créé au niveau du gestionnaire de domaines local.
Le groupe a été créé au niveau du gestionnaire d'entreprise et peut être dupliqué.
Le paramètre ccompgrp peut être codé en même temps que le paramètre compgrp, en un appel.
Spécifie le nom de l'ordinateur. Celui-ci sera désigné par le job.
Vous pouvez utiliser ce paramètre plusieurs fois. pour affecter une liste d'ordinateurs.
(gestionnaire de domaines uniquement)
Génère un job de configuration pour l'élément spécifié. La tâche associée de la procédure spécifiée doit être de type configure.
Spécifie le heure de démarrage de la livraison à partir du gestionnaire de domaines.
La date est au format ISO AAAA-MM-JJ hh:mm.
Spécifie le priorité qui sera affectée à la distribution.
La priorité spécifiée doit être numérique, supérieure ou égale à 1 et inférieure ou égale à 10.
Si ce paramètre n'est pas défini dans le script, la priorité 5 est utilisée par défaut.
Spécifie le nom d'un groupe de domaines CA ITCM auquel la distribution sera envoyée pour être exécutée.
Vous pouvez spécifier ce paramètre plusieurs fois pour désigner une liste de groupes de domaines CA ITCM.
(gestionnaire d'entreprise uniquement)
Si execTimedOut ou execTimedOut=y est codé, l'exécution du job est automatiquement lancée à l'expiration de l'invite utilisateur.
Si execTimedOut=n, le job n'est pas démarré automatiquement.
Si globalTime ou globalTime=y est défini, les spécifications relatives à l'heure se basent sur l'heure du gestionnaire d'entreprise.
Si globalTime=n est utilisé, elles sont basées sur l'heure du gestionnaire de domaines.
Spécifie le date et heure auxquelles une commande de distribution doit être interrompue La date doit être au format ISO AAAA-MM-JJ hh:mm.
Génère un job d'installation pour l'élément spécifié. La tâche associée de la procédure spécifiée doit être de type install.
Spécifie le nom de la procédure d'installation utilisé pour installer l'élément spécifié sur les systèmes cibles.
Ce paramètre doit être défini dans le script pour les commandes activate, configure et uninstall. Il n'est pas nécessaire de le faire pour la commande install.
Spécifie le nom de l'élément pour lequel le job sera généré.
Spécifie le priorité du conteneur de jobs.
La priorité spécifiée doit être numérique, supérieure ou égale à 1 et inférieure ou égale à 10.
Si ce paramètre n'est pas défini dans le script, la priorité 5 est utilisée par défaut.
Spécifie le jobTimeout spécifie le délai d'expiration pour un job au format “d.h”, d représentant le nombre de jours et h le nombre d'heures. La plage de paramètres est configurable sur le site du gestionnaire. Lorsque la valeur spécifiée dépasse la limite supérieure configurée, la limite supérieure est prise en considération pour la valeur, lorsque cette dernière est inférieure au seuil spécifié, c'est le seul qui est pris en compte pour cette valeur. Aucun avertissement n'est donné.
jobTimeout ne doit pas être codé avec le paramètre d'expiration du délai, sinon une erreur est renvoyée. Si aucun paramètre n'est codé, la valeur par défaut est 7.0.
Si noCalendar apparaît dans le script, un éventuel calendrier situé sur l'ordinateur cible est ignoré pour l'exécution de ce job.
L'option de liaison de job est définie sur Ignorer l'installation en cascade.
Ce paramètre est autorisé uniquement si transaction ou synchronized est défini dans le script.
Exécute le job indépendamment des autres jobs du conteneur.
Si offline ou offline=y est codé, la connexion entre l'ordinateur cible et le serveur est désactivée pendant l'exécution du job et rétablie ensuite.
En revanche, si offline =n est codé, la connexion n'est pas libérée.
Spécifie le paramètres utilisateur de la procédure.
Plusieurs paramètres utilisateur doivent être séparés par un espace au sein de guillemets doubles.
Si une chaîne vide est codée, aucun paramètre par défaut n'est utilisé.
Spécifie les actions nécessaires qui doivent être entreprises une fois la procédure spécifiée terminée. Les valeurs suivantes sont autorisées :
N'effectue aucune action ultérieure.
Redémarre le système une fois la procédure terminée.
Déconnecte l'utilisateur une fois la procédure terminée.
Redémarre le système une fois tous les jobs de ce conteneur terminés.
Déconnecte l'utilisateur une fois tous les jobs de ce conteneur terminés.
Arrête l'ordinateur cible une fois les jobs achevés.
Spécifie que des actions nécessaires doivent être entreprises avant le début de la procédure spécifiée. Les valeurs suivantes sont autorisées :
N'effectue aucune action antérieure.
Redémarre le système avant le début de la procédure.
Déconnecte l'utilisateur avant le début de la procédure.
Si PreventLogon ou PreventLogon=y apparaît dans le script, la connexion utilisateur est refusée pendant toute l'exécution du job. Si un utilisateur est déjà connecté, l'exécution du job est suspendue jusqu'à la déconnexion de l'utilisateur.
En revanche, si preventLogon =n est codé, la connexion de l'utilisateur n'est pas rejetée.
Spécifie le nom d'une procédure à exécuter.
Spécifie le délai pendant lequel l'utilisateur est invité à lancer le job.
Le format de la période est j.h, j désignant le jour et h les heures.
La plage des valeurs valides de ce paramètre est comprise entre trois heures et sept jours (de 0,3 à 7). Si la valeur spécifiée se situe au-dessous de la valeur minimale, la valeur est remplacée par la valeur minimale. Si la valeur spécifiée excède la valeur maximale, la valeur est remplacée par la valeur maximale. Aucun avertissement n'est donné.
Si promptUser ou promptUser=y apparaît dans le script, l'utilisateur est invité à exécuter le job.
En revanche, si promptUser=n est spécifié, aucune invite n'apparaît.
Paramètre facultatif. Valeur par défaut : reinstall=n
Si reinstall ou reinstall=y est codé, un enregistrement d'installation lié à la commande peut être supprimée avant que le job ne soit évalué par le gestionnaire de domaines.
Si reinstall=n est codé, ces enregistrements sont conservés.
Remarque : L'option de réinstallation est valide pour l'action install uniquement et non pour les actions configure, activate ou uninstall.
Evalue un groupe de requête susceptible d'être associé avant la génération du job.
Définit l'option de liaison de job sur Activer la transaction.
Si runAtShutdown ou runAtShutdown=y est codé, l'exécution du job commence à l'arrêt uniquement.
Si runAtShutdown=n est codé, le job démarre à n'importe quelle autre heure également.
Si le paramètre n'apparaît pas dans le script, la valeur utilisée par défaut est la valeur de l'option du job de procédure associé.
Ce paramètre est destiné aux cibles Unix uniquement.
Spécifie le heure à laquelle la distribution associée doit être envoyée aux gestionnaires de domaines désignés. La date doit être au format ISO AAAA-MM-JJ hh:mm. Si ce paramètre n'apparaît pas dans le script, la date et l'heure courantes sont utilisées.
Spécifie un autre séparateur pour l'option ccompgroup. Ce séparateur ne doit pas être inclus dans le code du nom du groupe avec les options ccompgroup.
Livre également le produit associé aux bibliothèques de transfert des serveurs de modularité des ordinateurs cibles.
Ce paramètre s'applique uniquement aux procédures auxquelles est associé le type de tâche Installe.
L'option de liaison de job est définie sur Exécution d'un job synchronisé.
Spécifie le timeout spécifie le délai d'expiration pour un job au format “h”, h représentant le nombre d'heures. La plage de paramètres est configurable sur le site du gestionnaire. Lorsque la valeur spécifiée dépasse la limite supérieure configurée, la limite supérieure est prise en considération pour la valeur, lorsque cette dernière est inférieure au seuil spécifié, c'est le seul qui est pris en compte pour cette valeur. Aucun avertissement n'est donné.
timeout ne doit pas être codé avec le paramètre d'expiration du délai du job (JobTimeout), sinon une erreur est renvoyée. Si aucun paramètre n'est codé, la valeur par défaut est 168.
Si ce paramètre est défini dans le script, la distribution associée sera envoyée à tous les domaines CA ITCM enregistrés sur le gestionnaire d'entreprise.
L'option de liaison du job est définie sur Exécution du job par lot.
Génère un job de désinstallation pour l'élément spécifié. La tâche associée de la procédure spécifiée doit être de type uninstall.
Le conteneur de jobs concerné reste descellé après la création du job généré.
Spécifie le version de l'élément pour lequel le job sera généré.
Spécifie le message d'administration personnalisé pour un job d'un conteneur de jobs.
Spécifie le message d'administration personnalisé pour un conteneur de jobs.
Les paramètres allowCancel, execTimedOut et prompt sont valides si l'option promptUser est déjà définie ou si elle est définie par cette commande à l'aide du paramètre promptUser.
Si l'option promptUser d'un job et le paramètre promptUser de la commande ne sont pas définis, ces paramètres sont ignorés.
Aucun avertissement n'est donné.
|
Copyright © 2013 CA.
Tous droits réservés.
|
|