Rubrique précédente: showAttrItem—Affichage des attributs d'un élément dans un modèle logicielRubrique suivante: Exemple


uninstallItem—Désinstallation d'un élément d'un groupe de modèles

Cette commande affecte un job de désinstallation au modèle logiciel.

Cette commande a le format suivant :

templategroup action=uninstallItem name=nom_groupe_modèle
[swTemplate=nom_modèle_logiciel]
item=nom_élément
version=version_élément 
procedure=nom_procédure
[installedWith=procédure_installation] 
after={exacttime|boottime} 
[calendarname=calendrier_livraison]
[{preaction={none|reboot|logoff}|bootbefore}]
[{postaction={none|reboot|logoff|rebootAtEnd|logoffAtEnd|shutdownAtEnd}|bootafter}]
[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]
[{jobTimeOut=j.h | timeout=heures}]
[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.

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.

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

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. (par défaut)

installedWith

Spécifie le nom de la procédure d'installation ayant installé cet élément sur le système cible.

élément

Spécifie le nom de l'élément à désinstaller.

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 auquel la commande de désinstallation est ajoutée.

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.

Si noCalendar=n apparaît dans le script, le calendrier ne sera pas ignoré (valeur par défaut).

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

Si le paramètre n'est pas défini dans le script, les paramètres d'utilisateur par défaut utilisés sont ceux indiqués dans la définition de la procédure.

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.

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

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.

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

procédure

Spécifie le nom de la procédure de désinstallation à appliquer.

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.

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

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.

swTemplate

Spécifie le nom du modèle logiciel auquel la commande de désinstallation est ajoutée.

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

temporisation

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.

version

Spécifie le version de l'élément à désinstaller.

userJobMessage

Spécifie le message d'administration personnalisé pour un job de désinstallation 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é.