Vorheriges Thema: addItem – Hinzufügen von Jobs zu einer unversiegelten lokalen Software-RichtlinieNächstes Thema: removeItem – Entfernen von Jobs aus einer unversiegelten lokalen Software-Richtlinie


create – Erstellen einer lokalen Software-Richtlinie

Dieser Befehl erstellt eine lokale Software-Richtlinie auf der Basis der angegebenen Optionen. Sie können optional die Software-Richtlinie mit einer lokalen oder globalen Computergruppe verknüpfen und sie während der Erstellung mit Jobs füllen. Wenn Sie die Richtlinie erfolgreich verknüpfen und füllen, können Sie sie auch versiegeln.

Dieser Befehl hat das folgende Format:

swPolicy action=erstellen
name=Name_der_Software-Richtlinie
[target=Computergruppenname 
[groupScope={local|global}]] 
[seal[={y|n}]]
[{group=Name_einer_Software-_oder_Prozedurgruppe|
procedures=Jobdatei}]
[jcPriority=1…10]
[{transaction|synchronized|nolinkage}]
[rollback[={y|n}]]
[cascade[={y|n}]]
[{setup_jobs|setup&activate_jobs}]
[regenerate[={y|n}]]
[evaluateGroup[={y|n}]]
[evaluationStart=JJJJ-MM-TT hh:mm]
[globalTime[={y|n}]]
[evaluationPeriod=Stunden]
[calendarname=Kalendername]
[{adhoc_only|adhoc_always}]
[comment=Kommentar_zur_Software-Richtlinie]
[userMessage]
Name

Mit dieser Option wird der Name der erstellten Software-Richtlinie angegeben. Dieser Name muss eindeutig sein.

target

Der mit dieser Option angegebene Name ist der Name einer Computergruppe, mit der die Software-Richtlinie verknüpft wird. Die Computergruppe muss bereits vorhanden sein. Es kann sich bei ihr entweder um eine globale Gruppe auf dem Enterprise-Manager oder um eine lokale oder globale Gruppe auf dem Domänen-Manager handeln.

Wenn diese Option nicht codiert ist, wird die zu erstellende Software-Richtlinie mit keiner Computergruppe verknüpft.

groupScope

Legt den Typ der Computergruppe fest, die mit der Software-Richtlinie verknüpft wird:

«nicht festgelegt»

Wenn eine lokale Computergruppe mit dem angegebenen Namen vorhanden ist, wird diese verwendet, anderenfalls wird nach einer globalen Gruppe gesucht.

lokal

Die Computergruppe muss eine lokale Gruppe sein.

global

Die Computergruppe muss eine globale Gruppe sein.

seal

Wenn "seal" oder "seal=y" codiert ist, wird die erstellte Richtlinie versiegelt. Anderenfalls bleibt sie für weitere Änderungen unversiegelt.

Die Versiegelungsoption ist nur zugelassen, wenn die Richtlinie bei der Erstellung verknüpft und ausgefüllt wird, und sie wird nur verarbeitet, wenn die Verknüpfung und das Ausfüllen erfolgreich waren.

Gruppe

Diese Option gibt den Namen einer Software- oder Prozedurgruppe an. Die Mitglieder der Gruppe werden verwendet, um die Software-Richtlinie während des Erstellungsprozesses mit Jobs auszufüllen.

Wenn diese Option nicht codiert ist, erfolgt keine Evaluierung von Gruppen zum Ausfüllen der erstellten Software-Richtlinie.

Die Option "group" darf nicht mit der Option "procedures" codiert werden.

Verfahren

Diese Option gibt den Namen einer Datei an, die die Informationen zum Erstellen der Jobs für die Software-Richtlinie enthält. Für jeden Job, der generiert und der Richtlinie zugewiesen werden soll, muss in der Datei ein Eintrag mit der folgenden Syntax erstellt werden:

item=Elementname version=Elementversion
procedure=Prozedurname
task={activate | configure | install | uninstall}
[installedWith=Name_der_Installationsprozedur]
[after={exacttime|boottime}]
[reinstall={y|n}]
[preaction={none|reboot|logoff}]
[postaction={none | reboot | logoff | rebootAtEnd | logoffAtEnd | shutdownAtEnd}]
[promptUser={y|n}]
[allowCancel={y|n}]
[execTimedOut={y|n}]
[offline={y|n}]
[runAtShutdown={y|n}]
[preventLogon={y|n}]
[triggeredByScalSrv={y|n}]
[globaltime={y|n}]
[calendarname=Name_des_Lieferungskalenders]
[noCalendar={y|n}]
[resolveQuery={y|n}]
[stagingServer={y|n}]
[parameters=Benutzerparameter]
[prompt=t.h]
[jobTimeout=t.h]
[repeat={y|n}]

Eine Zeile darf jeweils nur einen Eintrag enthalten, und ein Eintrag darf nicht mehr als eine Zeile umfassen. Der Eintrag muss mit den Parametern "item", "version", "procedure" und "task" in dieser Reihenfolge beginnen. Die Reihenfolge der übrigen Parameter ist beliebig. Parameterwerte, die Leerzeichen enthalten, müssen in Anführungszeichen (") eingeschlossen werden. Wenn ein Parameterwert ein Anführungszeichen enthält, muss dieses verdoppelt werden.

Die Bedeutung der Parameter finden Sie unter "cadsmcmd swPolicy action=addItem".

Die Option "procedures" darf nicht mit der Option "group" codiert werden.

jcPriority

Diese Option gibt die Jobcontainer-Priorität an, die von der Richtlinie zum Erstellen eines Jobcontainers für den Start ihrer SD-Aufträge verwendet wird. Gültige Werte für die Priorität sind 1, 2, 3, 4, 5, 6, 7, 8, 9, 10. 10 ist die niedrigste Priorität und 1 die höchste. Wenn die Option nicht codiert ist, wird die Priorität 5 festgelegt.

{transaction|synchronized|nolinkage}

Diese Option gibt die Jobverknüpfung innerhalb des Jobcontainers an, der von der Richtlinie zum Starten der SD-Aufträge erstellt wurde.

«nicht angegeben»

Keine Verknüpfung zwischen Aufträgen.

Transaktion

Batch-Jobausführung ohne Transaktion.

synchronisiert

Synchronisierte Jobausführung.

nolinkage

Keine Verknüpfung zwischen den Aufträgen.

Rollback

Wenn die Option "rollback" oder "rollback=y" codiert ist, wird die Jobverknüpfung auf "Transaktion aktivieren" gesetzt. Wenn die Option als "rollback=n" codiert ist, wird "Transaktion aktivieren" nicht festgelegt.

Der Standardwert ist "rollback=n".

Dieser Parameter sollte nur codiert werden, wenn der Parameter "transaction" mit diesem Befehl codiert wird.

cascade

Wenn die Option "cascade" oder "cascade=y" codiert ist, löst SD die Abhängigkeiten von überlappenden Installationsanforderungen auf und fügt die fehlenden Installationsaufträge automatisch hinzu. Wenn die Option als "cascade=n" codiert ist, wird die Abhängigkeit nicht aufgelöst.

Der Standardwert ist "cascade".

{setup_jobs|setup&activate_jobs}

Diese Option steuert die Ergebnisse der Auswertung der Richtlinie:

«nicht angegeben»

SD prüft während der Evaluierung der Richtlinie nur auf Konformität und meldet die nicht konformen Ziele, es werden jedoch keine Jobs zum Übertragen der nicht konformen Ziele in konforme Ziele generiert.

setup_jobs

Infolge der Evaluierung generiert SD Jobs zum Übertragen aller nicht konformen Ziele in konforme Ziele, diese Jobs werden jedoch nicht zur Ausführung gestartet. Dies wird dem Benutzer überlassen.

setup&activate_jobs

Infolge der Evaluierung generiert SD Jobs zum Übertragen aller nicht konformen Ziele in konforme Ziele und startet sie zur Ausführung.

regenerate

Wenn die Option "regenerate" oder "regenerate=y" codiert ist, werden alle Jobs, die zuvor fehlgeschlagen sind und noch nicht erfolgreich abgeschlossen wurden, erneut zur Ausführung geplant, um Konformität zu erzielen. Wenn die Option "regenerate=n" codiert ist, wird diese erneute Planung übersprungen.

Der Standardwert ist "regenerate".

evaluateGroup

Wenn die Option "evaluateGroup" oder "evaluateGroup=y" codiert ist, wird im Falle einer der Richtlinie zugeordneten Abfragegruppe diese Gruppe während der Evaluierung der Richtlinie ebenfalls erneut evaluiert. Wenn "evaluationGroup=n" codiert ist, findet diese erneute Evaluierung der Gruppe nicht statt.

Der Standardwert ist "evaluateGroup=n".

evaluationStart

Diese Option gibt den frühesten Zeitpunkt an, zu dem die Evaluierung der Richtlinie startet. Der Wert wird im ISO-Format "JJJJ-MM-TT hh:mm" angegeben, wobei "JJJJ" das Jahr, "MM" den Monat, "TT" den aktuellen Tag des Monats, "hh" die Stunde und "mm" die Minute angibt. Wenn diese Option nicht codiert ist, wird die aktuelle Uhrzeit verwendet.

globalTime

Diese Option gibt an, ob die Zeitangaben für die Richtlinie auf Enterprise- oder auf Domänenzeit basieren. Wenn diese Option codiert ist, basieren sie auf Enterprise-Zeit, anderenfalls auf Domänenzeit.

evaluationPeriod

Diese Option gibt den Zeitraum an, in dem die Evaluierung der Richtlinie stattfindet. Der Wert wird in Stunden angegeben. Wenn "0" angegeben ist, findet die Evaluierung nur einmal statt.

calendarname

Diese Option gibt den Namen des Kalenders an, der von SD zur Planung der zeitgesteuerten Aktionen der Richtlinie verwendet wird.

{adhoc_only | adhoc_always}

Diese Option gibt an, ob SD diese Richtlinie evaluiert, wenn ein Ziel sein Inventar meldet, und sie gibt den Verarbeitungsmodus an:

«nicht angegeben»

Die Richtlinienevaluierung wird nicht durch Inventarberichte von Zielen initiiert.

adhoc_only

Die Evaluierung wird durch Inventarberichte von neuen oder erneut installierten Zielen gestartet.

ad_hoc_always

Die Evaluierung wird durch alle Inventarberichte von Zielen gestartet.

comment

Die Option gibt einen Kommentar an, der mit der Richtlinie gespeichert wird.

userMessage

Gibt die benutzerdefinierte Administratormeldung für eine Software-Richtlinie an.

Hinweis: Sie sollten Folgendes beachten: