Mit Hilfe dieser Aktion kann Zielcomputern oder Computergruppen (einschließlich Softwarevorlagen) eine Softwaregruppe oder eine Prozedurgruppe zugewiesen werden. Wenn die Softwaregruppe Untergruppen enthält, sind diese Untergruppen rekursiv an der Zuordnung beteiligt.
In der Standardausgabe wird neben weiteren Informationen der Name des verwendeten Jobcontainers oder der verwendeten Verteilung angezeigt.
Diese Aktion hat das folgende Format:
swLibrary action=assignGroupToTarget name=Gruppenname
{{computer=Computername} |
{compgrp=Computergruppenname | ccompgrp=(Computergruppenname Trennzeichen Gruppenbereich)}
[sep=Trennzeichen]
| {swTemplates=Name_der_Softwarevorlage}}
cname=[Name]
[dname=Name_der_Verteilung]
[unsealed]
[{nolinkage|transaction[rollback]|synchronized}[nocascade]]
[deliveryTime=JJJJ-MM-TT HH:MM]
[atTime=JJJJ-MM-TT HH:MM]
after={exacttime|boottime}
[calendername=Lieferungskalender]
[preaction={none|reboot|logoff}]
[postaction={none|reboot|logoff|rebootAtEnd|logoffAtEnd|shutdownAtEnd}]
[promptUser[={y|n}]]
[allowCancel[={y|n}]]
[execTimedOut[={y|n}]]
[prompt=Tage.Stunden]
[offline[={y|n}]]
[runAtShutdown[={y|n}]]
[preventLogon[={y|n}]]
[globalTime]
[nocalendar]
[resolveQuery]
[parameters=Benutzerparameter]
[repeat={y|n}]
[stagingServer]
[jobTimeout=t.h]
[procedures=Prozedurdatei]
[{{area=area_name} | {domain=domain_name} | toAllAreas}]
[sendTime=JJJJ-MM-TT HH:MM]
[haltTime=JJJJ-MM-TT HH:MM]
[jcPriority={1,...,10}]
[distPriority={1,...,10}]
[reinstall[={y|n}]]
Startzeit der Prozedur im Zielsystem.
Folgende Werte sind gültig:
Die Prozedur wird sofort nach Erreichen von atTime gestartet.
Die Prozedur wird erst nach dem nächsten Neustart nach dem Ablauf von atTime ausgeführt.
Wenn "allowCancel" oder "allowCancel =y" angegeben ist, kann der Benutzer die Ausführung des Jobs abbrechen.
Bei Angabe von "allowCancel =n" ist dies dem Benutzer nicht möglich.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert der zugehörigen Prozedur verwendet.
Wenn durch diesen Aufruf "promptUser" weder festgelegt wird, noch bereits aktiviert ist, wird dieser Parameter ignoriert. Es wird keine Warnung angezeigt.
Gibt Folgendes an: Name einer CA ITCM-Domäne, an die die Verteilung gesendet wird.
Der Parameter kann mehrfach angegeben werden , um eine Liste mit CA ITCM-Domänen anzugeben.
Wenn dieser Parameter angegeben wird, wird die Verteilung versiegelt und automatisch an ihre Ziele gesendet, nachdem der Befehl erfolgreich abgeschlossen wurde.
Wenn weder der Parameter "area" noch der Parameter "domain" oder "toAllAreas" angegeben wird, bleibt die Verteilung unversiegelt und kann weiterhin geändert werden.
Dieser Parameter sollte nicht mit den Parametern "domain" oder "toAllAreas" angegeben werden.
(nur Enterprise-Manager)
Gibt Folgendes an: Gibt das Datum und die Uhrzeit an, an dem bzw. zu der die Aktion gestartet wird.
Das Datum wird im ISO-Format "JJJJ-MM-TT HH:MM" angegeben.
Wenn der Parameter nicht angegeben ist, werden das aktuelle Datum und die aktuelle Uhrzeit verwendet.
Gibt Folgendes an: Name des Kalenders, der die Zeit steuert, während der die Evaluierung ausgeführt werden kann.
Gibt die Computergruppe mit Gruppenname und Bereich an. Standardmäßig sind Name und Bereich durch einen Punkt (".") getrennt. Sie können jedoch mit der Option "sep" ein anderes Trennzeichen festlegen. Das Trennzeichen darf nicht als Teil der Namen verwendet werden.
Für den Gruppenbereich sind nur die folgenden Werte gültig.
Die Gruppe wird auf dem lokalen Domänen-Manager erstellt.
Die Gruppe wurde auf dem Enterprise-Manager erstellt und kann repliziert werden.
"ccompgrp" kann mit "compgrp" in einem Aufruf angegeben werden.
Gibt Folgendes an: optionaler eindeutiger Name eines Jobcontainers.
Wenn kein Parameter "cname" angegeben wird, wird intern ein Name generiert, der von der Befehlszeilenschnittstelle als ID zurückgegeben wird.
Die erzeugten Jobs werden ihm zugewiesen.
Wenn dieser Jobcontainer nicht existiert, wird er angelegt.
Wenn er existiert, werden die erzeugten Jobs hinzugefügt, sofern der Container nicht versiegelt ist.
Wenn er versiegelt ist, wird der Befehl "cadsmcmd" mit einem Fehler beendet.
Gibt die zu adressierende Computergruppe an.
Der Parameter kann mehrfach angegeben werden , um mehrere Computergruppen zu adressieren.
Dieser Parameter sollte nicht mit den Parametern "computer" oder "swTemplates" angegeben werden.
Gibt den Namen eines zu adressierenden Computers an.
Der Parameter kann mehrfach angegeben werden , um mehrere Computer zu adressieren.
Dieser Parameter sollte nicht mit den Parametern "compgrp" oder "swTemplates" angegeben werden.
(nur Domänen-Manager)
Gibt Folgendes an: Startzeit der Lieferung vom Domänen-Manager.
Das Datum wird im ISO-Format "JJJJ-MM-TT HH:MM" angegeben.
Wenn der Parameter nicht angegeben ist, werden das aktuelle Datum und die aktuelle Uhrzeit verwendet.
Gibt Folgendes an: Priorität, die der Verteilung zugewiesen wird.
Die angegebene Priorität muss numerisch sein, und der Wert muss größer oder gleich 1 und kleiner oder gleich 10 sein.
Wenn dieser Parameter nicht angegeben wird, wird von der Priorität 5 ausgegangen.
Gibt Folgendes an: Name der Verteilung, in der die Jobs und der Jobcontainer gespeichert werden.
Wenn die Verteilung bereits vorhanden und noch für Änderungen geöffnet ist, wird diese verwendet, andernfalls wird eine Fehlermeldung ausgegeben. Wenn die Verteilung nicht vorhanden ist, wird sie erstellt.
Wenn der Parameter nicht angegeben ist, wird eine Verteilung mit dem Standardnamen erzeugt.
(nur Enterprise-Manager)
Gibt Folgendes an: Name einer CA ITCM-Domänengruppe, an die die Verteilung gesendet wird.
Der Parameter kann mehrfach angegeben werden , um eine Liste von CA ITCM-Domänengruppen zu adressieren.
Wenn dieser Parameter angegeben wird, wird die Verteilung versiegelt und automatisch an ihre Ziele gesendet, nachdem der Befehl erfolgreich abgeschlossen wurde.
Wenn weder der Parameter "area" noch der Parameter "domain" oder "toAllAreas" angegeben wird, bleibt die Verteilung unversiegelt und kann weiterhin geändert werden.
Dieser Parameter sollte nicht mit den Parametern "area" oder "toAllAreas" angegeben werden.
(nur Enterprise-Manager)
Wenn "execTimedOut" oder "execTimedOut=y" angegeben ist, wird die Ausführung des Jobs automatisch gestartet, wenn das Zeitlimit der Benutzereingabe erreicht wird.
Wenn "execTimedOut=n" angegeben ist, wird der Job nicht automatisch gestartet.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert der zugehörigen Prozedur verwendet.
Wenn "promptUser" durch diesen Aufruf nicht festgelegt wird und auch noch nicht aktiviert wurde, wird dieser Parameter ignoriert. Es wird keine Warnung angezeigt.
Wenn "globalTime" oder "globalTime=y" angegeben ist, basieren die Zeitangaben auf der Zeit des Enterprise-Managers.
Wenn "globalTime=n" angegeben ist, basieren sie auf der Zeit des Domänen-Managers. (Standard)
Gibt Folgendes an: Datum und Uhrzeit, an dem bzw. zu der ein Verteilungsauftrag angehalten werden soll. Das Datum muss im ISO-Format "JJJJ-MM-TT HH:MM" angegeben werden.
Weitere Informationen zur Wiederaufnahme einer angehaltenen Verteilung finden Sie unter dem Befehl resume.
Gibt Folgendes an: Priorität des Jobcontainers.
Die angegebene Priorität muss numerisch sein, und der Wert muss größer oder gleich 1 und kleiner oder gleich 10 sein.
Wenn dieser Parameter nicht angegeben wird, wird die Priorität nicht geändert.
Gibt Folgendes an: "jobTimeout" gibt den Ablaufzeitraum eines Jobs im Format "t.h" ein, wobei "t" für die Anzahl der Tage und "h" für die Anzahl der Stunden steht. Der Parameterbereich kann über den Manager definiert werden. Wenn der angegebene Wert den konfigurierten Maximalwert überschreitet, wird dieser Wert auf den Maximalwert gesetzt. Wenn der angegebene Wert den Mindestwert unterschreitet, wird der Mindestwert verwendet. Es wird keine Warnung angezeigt.
"jobTimeout" sollte nicht mit dem Parameter "timeout" angegeben werden, da dies zu Fehlern führt. Wenn kein Parameter angegeben wird, gilt die Standardeinstellung "7.0".
Gibt Folgendes an: Name der Gruppe. Wenn es sich um eine Softwaregruppe handelt, werden die Mitglieder der Gruppe am Standort des Ziels installiert.
Die Prozedur der Mitglieder, die auf dem Ziel ausgeführt werden soll, kann mit der Option "procedures" angegeben und konfiguriert werden. Erfolgt keine Angabe, werden die Standardinstallationsprozeduren der Mitglieder verwendet.
Wenn es sich um eine Prozedurgruppe handelt, werden die enthaltenen Prozeduren am Standort des Ziels ausgeführt.
Wenn "noCalendar" angegeben ist, wird ein möglicherweise auf dem Zielcomputer vorhandener Kalender für die Jobausführung ignoriert.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert der zugehörigen Prozedur verwendet.
Die Jobverknüpfungsoption wird auf "Überlappung ignorieren" gesetzt.
Dieser Parameter ist nur zulässig, wenn "Transaktion" oder "synchronisiert" angegeben sind.
Führt den Job unabhängig von den anderen Jobs im Container aus.
Wenn "offline" oder "offline=y" angegeben ist, wird die Verbindung zwischen dem Zielcomputer und dem Server für die Jobausführung getrennt und anschließend wiederhergestellt.
Wenn "offline=n" angegeben ist, wird die Verbindung nicht getrennt.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert der zugehörigen Prozedur verwendet.
Gibt Folgendes an: Benutzerparameter für die Prozedur.
Mehrere Parameter müssen innerhalb von Anführungszeichen durch Leerzeichen getrennt werden.
Wenn eine leere Zeichenfolge eingegeben wird, werden keine Parameter mehr verwendet.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert der zugehörigen Prozedur verwendet.
Gibt die notwendigen Aktionen an, die nach Abschluss der angegebenen Prozedur ausgeführt werden müssen. Folgende Werte sind gültig:
Führt keine Folgeaktion aus.
Startet das System nach Abschluss der Prozedur neu.
Meldet den Benutzer nach Abschluss der Prozedur ab.
Startet das System nach Abschluss aller Jobs dieses Containers neu.
Meldet den Benutzer nach Abschluss aller Jobs dieses Containers ab.
Fährt den Zielcomputer nach Abschluss der Jobs herunter.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert der zugehörigen Prozedur verwendet.
Gibt an, dass notwendige Aktionen ausgeführt werden müssen, bevor die angegebene Prozedur startet. Folgende Werte sind gültig:
Führt keine vorangestellte Aktion aus.
Startet das System vor dem Start der Prozedur neu.
Meldet den Benutzer vor dem Start der Prozedur ab.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert der zugehörigen Prozedur verwendet.
Wenn "preventLogon" oder "preventLogon=y" angegeben ist, werden Anmeldeversuche von Benutzern während der Ausführung des Jobs zurückgewiesen. Wenn ein Benutzer bereits angemeldet ist, wird die Ausführung des Jobs verzögert, bis sich der Benutzer abgemeldet hat.
Wenn "preventLogon=n" angegeben ist, wird der Anmeldeversuch nicht zurückgewiesen.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert der zugehörigen Prozedur verwendet.
Gibt Folgendes an: Name der Datei, die die für die Softwaregruppe verwendeten Prozeduren und/oder die einzelnen Joboptionen für die Prozeduren (Software- und Prozedurgruppen) definiert.
Den Inhalt dieser Prozedurdatei finden Sie unter "Format der Prozedurdatei".
Gibt Folgendes an: Zeitspanne, in der der Benutzer zum Starten des Jobs aufgefordert wird.
Der Zeitraum wird im Format "t.h" angegeben. Dabei steht "t" für Tage und "h" für Stunden.
Der Bereich dieses Parameters reicht von drei Stunden bis zu sieben Tagen (von 0.3 bis 7.0). Wenn der angegebene Wert unter dem gültigen Mindestwert liegt, wird er durch den Mindestwert ersetzt. Wenn der angegebene Wert den gültigen Maximalwert übersteigt, wird er durch den Maximalwert ersetzt. Es wird keine Warnung angezeigt.
Wenn "promptUser" oder "promptUser=j" angegeben ist, wird der Benutzer zur Ausführung des Jobs aufgefordert.
Wenn "promptUser=n" eingegeben wird, wird der Benutzer nicht aufgefordert.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert der zugehörigen Prozedur verwendet.
Die Option "reinstall" ist optional, der Standardwert lautet "reinstall=n".
Wenn "reinstall" oder "reinstall=y" codiert ist, wird ein ggf. vorhandener zum Auftrag gehöriger Installationsdatensatz entfernt, bevor der Job durch den Domänen-Manager ausgewertet wird.
Wenn "reinstall=n" codiert ist, bleiben solche Datensätze bestehen.
Hinweis: Diese Option gilt nur für Installationsjobs. In allen anderen Fällen wird sie ignoriert.
Wertet vor Erstellung des Jobs eine möglicherweise vorhandene Abfragegruppe aus.
Setzt die Jobverknüpfungsoption auf "Transaktion aktivieren".
Wenn "runAtShutdown" oder "runAtShutdown=y" angegeben ist, wird die Ausführung des Jobs erst beim Herunterfahren gestartet.
Wenn "runAtShutdown=n" angegeben ist, wird die Ausführung des Jobs auch zu beliebigen anderen Zeitpunkten gestartet.
Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert der zugehörigen Prozedur verwendet.
Dieser Parameter wird nur für Unix-Ziele verwendet.
Gibt Folgendes an: Zeit, um die zugeordnete Verteilung an die angegebenen Domänen-Manager zu senden. Das Datum muss im ISO-Format "JJJJ-MM-TT HH:MM" angegeben werden. Wenn der Parameter nicht angegeben ist, werden das aktuelle Datum und die aktuelle Uhrzeit verwendet.
(nur Enterprise-Manager)
Gibt ein alternatives Trennzeichen für die Option "ccompgroup" an. Das Trennzeichen darf nicht Teil des Gruppennamencodes für die "ccompgroup"-Optionen sein.
Liefert das zugehörige Produkt auch an die Staging-Bibliotheken der Scalability-Server der Zielcomputer.
Dieser Parameter bezieht sich nur auf Prozeduren des Aufgabentyps "install".
Gibt Folgendes an: Namen der Softwarevorlage.
Der Parameter kann mehrfach codiert werden, um mehrere Software-Vorlagen anzusprechen.
Wenn der Parameter codiert ist, wird der Parameter "cname" ungültig, und die zu erstellenden Jobs werden keinem Jobcontainer zugewiesen, sondern der Software-Vorlage. Aus diesem Grund sollten die Softwarevorlagen der Liste nicht versiegelt sein.
Dieser Parameter sollte nicht mit den Parametern "computer" oder "compgrp" angegeben werden.
Die Jobverknüpfungsoption wird auf "Synchronisierte Jobausführung" gesetzt.
Wenn dieser Parameter angegeben ist, wird die zugehörige Verteilung an alle CA ITCM-Domänen gesendet, die beim Enterprise-Manager registriert sind.
"toAllAreas" sollte nicht mit den Parametern "area" oder "domain" angegeben werden.
Wenn weder der Parameter "area" noch der Parameter "domain" oder "toAllAreas" angegeben wird, bleibt die Verteilung unversiegelt und kann weiterhin geändert werden.
(nur Enterprise-Manager)
Die Jobverknüpfungsoption wird auf "Batch-Jobausführung" gesetzt.
Dies ist die Standardeinstellung.
Der adressierte Jobcontainer bleibt unversiegelt, nachdem der generierte Job erfolgreich erstellt wurde.
(nur Domänen-Manager)
Hinweise:
Wenn weder der Parameter "area" noch der Parameter "domain" oder "toAllAreas" angegeben wird, bleibt der Verteilungscontainer unversiegelt und kann weiterhin geändert werden.
Die Parameter "allowCancel", "execTimedOut" und "prompt" sind gültig, wenn die Option "promptUser" bereits festgelegt wurde oder mit Hilfe des Parameters "promptUser" von diesem Befehl festgelegt wird.
Wenn weder die Option "promptUser" eines Jobs noch der Parameter "promptUser" des Befehls festgelegt wird, werden diese Parameter ignoriert.
Es wird keine Warnung angezeigt.
|
Copyright © 2013 CA.
Alle Rechte vorbehalten.
|
|