Cette commande permet d'ajouter des jobs à une stratégie logicielle locale descellée. Les jobs à ajouter peuvent être indiqués par des groupes de procédures ou de logiciels, par un fichier contenant toutes les informations nécessaires, ou par transmission directe des informations d'un job au moment de l'appel. Si l'ajout est correctement effectué, cette action peut éventuellement sceller la stratégie.
Cette commande a le format suivant :
swPolicy action=addItem
name=nom_stratégie_logicielle
{group=nom_d'_un_groupe_de_logiciels_ou_de_procédures|
procedures=fichier_job|
item=nom_élément
version=version_élément
[task={activate | configure | install | uninstall}]
procedure=nom_procédure
[installedWith=nom_procédure_installation]
[after={exacttime | boottime}]
[reinstall[={y|n}]]
[preaction={none | reboot | logoff}]
[action ultérieure = {aucune | redémarrer | déconnecter | rebootAtEnd | logoffAtEnd | shutdownAtEnd}]
[promptUser[={y|n}]]
[allowCancel[={y|n}]]
[execTimedOut[={y|n}]]
[offline[={y|n}]]
[runAtShutdown[={y|n}]]
[preventLogon[={y|n}]]
[triggeredByScalSrv[={y|n}]]
[globaltime[={y|n}]]
[calendarname=nom_calendrier_livraison]
[noCalendar[={y|n}]]
[resolveQuery[={y|n}]]
[stagingServer[={y|n}]]
[parameters=paramètres_utilisateur]
[prompt=j.h]
[jobTimeout=j.h]
[repeat[={y|n}]]
[seal[={y|n}]]
[userJobMessage]
Nom de la stratégie logicielle à laquelle les jobs seront ajoutés.
Cette option indique le nom d'un groupe de logiciels ou de procédures. Les membres de ce groupe sont utilisés pour ajouter des jobs à la stratégie logicielle.
Les jobs de cette stratégie sont générés à partir des procédures d'installation par défaut des membres du groupe, le cas échéant, ou à partir de la première procédure d'installation. Les options des jobs sont issues des valeurs par défaut ou sont héritées de la procédure. Si un membre ne possède pas de procédure d'installation, il est ignoré et un avertissement est signalé.
Les jobs de cette stratégie sont générés à partir des procédures du groupe. Les options des jobs sont issues des valeurs par défaut ou sont héritées de la procédure.
Si cette option n'est pas codée, aucun groupe n'est évalué pour le remplissage de la stratégie logicielle créée.
Cette option du groupe ne doit pas être codée à l'aide de l'option procedures ou item.
Cette option indique le nom d'un fichier contenant les procédures de génération de jobs de la stratégie logicielle. Pour chaque job à créer et à affecter à la stratégie, vous devez créer, dans le fichier, une entrée comportant la syntaxe suivante :
item=nom_élément version=version_élément
procedure=nom_procédure
task={activate | configure | install | uninstall}
[installedWith=nom_procédure_installation]
[after={exacttime | boottime}]
[reinstall[={y|n}]]
[preaction={none | reboot | logoff}]
[action ultérieure = {aucune | redémarrer | déconnecter | rebootAtEnd | logoffAtEnd | shutdownAtEnd}]
[promptUser[={y|n}]]
[allowCancel[={y|n}]]
[execTimedOut[={y|n}]]
[offline[={y|n}]]
[runAtShutdown[={y|n}]]
[preventLogon[={y|n}]]
[triggeredByScalSrv[={y|n}]]
[globaltime[={y|n}]]
[calendarname=nom_calendrier_livraison]
[noCalendar[={y|n}]]
[resolveQuery[={y|n}]]
[stagingServer[={y|n}]]
[parameters=paramètres_utilisateur]
[prompt=j.h]
[jobTimeout=j.h]
[repeat[={y|n}]]
Il ne doit y avoir qu'une entrée par ligne et une entrée ne doit pas s'étendre sur plusieurs lignes. Cette entrée doit commencer par les paramètres item, version, procedure et task, dans cet ordre. L'ordre des paramètres restants est sans importance. Les valeurs de paramètre contenant des espaces doivent être placées entre guillemets ("). Si la valeur d'un paramètre comporte un guillemet, elle doit être dupliquée.
Pour connaître la signification des paramètres, consultez l'option descriptions ci-dessous.
L'option procedures ne doit pas être codée en même temps que l'option group ou item.
Indique le nom d'un élément enregistré. Le job de cet élément sera généré et ajouté à la stratégie logicielle.
L'option item ne doit pas être codée en même temps que l'option group ou procedures.
Indique la version de l'élément indiqué qui est utilisée pour la génération de jobs.
Indique le type de procédure pour laquelle le job sera ajouté à la stratégie logicielle. Les types de tâches suivants sont valides :
La procédure sélectionnée est une procédure d'activation.
La procédure sélectionnée est une procédure de configuration.
La procédure sélectionnée est une procédure d'installation.
La procédure sélectionnée est une procédure d'installation.
Si l'option n'est pas codée, sa valeur par défaut est install.
Nom de la procédure utilisée pour générer le job à ajouter à la stratégie logicielle
S'il est spécifié, il s'agit du nom d'une procédure d'installation de l'élément indiqué. Le job à générer n'est exécuté que sur les machines sur lesquelles l'élément est installé par le biais de la procédure indiquée. Ce paramètre est ignoré si le job à ajouter est lui-même un job d'installation.
Si cette option n'est pas codée, le mode d'installation de l'élément n'est pas vérifié.
Cette option indique le moment auquel l'exécution du job va démarrer sur les systèmes cibles. Les valeurs suivantes sont autorisées :
La procédure lance le traitement dès que l'ordre arrive à échéance.
Une fois l'arrivée à échéance, le traitement de la procédure est différé au prochain (re)démarrage.
Sa valeur par défaut est exacttime.
Si reinstall ou reinstall=y est codé, l'élément sera réinstallé sur les cibles à chaque évaluation de la stratégie logicielle. Si reinstall=n est codé ou que l'option est absente, l'élément ne sera installé que s'il ne se trouve pas sur les cibles. Cette option est valide pour les procédures install ; elle est ignorée pour tout autre type de procédure.
Spécifie toute action devant avoir lieu avant le traitement du job associé sur les ordinateurs cibles. Les actions préalables valides sont les suivantes :
N'effectue aucune action préalable.
Redémarre le système avant l'exécution du job.
Déconnecte les utilisateurs avant l'exécution du job.
Si cette option n'est pas codée, les options de la procédure d'élément indiquent la valeur par défaut.
Spécifie toute action devant avoir lieu après le traitement du job associé sur les ordinateurs cibles. Les actions consécutives ci-dessous sont valides :
N'effectue aucune action ultérieure.
Redémarre le système après l'exécution du job.
Déconnecte les utilisateurs après l'exécution du job.
Spécifie le redémarrage nécessaire du job après son traitement. Vous pouvez toutefois différer ce redémarrage jusqu'à ce que tous les autres jobs résultant de la même évaluation de la stratégie logicielle soient traités ou qu'un job ultérieur nécessite un redémarrage immédiat avant ou après son traitement.
Spécifie que le job requiert que l'utilisateur se déconnecte après sont traitement. Vous pouvez toutefois différer la déconnexion jusqu'à ce que tous les autres jobs résultant de la même évaluation de la stratégie logicielle soient traités ou qu'un job ultérieur nécessite une déconnexion ou un redémarrage immédiat avant ou après son traitement.
Arrête l'ordinateur cible une fois les jobs achevés.
Si cette option n'est pas codée, les options de la procédure d'élément indiquent la valeur par défaut.
Si promptUser ou promptUser=y a été indiqué, l'utilisateur travaillant sur les cibles est invité à réaliser une action avant l'exécution du job. Si prompt=n est indiqué, le job est exécuté sans invite de l'utilisateur.
Si cette option n'est pas codée, la valeur par défaut est donnée par les options de procédure de l'élément.
Si allowCancel ou allowCancel=y est indiqué, l'utilisateur travaillant sur les cibles peut annuler l'exécution du job au moment où il est invité à l'exécuter. Si allowCancel=n est indiqué, l'utilisateur ne peut annuler le job.
Pour permettre l'annulation, l'invite doit être autorisée. Sinon, une erreur est signalée.
Si cette option n'est pas codée, la valeur par défaut est donnée par les options de procédure de l'élément.
Si execTimedOut ou execTimedOut=y est codé, le traitement du job est automatiquement lancé lorsque l'invite de l'utilisateur expire. Si execTimedOut=n est codé, le job n'est pas lancé à l'expiration.
Pour qu'il soit lancé à l'expiration, l'invite doit être autorisée, sinon une erreur est signalée.
Si cette option n'est pas codée, la valeur par défaut est donnée par les options de procédure de l'élément.
Si offline ou offline=y est codé, la connexion entre la cible et le serveur associé est libérée pour l'exécution du job. En revanche, si offline=n est codé, la connexion n'est pas libérée.
Si cette option n'est pas codée, la valeur par défaut est donnée par les options de procédure de l'élément.
Si runAtShutdown ou runAtShutdown=y est codé, le job est exécuté uniquement à la fermeture du système. En revanche, si runAtShutdown=n est codé, le job est exécuté également à son échéance, quel que soit le moment.
Si cette option n'est pas codée, la valeur par défaut est donnée par les options de procédure de l'élément.
Cette option s'applique uniquement à UNIX.
Si preventLogon ou preventLogon=y est codé, toute tentative de connexion utilisateur sur les cibles est rejetée pendant l'exécution du job. Si un utilisateur est déjà connecté au moment où le job est lancé, son exécution est différée jusqu'à ce que l'utilisateur se déconnecte.
Si preventLogon=n est codé, le traitement du job ne prend pas en compte les connexions utilisateur ni les tentatives de connexion pendant le temps d'exécution.
Si cette option n'est pas codée, la valeur par défaut est donnée par les options de procédure de l'élément.
Cette option s'applique uniquement aux cibles Windows.
Si triggeredByScalSrv ou triggeredByScalSrv=y est codé, les serveurs de modularité associés aux cibles lancent l'exécution du job. Si triggeredByScalSrv=n est codé, la cible lance l'exécution au moment du redémarrage ou de la vérification des jobs.
La valeur par défaut est triggeredByScalSrv.
Si globalTime ou globalTime=y est codé, toutes les dates associées au job sont basées sur l'heure du gestionnaire d'entreprise, sinon elles sont basées sur l'heure du gestionnaire de domaines.
La valeur par défaut est globaltime=n.
Indique le nom du calendrier chargé de régir la livraison du job aux serveurs de modularité et aux cibles.
Si noCalendar ou noCalendar=y est codé, le calendrier d'exécution possible attaché aux ordinateurs cibles sera ignoré pour le traitement du job. Si noCalendar=n est codé, le calendrier est pris en compte.
La valeur par défaut est noCalendar=n.
Si resolveQuery ou resolveQuery=y est codé et que le groupe associé au modèle logiciel est un groupe de requêtes, ce groupe est réévalué avant la création du job. Sinon, aucune réévaluation ne peut avoir lieu.
La valeur par défaut est resolveQuery=n.
Si stagingserver ou stagingserver=y est codé, l'élément associé est stocké de façon intermédiaire sur les serveurs de modularité associés aux cibles concernées, sinon il n'est pas stocké de façon intermédiaire. Cette option est ignorée si la procédure n'est pas une procédure d'installation. Si stagingserver ou stagingserver=n n'est pas codé, l'étape de stockage intermédiaire est ignorée.
La valeur par défaut est stagingserver=n.
Indique les paramètres transmis à la procédure du job. Si une chaîne vide est codée, on suppose qu'elle ne comporte pas de paramètres.
Si elle n'est pas codée, les paramètres de l'utilisateur proviennent des options de la procédure de l'élément.
Indique la période de temps pendant laquelle l'utilisateur est invité à démarrer l'exécution du job sur la cible lorsqu'il en diffère l'exécution. Le format de cette période est j.h, j représentant les jours et h les heures. La plage de valeurs est la suivante : 0.3 <= j.h <=7.0.
Si la valeur spécifiée est inférieure à la valeur minimale autorisée, c'est la valeur minimale qui est utilisée, et si elle dépasse la valeur maximale, c'est cette dernière qui est utilisée. Dans les deux cas, aucun avertissement n'est donné.
Spécifie la date d'expiration du job sous la forme d'une période de temps. Le format de la période est j.h, j représentant le jour et h les heures. La plage de paramètres est configurable sur le site du gestionnaire.
Si la valeur spécifiée est inférieure à la valeur minimale autorisée, c'est la valeur minimale qui est utilisée, et si elle dépasse la valeur maximale, c'est cette dernière qui est utilisée. Dans les deux cas, aucun avertissement n'est donné. Si elle n'est pas codée, la valeur pas défaut est 7.0.
Si repeat ou repeat=y est codé, le job associé est répété à chaque évaluation. Si repeat=n est codé, le job associé n'est pas répété.
La valeur par défaut est repeat=n.
Si seal ou seal=y est codé, la stratégie est scellée après l'ajout des jobs, sinon elle demeure descellée pour des modifications supplémentaires. Le scellement n'est réalisé que si la génération et l'ajout de tous les jobs requis ont été réussis et qu'aucune erreur n'a été signalée pour aucun des jobs. Les avertissements portant sur les jobs générés n'annulent pas le scellement.
La valeur par défaut est seal=n
Spécifie le message d'administration personnalisé pour un job d'une stratégie logicielle.
Remarque : Lorsque les jobs à ajouter proviennent d'un groupe ou du fichier de procédures, une erreur détectée pendant la génération de ces jobs est signalée pour le job concerné et le processus se poursuit avec la génération du job suivant. Aucun retour en arrière n'est effectué.
|
Copyright © 2013 CA.
Tous droits réservés.
|
|