Rubrique précédente: ExempleRubrique suivante: Exemple


modify—Modification des attributs d'un groupe de modèles / modèle logiciel

Cette commande permet de modifier les attributs du modèle et du groupe de logiciels existants.

Cette commande a le format suivant :

templategroup action=modify name=nom_groupe_modèle
[newName=nom_groupe_modèle] 
[swTemplate=nom_modèle_logiciel]
[newSwTemplate=nouveau_nom_modèle_logiciel]
[comment=commentaire]
[{query="requête" | queryfile=nom_fichier | noquery}]
[engineName=nom_moteur
[enginePeriod=fréquence_évalution_moteur]]
[{transaction|synchronized|nolinkage}]
[rollback[={y|n}]] 
[cascade[={y|n}]]
[{nosetup | setup_jobs | setup&activate_jobs}]
| [regenerate [ = {y/n}]]
| [{adhoc_disable | adhoc_only | adhoc_always}] 
[evaluationstart="AAAA-MM-JJ hh:mm"]
[evaluationperiod=heures]
[calendarname=nom_calendrier]
[globalTime[={y|n}]]
[jcPriority={1,...,10}]
[userMessage]
{adhoc_disable | adhoc_only | adhoc_always}

La définition des paramètres présente les effets suivants :

adhoc_disabled

L'évaluation adhoc est désactivée.

adhoc_only

L'évaluation Adhoc n'est activée que lorsque des cibles nouvelles ou réinstallées communiquent leurs données d'inventaire.

adhoc_always

L'évaluation Adhoc est toujours activée lorsque des cibles communiquent leurs données d'inventaire.

calendarname

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

Remarque : Pour activer une entrée calendarname, vous devez également coder evaluationPeriod.

cascade

Si cascade ou cascade=y est codé, la liaison de jobs du conteneur passe de la résolution des dépendances à l'installation en cascade.
Si la définition cascade=n est utilisée, aucune résolution n'est appliquée à la liaison de jobs.

Vous devez uniquement utiliser ce paramètre si la liaison de jobs du conteneur est en mode traitement par lot ou synchronisé ou si elle a été définie sur ce mode à l'aide de cette commande (définition sur transaction ou synchronous).

Commentaire

un commentaire sera remplacé par la valeur indiquée.

Remarque : Pour effacer un commentaire existant, saisissez une chaîne vide ("").

engineName

Spécifie le nom d'un moteur qui traitera l'évaluation du groupe.

Si une chaîne vide est saisie, alors n'importe quel moteur peut traiter la requête

Si aucune requête n'est actuellement assignée au groupe, un avertissement est émis et le paramètre est ignoré.

enginePeriod

Spécifie la période en minutes pendant laquelle le moteur évaluera de nouveau le groupe. Si ce paramètre n'est pas défini dans le script, sa valeur est 1 minute par défaut.Si aucune requête n'est actuellement assignée au groupe et qu'aucun moteur spécifique n'est défini pour procéder à l'évaluation, un avertissement est émis et le paramètre est ignoré.

evaluationstart

Heure à laquelle l'évaluation doit démarrer. La date doit être définie au format ISO AAAA-MM-JJ hh:mm. Si EvaluationStart n'est pas défini, l'heure courante est utilisée.

Ce paramètre ne s'applique qu'aux groupes modèle ou de requêtes.

evaluationperiod

Période pendant laquelle la requête est évaluée. La période est spécifiée en heures.

Ce paramètre peut être utilisé uniquement aux groupes modèle ou de requêtes.

Si vous entrez 0 (zéro), l'évaluation périodique est désactivée.

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.

jcPriority

Spécifie le nouvelle priorité qui sera affectée au conteneur de jobs.

La priorité spécifiée doit être numérique, supérieure ou égale à 1 et inférieure ou égale à 10.

Si ce paramètre n'est pas codé, la priorité n'est pas modifiée.

nom

Spécifie le nom de groupe modèle à modifier.

newName

Spécifie le nouveau nom de groupe modèle.

newSwTemplate

Spécifie le nouveau nom du modèle logiciel concerné.

nolinkage

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

noquery

Toute requête codée éventuelle est supprimée.

nosetup

Si ce paramètre est défini, la vérification de conformité des jobs est effectuée mais aucun job n'est configuré.

Requête

Indique que le modèle est également un groupe de requêtes. La requête définie dans le script doit être compatible avec une requête existante de USD 4.0 SP1.

queryfile

Spécifie le fichier dans lequel la requête est stockée. La taille de la requête stockée n'est limitée que par la capacité du serveur. La requête doit être compatible avec les requêtes existantes de SD 4.0 SP1.

régénérer

Si vous définissez regenerate ou regenerate=y, les jobs ayant précédemment échoué pour ce modèle sont régénérés.

Si vous définissez regenerate=n, la régénération n'a pas lieu.

Si le paramètre n'est pas défini, regenerate=y est utilisé comme valeur par défaut.

retour en arrière

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

Vous devez uniquement définir ce paramètre si le conteneur est déjà en mode traitement par lot ou s'il a été paramétré sur ce mode à l'aide de cette commande (paramètre transaction).

setup_jobs

En fonction de la vérification de conformité, permet de configurer des jobs mais ne les active pas.

setup&activate_jobs

Configuration et activation de job en fonction de la vérification de conformité.

Remarques : Si le paramètre setup&activate_jobs est utilisé depuis l'invite de commande ou au niveau du shell, vous devez le placer entre guillemets en raison de la signification particulière de & pour l'invite de commande ou le shell. Si vous utilisez des scripts de commandes, vous n'avez pas besoin d'utiliser de guillemets pour ce paramètre.

swTemplate

Spécifie le nom du modèle logiciel dont les attributs seront modifiés.

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

synchronized

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

transaction

L'option de liaison du job est définie sur Exécution du job par lot.

userMessage

Modifie le message d'administration personnalisé lors de la mise à jour d'un groupe de modèles.

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