Vorheriges Thema: BeispielNächstes Thema: Beispiel


modify – Ändern von Attributen einer Vorlagengruppe bzw. Software-Vorlage

Dieser Befehl ändert die Attribute einer vorhandenen Softwaregruppe und -Vorlage.

Dieser Befehl hat das folgende Format:

templategroup action=modify name=Name_der_Vorlagengruppe
[newName=Name_der_Vorlagengruppe] 
[swTemplate=Name_der_Software-Vorlage]
[newSwTemplate=Neuer_Name_der_Softwarevorlage]
[comment=Kommentar]
[{query="Abfrage" | queryfile=Dateiname | noquery}]
[engineName=Engine-Name
[enginePeriod=Engine-Evaluierungshäufigkeit]]
[{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 ="JJJJ-MM-TT hh:mm"]
[evaluationperiod=Stunden]
[calendarname=Kalendername]
[globalTime[={y|n}]]
[jcPriority={1,...,10}]
[userMessage]
{adhoc_disable | adhoc_only | adhoc_always}

Dieser Code besitzt die folgende Funktion:

adhoc_disable

Adhoc-Evaluierung ist deaktiviert.

adhoc_only

Adhoc-Evaluierung wird nur aktiviert, wenn neue oder erneut installierte Ziele ihr Inventar melden.

adhoc_always

Adhoc-Evaluierung wird immer aktiviert, wenn Ziele ihr Inventar melden.

calendarname

Gibt Folgendes an: Name des Kalenders, der die Zeit steuert, während der die Evaluierung ausgeführt werden kann.

Hinweis: Sie müssen auch einen Wert für "evaluationperiod" eingeben, wenn Sie einen Eintrag für "calendarname" aktivieren möchten.

cascade

Wenn "cascade" oder "cascade=y" angeben ist, wird die Jobverknüpfung des Containers in "Auflösen von Abhängigkeiten in Überlappungsinstallationen" geändert.
Wenn "cascade=n" angegeben ist, wird die Jobverknüpfung in "Keine Auflösung" geändert.

Dieser Parameter sollte nur angegeben werden, wenn sich die Jobverknüpfung des Containers im Batch-Verarbeitungs- oder Synchronisierungsmodus befindet oder mit dieser Aktion (durch die Eingabe von "Transaktion" oder "synchronisiert") in einen dieser Modi versetzt wird.

comment

Ein Kommentar wird durch den angegebenen Wert ersetzt.

Hinweis: Geben Sie eine leere Zeichenfolge ein (""), um einen vorhandenen Kommentar zu löschen.

engineName

Gibt den Namen einer Engine an, die die Gruppenevaluierung verarbeitet.

Bei Angabe einer leeren Zeichenfolge kann die Abfrage von einer beliebigen Engine verarbeitet werden.

Wenn der Gruppe derzeit keine Abfrage zugewiesen ist, wird eine Warnung angezeigt, und der Parameter wird ignoriert.

enginePeriod

Gibt den Zeitraum in Minuten an, in dem die Engine die Gruppe neu evaluiert. Wenn dieser Parameter nicht angegeben wird, wird von einem Zeitraum von 1 Minute ausgegangen.Wenn der Gruppe zurzeit keine Abfrage zugewiesen und keine bestimmte Engine für die Verarbeitung der Evaluierung angegeben ist, wird eine Warnung ausgegeben und der Parameter wird ignoriert.

evaluationstart

Zeitpunkt, zu dem die Evaluierung beginnen soll. Der Zeitpunkt muss im ISO-Format "JJJJ-MM-TT HH:MM" angegeben werden. Wenn "EvaluationStart" nicht angegeben wird, wird der tatsächliche Zeitpunkt verwendet.

Dieser Parameter sollte nur für Abfrage- oder Vorlagengruppen verwendet werden.

evaluationperiod

Der Zeitraum, in dem die Abfrage evaluiert wird. Der Zeitraum wird in Stunden angegeben.

Dieser Parameter kann nur für Abfrage- oder Vorlagengruppen verwendet werden.

Wenn 0 (null) angegeben wird, wird die periodische Evaluierung deaktiviert.

globalTime

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.

jcPriority

Gibt Folgendes an: neue Priorität, die dem Jobcontainer 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 die Priorität nicht geändert.

Name

Gibt Folgendes an: Name der Vorlagengruppe, der geändert werden soll.

newName

Neuer Name der Vorlagengruppe.

newSwTemplate

Gibt den neuen Namen der entsprechenden Softwarevorlage an.

nolinkage

Führt den Job unabhängig von den anderen Jobs im Container aus.

noquery

Eine eventuell angegebene Abfrage wird gelöscht.

nosetup

Wenn dieser Parameter angegeben wurde, werden nur Konformitätsprüfungen aber keine Jobsetups ausgeführt.

query

Gibt an, dass die Vorlage ebenfalls eine Abfragegruppe ist. Die angegebene Abfrage muss eine USD 4.0 SP1-Legacy-Abfrage sein.

queryfile

Gibt an: Die Datei, in der die Abfrage gespeichert ist. Die Größe der gespeicherten Abfrage ist nur durch die Kapazität des Servers beschränkt. Bei der Abfrage muss es sich um eine mit SD 4.0 SP1 kompatible zulässige Abfrage handeln.

regenerate

Bei "regenerate" oder "regenerate=y" wird eine Regenerierung der zuvor für diese Vorlage fehlgeschlagenen Jobs durchgeführt.

Wird "regenerate=n" angegeben, erfolgt keine Regenerierung.

Bei fehlender Angabe des Parameters wird "regenerate=y" angenommen.

Rollback

Setzt die Jobverknüpfungsoption auf "Transaktion aktivieren".

Dieser Parameter sollte nur angegeben werden, wenn sich der Container bereits im Modus Batch-Verarbeitung befindet oder durch diesen Befehl in diesen Modus versetzt wird (Parameter "transaction").

setup_jobs

Jobs werden in Übereinstimmung mit der Konformitätsprüfung eingerichtet, jedoch nicht aktiviert.

setup&activate_jobs

Jobs werden in Übereinstimmung mit der Konformitätsprüfung eingerichtet und aktiviert.

Hinweise: Wenn der Parameter "setup&activate_jobs" über die Eingabeaufforderung oder die Shell-Ebene verwendet wird, muss der Parameter in Anführungszeichen eingeschlossen werden, da das Zeichen "&" für die Eingabeaufforderung und die Shell eine besondere Bedeutung besitzt. Bei der Verwendung von Batch-Skripten werden die Anführungszeichen für diesen Parameter nicht benötigt.

swTemplate

Gibt Folgendes an: Namen der Softwarevorlage, deren Attribute geändert werden.

Bei fehlender Angabe wird der Standardname ("<Gruppenname> [$date $time]") verwendet.

synchronisiert

Die Jobverknüpfungsoption wird auf "Synchronisierte Jobausführung" gesetzt.

Transaktion

Die Jobverknüpfungsoption wird auf "Batch-Jobausführung" gesetzt.

userMessage

Ändert die benutzerdefinierte Administratormeldung, während eine Vorlagengruppe aktualisiert wird.

Hinweis: Wenn ein Parameter nicht angegeben wird, bleibt das entsprechende Attribut unverändert.