Rubrique précédente: listItem—Affichage d'informations relatives à des jobs affectés à une stratégie logicielleRubrique suivante: showAttrItem—Affichage d'informations relatives à un job affecté à une stratégie logicielle


modifyItem—Modification d'un job d'une stratégie logicielle locale descellée

Cette commande permet de modifier un job d'une stratégie logicielle locale descellée. (facultatif) Vous pouvez sceller la stratégie à l'aide de cette commande.

Cette commande a le format suivant :

swPolicy	action=modifyItem
name=nom_stratégie_logicielle
jobname=nom_du_job
[newjobname=nouveau_nom_du_job]
[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

Nom de la stratégie logicielle contenant le job à modifier.

nomjob

Nom du job modifié.

newjobname

Nouveau nom du job. S'il n'est pas codé, c'est l'ancien nom qui demeure.

après

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 :

exacttime

Le job commence à être traité dès que la commande arrive à échéance.

boottime

Une fois l'échéance arrivée, le traitement du job est différé jusqu'au prochain (re)démarrage.

Si cette option n'est pas codée, elle n'est pas modifiée.

réinstaller

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é, l'élément ne sera installé que s'il ne se trouve pas sur les cibles. Cette option est valide uniquement pour les procédures d'installation ; pour tout autre type de procédure, elle est ignorée.

Si cette option n'est pas codée, elle n'est pas modifiée.

preaction={none | reboot | logoff}]

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 :

none

N'effectue aucune action préalable.

reboot

Redémarre le système avant l'exécution du job.

logoff

Déconnecte les utilisateurs avant l'exécution du job.

Si cette option n'est pas codée, elle n'est pas modifiée.

action ultérieure = {aucune | redémarrer | déconnecter | rebootAtEnd | logoffAtEnd | shutdownAtEnd}]

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 :

none

N'effectue aucune action ultérieure.

reboot

Redémarre le système après l'exécution du job.

logoff

Déconnecte les utilisateurs après l'exécution du job.

rebootAtEnd

Spécifie le redémarrage nécessaire du job après son traitement. Cependant, ce redémarrage peut être différé jusqu'à ce que tous les autres jobs résultant de la même évaluation de la stratégie logicielle aient été traités ou qu'un job suivant nécessite un redémarrage immédiat avant ou après son traitement.

logoffAtEnd

Spécifie que le job requiert la deconnexion de l'utilisateur après son traitement. Cependant, la déconnexion peut être différée jusqu'à ce que tous les autres jobs résultant de la même évaluation de la stratégie logicielle aient été traités ou qu'un job suivant nécessite une déconnexion ou un redémarrage immédiats avant ou après son traitement.

shutdownAtEnd

Arrête l'ordinateur cible une fois les jobs achevés.

Si cette option n'est pas codée, elle n'est pas modifiée.

promptUser

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 promptUser=n est spécifié, le job est exécuté sans aucune invite d'utilisateur.

Si cette option n'est pas codée, elle n'est pas modifiée.

allowCancel

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 que l'annulation ait lieu, l'invite est nécessaire, sinon une erreur est signalée.

Si cette option n'est pas codée, elle n'est pas modifiée.

execTimedOut

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é, la procédure n'est pas lancée à 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, elle n'est pas modifiée.

hors ligne

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, elle n'est pas modifiée.

runAtShutdown

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, elle n'est pas modifiée.

Cette option s'applique uniquement à UNIX.

preventLogon

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, elle n'est pas modifiée.

Cette option s'applique uniquement aux cibles Windows.

triggeredByScalSrv

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.

Si cette option n'est pas codée, elle n'est pas modifiée.

globaltime

Si globalTime ou globalTime=y est codé, toutes les dates associées au job se basent sur l'heure du gestionnaire d'entreprise. Si globaltime=n est codé, elles se basent sur l'heure du gestionnaire de domaines.

Si cette option n'est pas codée, elle n'est pas modifiée.

calendarname

Indique le nom du calendrier chargé de régir la livraison du job aux serveurs de modularité et aux cibles. Si la chaîne vide (“”) est codée, l'entrée du calendrier de livraison est vidée.

Si cette option n'est pas codée, elle n'est pas modifiée.

noCalendar]

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.

Si cette option n'est pas codée, elle n'est pas modifiée.

resolveQuery

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 pour la procédure associée. Si resolveQuery=n est codé, aucun réévaluation n'a lieu.

Si cette option n'est pas codée, elle n'est pas modifiée.

stagingserver

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, sinon il n'est pas stocké de façon intermédiaire. Cette option est ignorée si le job n'est pas un job d'installation. Si stagingserver=n est codé, l'étape de stockage intermédiaire est ignorée

Si cette option n'est pas codée, elle n'est pas modifiée.

paramètres

Indique les paramètres transférés à la procédure de job. Si une chaîne vide (“”) est codée, on suppose qu'aucun paramètre ne doit être transféré.

Si cette option n'est pas codée, elle n'est pas modifiée.

invite

indique le moment auquel l'utilisateur sera de nouveau invité à démarrer la procédure de job sur la cible en cas d'exécution différée. 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é.

Si cette option n'est pas codée, elle n'est pas modifiée.

jobTimeout

Spécifie la date d'expiration de la procédure sous la forme d'une période de temps. Le format de la période est j.h, j désignant 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 cette option n'est pas codée, elle n'est pas modifiée.

repeat

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

Si cette option n'est pas codée, elle n'est pas modifiée.

seal

Si seal ou seal=y est codé, la stratégie est scellée après la modification, sinon elle demeure descellée pour des modifications supplémentaires. Le scellement n'est effectué que lorsque les modifications ont été effectuées et qu'aucune erreur n'a été signalée. Les avertissements n'annulent pas le scellement.

Si cette option n'est pas codée, elle n'est pas modifiée.

userJobMessage

Permet de modifier le message d'administration personnalisé pour un job d'une stratégie logicielle.