Cette commande permet d'ajouter un job à un conteneur de jobs existant. Ce conteneur de jobs ne doit pas être scellé.
Cette commande a le format suivant :
jobcontainer action=ajout_job
name=nom_conteneur_jobs
{item=nom_élément version=version_élément
procedure=nom_procédure
{[task=install]
|task={configure|activate|uninstall}
[installedWith=procédure_installation]}
| group=nom_groupe [procedures=fichier]}
{{{compgrp=nom_groupe_ordinateurs | ccompgrp=(nom_groupe_ordinateurs sep groupScope)}
[sep=signe_séparateur]
|{computer=nom_ordinateur}}
[deliverytime="AAAA-MM-JJ hh:mm" ]
[attime="AAAA-MM-JJ hh:mm" ]
[{preaction={none|reboot|logoff}|bootbefore}]
[{postaction={none|reboot|logoff|rebootAtEnd|logoffAtEnd|shutdownAtEnd}|bootafter}]
[promptUser[={y|n}]]
[allowCancel[={y|n}]]
[execTimedOut[={y|n}]]
[offline[={y|n}]]
[runAtShutdown[={y|n}]]
[preventLogon[={y|n}]]
after={exacttime|boottime}
[calendarname=calendrier_livraison]
[globalTime=y|n]
[nocalendar[={y|n}]]
[resolveQuery[={y|n}]]
[stagingServer[={y|n}]]
[parameters=paramètres_utilisateur]
[prompt=jours.heures]]
[jobTimeOut=jours.heures]
[reinstall[={y|n}]]
[userJobMessage]
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 apparaît dans le script, l'utilisateur est invité à annuler l'exécution du job.
Si allowCancel =n apparaît dans le script, l'utilisateur sera 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 la date et l'heure à laquelle l'action doit démarrer.
La date est 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.
Indique le nom du calendrier contrôlant l'heure d'exécution de l'évaluation.
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.
Seules 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 d'un groupe d'ordinateurs sur lequel le produit spécifié doit être traité.
Vous pouvez faire figurer ce paramètre plusieurs fois dans le script pour traiter plusieurs groupes d'ordinateurs.
Ce paramètre ne doit pas apparaître en même temps que le paramètre computer.
Spécifie le nom de l'ordinateur sur lequel le produit spécifié doit être traité.
Vous pouvez faire figurer ce paramètre plusieurs fois dans le script pour traiter plusieurs ordinateurs.
Ce paramètre ne doit pas apparaître en même temps que le paramètre compgrp.
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.
Si ce paramètre n'apparaît pas dans le script, la date et l'heure courantes sont utilisées.
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 nom d'un groupe de logiciels ou de procédures pour lequel les jobs doivent être créés.
Ce paramètre ne doit pas apparaître en même temps que le paramètre item.
Spécifie le nom de la procédure d'installation.
Ce paramètre doit obligatoirement être codé pour les tâches de type configure, activate et uninstall. Sinon, il est ignoré.
Indique le nom de l'élément à traiter.
Ce paramètre ne doit pas apparaître en même temps que le paramètre group.
Spécifie la date d'expiration du job sous la forme d'une période.
La période est spécifiée au format j.h, j représentant les jours 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é.
Spécifie le nom du conteneur de jobs auquel le job doit être ajouté.
Si noCalendar apparaît dans le script, un éventuel calendrier situé sur l'ordinateur cible est ignoré pour l'exécution de ce job.
Si offline ou offline=y est défini, 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 spécifié, la connexion n'est pas libérée.
Spécifie les paramètres utilisateur pour 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 saisie, aucun paramètre par défaut n'est utilisé.
Spécifie que des actions nécessaires doivent être entreprises avant la fin de la procédure spécifié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 spécifié, la connexion de l'utilisateur n'est pas rejetée.
Spécifie le nom d'une procédure
Spécifie le nom du fichier définissant les procédures à utiliser pour le groupe de logiciels et/ou permettant de définir les options des jobs de chaque procédure (groupe de procédures et groupe de logiciels).
Pour le contenu de ce fichier de procédures, reportez-vous à la section Format de fichier de procédures
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.
(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 : Cette option s'applique uniquement à l'installation de jobs. Dans tout autre cas, elle est ignorée.
Evalue un groupe de requête susceptible d'être associé avant la génération du job.
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 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.
Spécifie le type de tâche que la procédure d'élément doit effectuer.
Voici les différents types autorisés :
La procédure active l'élément.
La procédure configure l'élément.
La procédure installe l'élément.
La procédure désinstalle l'élément.
Si le paramètre n'est pas défini, le type install est utilisé par défaut.
Spécifie la version de l'élément à traiter.
Spécifie le message d'administration personnalisé pour un job d'un conteneur de jobs.
Remarque : Vous devez tenir compte des éléments suivants :
Le fichier de procédures est spécifié selon la syntaxe suivante :
item = élément
version = version
procedure = procédure
task={install|configure|activate|uninstall}
[deliverytime=AAAA-MM-JJ hh:mm ]
[attime=AAAA-MM-JJ hh:mm ]
[after={exacttime|boottime}]
[calendarname=deliverycalendar]
[preaction={none|reboot|logoff}]
[postaction={none|reboot|logoff|rebootAtEnd|logoffAtEnd}]
[promptUser={o|n}]
[allowCancel={o|n}]
[execTimedOut={o|n}]
[prompt=jours.heures]
[offline={o|n}]
[RunAtShutdown={o|n}]
[PreventLogon={o|n}]
[GlobalTime={o|n}]
[nocalendar={o|n}]
[ResolveQuery={o|n}]
[Parameters=paramètre_utilisateur]
[stagingserver={o|n}]
[JobTimeout=j.h]
Nom de l'élément de groupe auquel cette entrée est associée
Version de l'élément de groupe auquel cette entrée est associée
Spécifie la procédure d'élément à appliquer
Indique le type de procédure.
Voici les différents types autorisés :
La procédure installe l'élément.
La procédure configure l'élément
La procédure active l'élément.
La procédure désinstalle l'élément.
Si le paramètre n'est pas défini, le type install est utilisé par défaut.
Les paramètres item, version, procedure et task doivent être codés au début de chaque ligne et dans le même ordre que dans la définition de syntaxe indiquée auparavant. Le paramètre restant peut être codé dans n'importe quel ordre.
La signification des autres paramètres correspond à celle des paramètres de commande affichés dans cadsmcmd jobcontainer action=addjob.
Les options de procédure d'une procédure de job proviennent des paramètres de cette liste.
Si, concernant une procédure, une option n'est pas codée dans l'entrée de liste associée, elle provient alors des paramètres de couche de commande.
Si elle n'est pas codée à cet emplacement, elle provient des options de procédure enregistrées.
|
Copyright © 2013 CA.
Tous droits réservés.
|
|