Wiki-Quellcode von ACMP

Zuletzt geändert von Jannis Klein am 2024/03/19 17:52
Zeige letzte Bearbeiter
1 {{aagon.priorisierung}}
2 1
3 {{/aagon.priorisierung}}
4
5 {{aagon.floatingbox/}}
6
7 = Transfer content from console to client =
8
9 Mit diesem Befehl können Sie den Wert einer Variablen an den ausführenden Client übertragen lassen. Wählen Sie über die DropDown-Liste eine Variable. Informationen zum Erstellen von Variablen finden Sie im Abschnitt [[Variablen>>doc:ACMP.65.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Menüleiste.WebHome||anchor="HVariablenbearbeiten"]]. Die angegebene Variable kann anschließend vom Clientskript genutzt werden.
10
11 {{aagon.infobox}}
12 Dieser Befehl steht nur dem Console Skript zur Verfügung.
13 {{/aagon.infobox}}
14
15 = Store value on server =
16
17 Dieses Command besitzt in den speziellen Einstellungen für das Client- und das Consolenskript eine gewisse Abweichung. Im Prinzip dient dieses Command dazu, Clientwerte in der Datenbank zu ersetzen. In der Clientskript-Variante können neue Client-Werte eingetragen werden während in der Consolenskript-Variante die Werte eines ganz bestimmten Clients geändert bzw. hinzugefügt werden können.
18
19 (% style="text-align:center" %)
20 [[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_5fb843b3.png||alt="Store Value on Server (Console)" height="572" width="392"]]
21 Store Value on Server (Console)
22
23
24 In der Consolenskript-Variante haben Sie die Möglichkeit unter Zielclient wählen, die ID des Clients, dessen Werte geändert werden sollen, einzugeben. Über den Button rechts neben dem Eingabefeld werden alle Clients aufgelistet.
25
26 Unter Optionen können Sie auswählen ob ein einzelner Wert oder mehrere Werte in der Datenbank geändert/hinzugefügt werden sollen. Mit einem Haken in der Checkbox Alte Werte löschen werden bisherige Werte der entsprechenden Kategorie gelöscht.
27
28 Wählen Sie unter Feld das Feld aus, welches geändert/hinzugefügt werden soll. Bei einem einzelnen zu verändernden Wert kann der neue Wert einfach in das Eingabefeld eingegeben werden. Bei einer Mehrfachauswahl kann ein Feld gewählt werden, welches mit einem Klick auf den Plus-Button in die Liste eingefügt wird. Hier kann neben dem Feld dann der neue Wert eingetragen werden, welcher später den alten Wert ersetzt oder ergänzt (Alte Werte löschen).
29
30 = Set software installed =
31
32 Mit diesem Befehl können Sie einen Wert des Clients in der Datenbank setzen, welcher angibt, ob eine bestimmte Software installiert ist. Dazu geben Sie in dem ersten Eingabefeld die Bezeichnung der Software an. Achten Sie dabei darauf, dass die Bezeichnung korrekt ist.
33
34 In dem zweiten Feld können Sie per Drop-Down-Liste auswählen, ob die angegebene Software als installiert (Wahr) oder als nicht installiert (Falsch) gilt.
35
36 = Iterate selected clients (nur Console) =
37
38 Mit diesem Command können Clients, welche durch ein zuvor ausgeführtes Command ermittelt wurden, nacheinander durchlaufen werden. Das Command funktioniert dabei wie eine Schleife, welche solange durchlaufen wird, bis alle Clients einmal gescant wurden.
39
40 Bei jedem Client werden die Client-ID, der Computer Name, die IP-Address, sowie der zuletzt angemeldete User ausgelesen und in einer Variablen gespeichert, welche in den speziellen Einstellungen dieses Commands angegeben werden muss.
41
42 In den Commands, welche diesem Command logischer Weise untergeordnet werden um die Daten zu bearbeiten, kann über den eingegebenen Variablennamen auf diese Daten zugegriffen werden. Mehr zu der Verwendung von Variablen finden Sie im Kapitel [[Variablen>>doc:ACMP.65.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Menüleiste.WebHome||anchor="HVariablenbearbeiten"]]. Auf die Daten können Sie wie folgt zugreifen:
43
44 |(% style="width:279px" %)(((
45 %VarName.ID%
46
47 %VarName.Name%
48
49 %VarName.IpAddress%
50
51 %VarName.LastUser%
52 )))|(% style="width:923px" %)(((
53 Die ClientID
54
55 Der Computer Name
56
57 Die IP-Address
58
59 Der zuletzt angemeldete User
60 )))
61
62 {{aagon.infobox}}
63 Dieses Command steht nur dem Consolenskript zur Verfügung.
64 {{/aagon.infobox}}
65
66 = Reset Script Flags =
67
68 Dieses Command entfernt Skript-Informationen aus der Registry über bereits ausgeführte Command-Bausteine. Dabei entfernt das Command die Flags eines Bausteins, die verhindern sollen, dass es nochmal Maschinenbezogen oder Benutzerbezogen ausgeführt werden darf. Damit werden alle Bausteine eines Client Commands, je nach Kontexteinstellung, wieder ausführbar gemacht.
69
70 Haben Sie z.B. einen Command hinzugefügt, dessen Ausführungsoptionen unter //Kontext// als //Maschinenbezogen// (= Command wird 1x pro Maschine ausgeführt) oder //Benutzerbezogen// (= Command wird 1x von diesem Benutzer ausgeführt) definiert wurde, dann wird der Command nur einmal in einem dieser Kontexte ausgeführt.
71
72 {{figure}}
73 (% style="text-align:center" %)
74 [[image:65_Client Command_ACMP_Reset Scrips Flags Allgemein_484.png||alt="Dialog.PNG"]]
75
76 {{figureCaption}}
77 Kontextbezogene Ausführungen eines Commands
78 {{/figureCaption}}
79 {{/figure}}
80
81 Bei einer erneuten Ausführung dieses Bausteins in exakt diesem Client Command wird dieser dann übersprungen. Diese Aktion wird im Joblog als „Übersprungen“ registriert.
82
83 Um diesen übersprungenen Baustein wieder ausführen zu können, können Sie den Reset Script Flag-Command setzen, der diese Information löscht und eine wiederholte Ausführung erst wieder ermöglicht.
84
85 {{aagon.infobox}}
86 Beachten Sie, dass diese Informationen nach und nicht während einer Ausführung gelöscht werden!
87 {{/aagon.infobox}}
88
89 Dabei gibt es unterschiedliche Optionen innerhalb des Reset Script Flag-Commands, die Sie auswählen können. Diese können im Tab //Details// spezifiziert werden und haben unterschiedliche Auswirkungen:
90
91 {{figure}}
92 (% style="text-align:center" %)
93 [[image:65_Client Command_ACMP_Reset Script Flags_484.png||alt="reset script flag.PNG"]]
94
95 {{figureCaption}}
96 Einstellungen im Reset Script Flags-Command
97 {{/figureCaption}}
98 {{/figure}}
99
100 **Beziehung**
101
102 Sie können bestimmen, ob bei der Ausführung dieses Reset Script Flag-Commands die Skript-Informationen maschinenbezogen oder benutzerbezogen gelöscht werden sollen.
103
104 Letzteres betrifft auf einem Mehrbenutzersystem immer nur den angemeldeten Benutzer, bei dem der Command-Baustein gerade ausgeführt wird.
105
106 **Client Command Auswahl**
107
108 Sie können hier auswählen, auf welches oder welche Client Commands sich die Löschung der Informationen beziehen soll:
109
110 |Aktuelles Client Command|Es wird nach der Ausführung des gesamten Client Commands die Information aus der Registry entfernt, nicht nach Ausführung des einzelnen Bausteins.
111 |Ausgewähltes Client Command|(((
112 Wenn die gewählte ScriptID die des gerade ausführenden Client Commands ist, verhält sich es genau wie bei Auswahl der Option //Aktuelles Client Command//.
113
114 Wenn die gewählte ScriptID die eines anderen Client Commands ist, wird die Information direkt aus der Registry gelöscht.
115 )))
116 |Alle Client Commands|Es werden alle Informationen von Client Commands direkt gelöscht. Nach Ausführung des aktuellen Client Command werden auch diese Informationen über diese Ausführung nochmals entfernt.
117
118 = Run Client Command =
119
120 Dieses Command dient dazu, ein zusätzliches Client Command auf einem Client auszuführen. Dazu wählen Sie unter dem Tab Client Command starten ein Client Command über den entsprechenden Button aus. Die Client Command-ID wird automatisch in den Dialog übernommen. Eine weitere Zeile bietet den Platz für die Angabe von Parametern im folgenden Format, wobei mehrere Parameter jeweils durch ein Leerzeichen getrennt werden:
121
122 /v:Parametername=Parameterwert /v:Parametername=Parameterwert […]
123
124 Die Option Ohne Dosbox ausführen ausführen erlaubt es festzulegen, ob bei der Ausführung von Client Commands die Befehlzeile angezeigt werden soll oder nicht. Nähere Informationen dazu erhalten Sie im Abschnitt [[WRunCC.exe>>doc:ACMP.65.ACMP-Solutions.Client Commands.Jobs ausführen.WRunCC\.exe.WebHome]].
125
126 = Attach file to log =
127
128 Dieser Befehl dient dazu, eine Logdatei z.B. eines Installationsprogramms oder ähnlichem in der Datenbank abzulegen und dem Client zuzuordnen. Wählen Sie dazu eine Datei über den Button rechts neben dem Eingabefeld und definieren Sie eventuell eine Beschreibung.
129
130 Die Logdateien, welche einem Client zugeordnet werden, finden Sie über eine Abfrage in der Abfrageverwaltung. In der ausgeführten Abfrage wählen Sie den gewünschten Client aus und öffnen die Detailansicht. Unter dem Punkt Client Commands finden Sie die Logdateien.
131
132 {{aagon.infobox}}
133 Dieses Command steht nur dem Clientskript zur Verfügung.
134 {{/aagon.infobox}}
135
136 = Get Values from Server =
137
138 Über dieses Command können spezifische Werte eines Client vom ACMP Server geladen werden. Dazu geben Sie zunächst die ID des Clients unter ClientID ein. Entweder wählen Sie hier eine statische ID, wozu Sie alle zur Verfügung stehenden ClientIDs über den nebenstehenden Button abrufen können. Andernfalls können Sie eine Variable einsetzen, welche im Client Command zuvor spezifiziert wurde, z.B. %AktuellerClient%.
139
140
141 Wählen Sie über die DropDown-Liste unter Felder auswählen, ob ein einzelner Wert wie z.B. der Namen des Rechners oder ein Mehrfachwert wie z.B. die IP-Adressen des Rechners geladen wird. Unter Verfügbare Felder finden Sie nun alle Felder, welche geladen werden können. Per Doppelklick auf ein Feld können Sie dieses auswählen, wobei der Feldname anschließend im Bereich Ausgewählte Felder angezeigt wird. Haben Sie ein Feld fälschlicherweise ausgewählt, können Sie die Auswahl in diesem Bereich per Doppelklick auf den Namen rückgängig machen.
142
143 (% style="text-align:center" %)
144 [[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_9b4e94fd.png||alt="Get Values from Server" height="586" width="449"]]
145 Get Values from Server
146
147 Zuletzt geben Sie eine Variable an, in welcher die geladenen Werte gespeichert werden. Der weitere Zugriff auf die Informationen erfolgt dabei nach dem Muster %Variablenname.Feldname%, z.B. %DEPT.ABTEILUNG%. Dabei entspricht der Feldname dem angezeigten Namen im Bereich Ausgewählte Felder.
148
149 (% style="text-align:center" %)
150 [[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_f66fb1c4.png||alt="Ausgabe des Dialogs" height="227" width="852"]]
151 Ausgabe des Dialogs
152
153
154 Haben Sie Einzelwertfelder wie z.B. Computer Name oder Abteilung ausgewählt, werden diese Werte in der angegebenen Variable gespeichert und können im weiteren Verlauf des Client Command verwendet werden. Haben Sie jedoch Mehrfachwertfelder wie z.B. Service Name oder IP Address ausgewählt, muss dieses Command als Loop-Command (Schleife) genutzt werden, um alle Client-Werte zu verarbeiten. Dabei wird pro Schleifendurchlauf immer der nächste Wert in der Variable gespeichert. In der beispielhaften Grafik werden die IP-Adressen eines Clients ausgelesen und per Dialog angezeigt. Während des ersten Schleifendurchlaufs wird somit über die Variable %DEPT.IPADDRESS% die erste IP-Adresse des Clients ausgegeben.
155
156 = Run Agent Task =
157
158 Mithilfe dieses Commands ist es möglich ein Client Command auf dem Agent ausführen zu lassen. Wählen Sie hierzu unter Details die gewünschte Agent Task aus.
159
160 {{aagon.infobox}}
161 Dieses Command ist ab ACMP 4.0 verfügbar und steht nur im Client Skript zur Verfügung.
162 {{/aagon.infobox}}
163
164 = Enqueue ACMP Job =
165
166 Mit diesem Command können Sie einen ACMP Job zur Ausführung nach der Fertigstellung des Client Commands einreihen. Dieser kann dafür verwendet werden, um aus einem Client Command eine [[Managed Software Installation>>doc:ACMP.65.ACMP-Solutions.Patch Management.Managed Software.WebHome]], eine [[Job Collection>>doc:ACMP.65.ACMP-Solutions.Jobs.Job Collections.WebHome]] oder eine [[CAWUM Update Collection>>doc:ACMP.65.ACMP-Solutions.Patch Management.Windows Update Management.WebHome]] zu starten. Sie können die Ausführungsreihenfolge selbst bestimmen und angeben, welcher der Jobs zuerst in die Warteschlange des Agenten eingereiht werden soll. Die Jobs, die Sie über den Befehl einreihen, werden im [[Jobmonitor>>doc:ACMP.65.First Steps im ACMP.Aufbau der Console.Ribbonleiste.Monitore.WebHome]] angezeigt.
167
168 {{figure}}
169 (% style="text-align:center" %)
170 [[image:Enqueue ACMP Job.png]]
171
172 {{figureCaption}}
173 ACMP Jobs einreihen
174 {{/figureCaption}}
175 {{/figure}}
176
177 {{aagon.infobox}}
178 Beachten Sie, dass bei der Ausführung des Befehls der verwendete ACMP Job nicht direkt ausgeführt wird. Dieser muss zunächst mit Abschluss des Client Commands beendet werden, damit die Ausführung gestartet wird. Es ist demnach nicht möglich, dass Sie im Befehl auf die Job Ausführung warten oder das Ergebnis der Job Ausführung verwenden können.
179 {{/aagon.infobox}}

Navigation

© Aagon GmbH 2024
Besuchen Sie unsere neue Aagon-Community