Cette action permet d'affecter un groupe de logiciels ou de procédures à des ordinateurs cibles ou à des groupes d'ordinateurs (comprenant les modèles logiciels). Si le groupe de logiciels contient des sous-groupes, ils prennent également part à l'affectation de manière récursive.
Le nom de la distribution ou du conteneur de jobs utilisé est imprimé sur la sortie standard avec d'autres informations.
Cette action a le format suivant :
swLibrary action=assignGroupToTarget name=nom_groupe
{{computer=nom_ordinateur} |
{compgrp=nom_groupe_ordinateurs | ccompgrp=(nom_groupe_ordinateurs sep groupScope)}
[sep=signe_séparateur]
| {swTemplates=nom_modèle_logiciel}}
cname=[nom]
[dname=nom_distribution]
[unsealed]
[{nolinkage|transaction[rollback]|synchronized}[nocascade]]
[deliveryTime="AAAA-MM-JJ hh:mm"]
[atTime="AAAA-MM-JJ hh:mm"]
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]
[procedures=fichier_procédures]
[{{area=nom_zone} | {domain=nom_domaine} | toAllAreas}]
[sendTime="AAAA-MM-JJ hh:mm"]
[haltTime="AAAA-MM-JJ hh:mm"]
[jcPriority={1,...,10}]
[distPriority={1,...,10}]
[reinstall[={y|n}]]
Heure de début de la procédure sur le système cible.
Les valeurs suivantes sont autorisées :
La procédure démarre immédiatement après avoir atteint la valeur atTime.
Le démarrage de la procédure est repoussé jusqu'à la première transmission de redémarrage après atTime.
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é.
Spécifie le nom d'un domaine CA ITCM auquel la distribution doit être envoyée.
Vous pouvez utiliser ce paramètre plusieurs fois. pour spécifier une liste de domaines CA ITCM.
Si ce paramètre est utilisé, la distribution est scellée et automatiquement envoyée à ses destinations une fois que la commande s'est terminée.
Si les paramètres area, domain et toAllAreas n'apparaissent pas dans le script, la distribution reste descellée et vous pouvez continuer de la manipuler.
Ce paramètre ne doit pas apparaître en même temps que les paramètres domain ou toAllAreas.
(gestionnaire d'entreprise uniquement)
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.
Si ce paramètre n'apparaît pas dans le script, la date et l'heure courantes sont utilisées.
Spécifie le nom du calendrier contrôlant l'heure d'exécution de l'évaluation.
Indique le groupe d'ordinateurs à désigner comme une paire nom/champ du groupe. Par défaut, le nom et la portée sont séparés par un point ("."). Un autre séparateur peut cependant être défini à l'aide de l'option sep. Le séparateur ne doit pas faire partie des noms.
Seules les valeurs suivantes sont autorisées pour le champ groupe.
Le groupe est créé au niveau du gestionnaire de domaines local.
Le groupe a été créé au niveau du gestionnaire d'entreprise et peut être dupliqué.
Le paramètre ccompgrp peut être codé en même temps que le paramètre compgrp, en un appel.
Spécifie le le nom unique facultatif de conteneur de job.
Si aucun paramètre n'est fourni, un nom est généré en interne et l'interface de ligne de commande renvoie cet identificateur.
Les jobs générés lui seront assignés.
Si ce conteneur de jobs n'existe pas, il est créé.
S'il existe et qu'il est descellé, les jobs générés sont ajoutés.
S'il est scellé, cadsmcmd se termine en signalant une erreur.
Spécifie le groupe d'ordinateurs à désigner.
Vous pouvez utiliser ce paramètre plusieurs fois. pour désigner plusieurs groupes d'ordinateurs.
Ce paramètre ne doit pas être spécifié en même temps que les paramètres swTemplates ou computer.
Spécifie le nom d'un ordinateur à désigner.
Vous pouvez utiliser ce paramètre plusieurs fois. pour désigner plusieurs ordinateurs.
Ce paramètre ne doit pas être spécifié en même temps que les paramètres swTemplates ou compgrp.
(gestionnaire de domaines uniquement)
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.
Spécifie le priorité qui sera affectée à la distribution.
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 défini dans le script, la priorité 5 est utilisée par défaut.
Spécifie le nom de la distribution dans lequel les jobs et le conteneur doivent être stockés.
Si la distribution existe déjà et qu'elle est encore ouverte pour les manipulations, elle est utilisée. Sinon, un message d'erreur apparaît. Si la distribution n'existe pas, elle est créée.
Si le paramètre n'est pas utilisé, une distribution avec un nom par défaut est générée.
(gestionnaire d'entreprise uniquement)
Spécifie le nom d'un groupe de domaines CA ITCM auquel la distribution doit être envoyée.
Vous pouvez utiliser ce paramètre plusieurs fois. pour désigner une liste de groupes de domaines CA ITCM.
Si ce paramètre est utilisé, la distribution est scellée et automatiquement envoyée à ses destinations une fois que la commande s'est terminée.
Si les paramètres area, domain et toAllAreas n'apparaissent pas dans le script, la distribution reste descellée et vous pouvez continuer de la manipuler.
Ce paramètre ne doit pas apparaître en même temps que les paramètres area ou toAllAreas.
(gestionnaire d'entreprise uniquement)
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é.
Si promptUser n'est ni défini par cet appel, ni déjà activé, ce paramètre est ignoré. Aucun avertissement n'est donné.
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)
Spécifie le date et heure auxquelles une commande de distribution doit être interrompue La date doit être au format ISO AAAA-MM-JJ hh:mm.
Pour obtenir des informations supplémentaires sur la reprise d'une distribution interrompue, consultez la commande resume.
Spécifie le priorité du 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.
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.
Spécifie le nom du groupe. S'il s'agit d'un groupe de logiciels, les membres du groupe seront installés sur le site cible
L'option des procédures permet de spécifier et de configurer la procédure des membres a exécuter sur la cible. Si elle n'est pas codée, les procédures d'installation par défaut des membres sont utilisées.
S'il s'agit d'un groupe de procédures, elles sont exécutées sur le site cible.
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 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é.
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.
Exécute le job indépendamment des autres jobs du conteneur.
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é.
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'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é.
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 :
N'effectue aucune action ultérieure.
Redémarre le système une fois la procédure terminée.
Déconnecte l'utilisateur une fois la procédure terminée.
Redémarre le système une fois tous les jobs de ce conteneur terminés.
Déconnecte l'utilisateur une fois tous les jobs de ce conteneur terminés.
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é.
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 :
N'effectue aucune action antérieure.
Redémarre le système avant le début de la procédure.
Déconnecte l'utilisateur avant le début de la procédure.
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 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é.
Spécifie le nom du fichier définissant les procédures à utiliser pour le groupe de logiciels et/ou permettant de définir les options des jobs de chaque procédure (groupe de procédures et groupe de logiciels)..
Le contenu de ce fichier de procédures est affiché dans le Format de fichier de procédures.
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 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é.
L'option reinstall est facultative, sa valeur par défaut étant reinstall=n.
Si reinstall ou reinstall=y est codé, un enregistrement d'installation lié à la commande peut être supprimée avant que le job ne soit évalué par le gestionnaire de domaines.
Si reinstall=n est codé, ces enregistrements sont conservés.
Remarque : Cette option s'applique uniquement à l'installation de jobs. Dans tout autre cas, elle est ignorée.
Evalue un groupe de requête susceptible d'être associé avant la génération du job.
Définit l'option de liaison de job sur Activer la transaction.
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.
Spécifie le heure à laquelle la distribution associée doit être envoyée aux gestionnaires de domaines désignés. La date doit être 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.
(gestionnaire d'entreprise uniquement)
Spécifie un autre séparateur pour l'option ccompgroup. Ce séparateur ne doit pas être inclus dans le code du nom du groupe avec les options ccompgroup.
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.
Spécifie le nom du modèle logiciel.
Le paramètre peut être codé plusieurs fois pour solliciter plusieurs modèles logiciels.
S'il est codé, le paramètre cname devient obsolète et les jobs à générer ne sont affectés à aucun conteneur mais au modèle logiciel. Pour cela, les modèles logiciels de la liste ne doivent pas être scellés.
Ce paramètre ne doit pas être spécifié en même temps que les paramètres compgrp ou computer.
L'option de liaison de job est définie sur Exécution d'un job synchronisé.
Si ce paramètre est défini dans le script, la distribution associée sera envoyée à tous les domaines CA ITCM enregistrés sur le gestionnaire d'entreprise.
toAllAreas ne doit pas apparaître en même temps que les paramètres area ou domain.
Si les paramètres area, domain et toAllAreas n'apparaissent pas dans le script, la distribution reste descellée et vous pouvez continuer de la manipuler.
(gestionnaire d'entreprise uniquement)
L'option de liaison du job est définie sur Exécution du job par lot.
Il s'agit du paramètre par défaut.
Le conteneur de jobs concerné reste descellé après la création du job généré.
(gestionnaire de domaines uniquement)
Remarques :
Si les paramètres area, domain et toAllAreas n'apparaissent pas dans le script, le conteneur de distribution reste descellé et vous pouvez continuer de le manipuler.
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é.
|
Copyright © 2013 CA.
Tous droits réservés.
|
|