Rubrique précédente: ExempleRubrique suivante: Exemple


modifyItem—Modification d'un élément dans un modèle logiciel

Cette commande permet de modifier les attributs d'un job affecté à un modèle logiciel.

Cette commande a le format suivant :

templategroup action=modifyItem name=nom_groupe_modèle
[swTemplate=nom_modèle_logiciel]
jobName=nom_de_commande_élément 
[newJobName=nouveau_nom_de_commande_élément]
after={exacttime|boottime} 
[calendarname=calendrier_livraison]
[preaction={none|reboot|logoff}]
[postaction={none|reboot|logoff|rebootAtEnd|logoffAtEnd|shutdownAtEnd}]
[promptUser[={y|n}]] 
[allowCancel[={y|n}]] 
[execTimedOut[={y|n}]]
[prompt=jours.heures] 
[offline[={y|n}]] 
[runAtShutdown[={y|n}]]
[preventLogon[={y|n}]] 
[globalTime] 
nocalendar]
[resolveQuery] 
[parameters=paramètres_utilisateur]
[repeat={y|n}] 
[stagingserver]
[jobTimeout=j.h]
[reinstall[={y|n}]]
[userJobMessage]
après

Heure de début de la procédure sur le système cible.

Les valeurs suivantes sont autorisées :

exacttime

La procédure démarre immédiatement après avoir atteint la valeur atTime.

boottime

Le démarrage de la procédure est repoussé jusqu'à la première transmission de redémarrage après atTime.

allowCancel

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

calendarname

Spécifie le nom du calendrier contrôlant l'heure d'exécution de l'évaluation.

Si une chaîne vide ("") est définie, calendarname est retiré.

execTimedOut

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.

globalTime

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.

jobName

Spécifie le nom du job à modifier.

jobTimeout

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.

nom

Spécifie le nom de groupe modèle dont un élément est modifié.

newJobName

Spécifie le nouveau nom du job .

noCalendar]

Si noCalendar apparaît dans le script, un éventuel calendrier situé sur l'ordinateur cible est ignoré pour l'exécution de ce job.

hors ligne

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.

paramètres

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

postaction

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 :

none

N'effectue aucune action ultérieure.

reboot

Redémarre le système une fois la procédure terminée.

logoff

Déconnecte l'utilisateur une fois la procédure terminée.

rebootAtEnd

Redémarre le système une fois tous les jobs de ce conteneur terminés.

logoffAtEnd

Déconnecte l'utilisateur une fois tous les jobs de ce conteneur terminés.

shutdownAtEnd

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

preaction

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 :

none

N'effectue aucune action antérieure.

reboot

Redémarre le système avant le début de la procédure.

logoff

Déconnecte l'utilisateur avant le début de la procédure.

preventLogon

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.

prompt=d.h

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

promptUser

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.

réinstaller

Si la commande est reinstall ou reinstall=y, un conteneur de jobs pour l'installation du package logiciel sera configuré lors de chaque évaluation de la stratégie, même si la stratégie a déjà été installée avec la procédure d'installation sélectionnée.

Remarque : Aucun conteneur de jobs ne sera configuré lors de l'évaluation de la stratégie si un autre job d'installation avec la procédure d'installation sélectionnée ou un job de désinstallation est en cours pendant l'évaluation de la stratégie.

repeat

Si vous utilisez ce paramètre, le job est répété à chaque évaluation.

resolveQuery

Evalue un groupe de requête susceptible d'être associé avant la génération du job.

runAtShutdown

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.

stagingServer

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.

swTemplate

Spécifie le nom du modèle logiciel qui contient l'élément à modifier.

Si ce paramètre n'est pas défini, le nom par défaut “<nom du groupe> [$date $time]” est utilisé.

Remarque : Si un paramètre n'est pas codé, l'attribut correspondant ne change pas.

userJobMessage

Modifie le message d'administration personnalisé d'un job, lors de la mise à jour des propriétés du job, dans un groupe de modèles.

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