Rubrique précédente: ExempleRubrique suivante: removeJob—Suppression d'un job d'une liste de jobs


reinstallProduct—Réinstallation d'un produit

Cette action réinstalle sur un ordinateur cible un produit marqué comme étant déjà installé.

Cette action a le format suivant :

targetcomputer action=reInstallProduct
name=nom_ordinateur
item=nom_élément 
version=version_élément 
procedure=procédure_installation
cname=[nom]
[{noLinkage|rollback|synchronized}]
[nocascade]
[deliveryTime="AAAA-MM-JJ hh:mm"] 
[atTime="AAAA-MM-JJ hh:mm"]
after={exacttime|boottime} 
[calendarname=nom_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]
[parameters=paramètres_utilisateur] 
[jobTimeOut=j.h]
[unsealed]
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é.

Si promptUser n'est ni défini par cet appel, ni déjà activé, ce paramètre est ignoré. Aucun avertissement n'est donné.

atTime

Spécifie le Spécifie la date et l'heure à laquelle l'action doit démarrer.

La date est au format ISO AAAA-MM-JJ hh:mm.

calendarName

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

cname

Spécifie un le nom unique facultatif de conteneur de job (valeur par défaut : nom_ordinateur_cible[AAAA-MM-JJ hh:mm:ss]).

Ce paramètre est utilisé pour distribuer la requête. Si le conteneur existe déjà mais qu'il est descellé, il est utilisé sans aucune modification de ses options de liaison ou de cascade. S'il existe mais qu'il est scellé, une erreur est signalée. Si le conteneur de jobs n'existe pas, il est créé conformément aux paramètres de liaison et de cascade spécifiés.

deliveryTime

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.

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 promptUser n'est ni défini par cet appel, ni déjà activé, ce paramètre est ignoré. Aucun avertissement n'est donné.

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.

élément

Spécifie le nom de l'élément à réinstaller.

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 l'ordinateur sur lequel le produit doit être réinstallé.

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.

noCascade

L'option de liaison de job est définie sur Ignorer l'installation en cascade.

Ce paramètre est autorisé uniquement si transaction ou synchronized est défini dans le script.

noLinkage|rollback|synchronized

S'il existe plusieurs jobs, ce mode gère la liaison entre les différents jobs d'un conteneur. La définition des paramètres présente les effets suivants :

aucune définition

Utilisation du mode de traitement par lot des jobs, sans retour en arrière.

noLinkage

Exécute le job indépendamment des autres jobs du conteneur.

rollBack

Définit l'option de liaison de job sur Activer la transaction.

synchronized

L'option de liaison de job est définie sur Exécution d'un job synchronisé.

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.

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

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.

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.

procédure

Spécifie le nom d'une procédure

à utiliser pour la réinstallation.

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

Si promptUser n'est ni défini par cet appel, ni déjà activé, ce paramètre est ignoré. 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é.

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.

unsealed

Le conteneur de jobs concerné reste descellé après la création du job généré.

version

Spécifie le version de l'élément.

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