Wiki source code of Client Command Eigenschaften

Last modified by Jannis Klein on 2025/01/08 10:02
Show last authors
1 {{aagon.priorisierung}}
2 20
3 {{/aagon.priorisierung}}
4
5 {{aagon.floatingbox/}}
6
7 In den Eigenschaften eines Client Command können Sie allgemeine Informationen hinterlegen, wie auch bestimmte Optionen und Bedingungen für das Client Command setzen.
8
9 = Client Command spezifische Eigenschaften =
10
11 {{aagon.infobox}}
12 Folgende Einstellungen gelten für das gesamte Client Command. Führen Sie Änderungen an diesen durch, dann wirken sie sich auf alle Client Command Versionen aus.
13 {{/aagon.infobox}}
14
15 == Allgemein ==
16
17 Hier können Sie die grundlegenden Einstellungen des Client Command kontrollieren.
18
19 {{figure}}
20 (% style="text-align:center" %)
21 [[image:66.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Menüleiste.WebHome@Client Command_Einstellung_Allgemein.png]]
22
23 {{figureCaption}}
24 Allgemeine Einstellungen des Client Commands
25 {{/figureCaption}}
26 {{/figure}}
27
28 Sie haben die Möglichkeit, den Namen des Client Commands anzupassen und die ID einzusehen, die zur eindeutigen Identifizierung des Client Commands verwendet wird.
29
30 {{aagon.infobox}}
31 Jeder Client Command besitzt eine eigene ID.
32 {{/aagon.infobox}}
33
34 Außerdem finden Sie Informationen zum Erstellungsdatum, zur Uhrzeit und zum ACMP Benutzer, die das Client Command erstellt hat, sowie zur letzten durchgeführten Änderung und dem Gerät, auf dem dies geschehen ist.
35
36 == Optionen ==
37
38 In diesem Abschnitt können Sie unterschiedliche Client Command-Einstellungen vornehmen.
39
40 {{figure}}
41 (% style="text-align:center" %)
42 [[image:66.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Menüleiste.WebHome@Client Command_Eigenschaften_Optionen.png]]
43
44 {{figureCaption}}
45 Verschiedene Optionseinstellungen für das Client Command
46 {{/figureCaption}}
47 {{/figure}}
48
49 === Client Command Optionen ===
50
51 Setzen Sie ein Häkchen in die jeweilige Checkbox, um diese Option zu aktivieren.
52
53 |Interaktive Nutzung erlauben|(((
54 Ermöglicht dem User eines Clients, dieses Client Command selbstständig über den [[Command Launcher>>doc:ACMP.66.ACMP-Solutions.Client Commands.Command Launcher.WebHome]] oder eine [[(W)RunCC>>doc:ACMP.66.ACMP-Solutions.Client Commands.Jobs ausführen.WRunCC\.exe.WebHome]]-Verknüpfung auszuführen.
55
56 {{aagon.infobox}}
57 Der Command Launcher wurde durch den ACMP Kiosk ersetzt, für diesen muss die Option nicht mehr gesetzt werden.
58 {{/aagon.infobox}}
59 )))
60 |Als Quick Command anzeigen|(((
61 Ermöglicht ein Anzeigen bzw. Ausführen als Quick Command über einen Rechtsklick auf einen Client bei einer Abfrage in der Abfrageverwaltung.
62 )))
63 |Im Ribbon-Tab „Abfrageaktionen“ anzeigen|Ermöglicht ein Freischalten des Client Commands, damit es im Ribbon-Tab „Abfrageaktionen“ (in jedem Menüpunkt des ACMP) oder über das Puzzleteil in einer Abfrage erscheint.
64 |Erlaube parallele Ausführung|(((
65 Verhindert, dass langlaufende Client Commands die Ausführung von kurzen Client Commands blockieren.
66
67 {{aagon.infobox}}
68 Beachten Sie, dass eine parallele Ausführung bei z.B. gemeinsam genutzten Ressourcen der zwei Client Commands zu einem Fehlschlagen der Ausführung führt.
69 {{/aagon.infobox}}
70 )))
71
72 === Client Command Log-Optionen ===
73
74 Mit dem Setzen eines Häkchens in die Checkbox //Client-Ausführungs-Log speichern// bestätigen Sie, dass generell die Logs des Client Commands gespeichert werden sollen.
75
76 Über die DropDown-Liste //Erweitertes Log speichern// können Sie angeben, ob die Daten //Niemals, Nur bei Fehlern// oder //Immer// geloggt werden sollen.
77
78 Zusätzlich gibt es noch die DropDown-Liste //ACMP Console Log anzeigen//, über welche ausgewählt werden kann, wann ein Log der Console angezeigt wird (//Niemals, Nur bei Fehlern, Immer//).
79
80 == Sicherheit ==
81
82 Unter Sicherheit haben Sie die Möglichkeit, das Client Command durch ein Passwort zu schützen, sodass es von keiner weiteren Person editiert werden kann.
83
84 {{figure}}
85 (% style="text-align:center" %)
86 [[image:66.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Menüleiste.WebHome@Client Command_Eigenschaften_Sicherheit.png]]
87
88 {{figureCaption}}
89 Sicherheitseinstellungen für das Client Command
90 {{/figureCaption}}
91 {{/figure}}
92
93 Um das Client Command mit einem Passwort zu schützen, muss die Checkbox //Geschützt// angehakt werden. Klicken Sie dann auf //Ändern.// In dem Fenster geben Sie nun entweder das alte Passwort nochmals ein, wenn Sie das Passwort tauschen möchten, oder lediglich ein neues Passwort ein, wenn Sie erstmals ein Passwort vergeben wollen.
94
95 Wiederholen Sie in beiden Fällen das neue Passwort und klicken Sie auf //OK//.
96
97 {{figure}}
98 (% style="text-align:center" %)
99 [[image:66.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Menüleiste.WebHome@Client Command_Eigenschaften_Sicherheit_2.png]]
100
101 {{figureCaption}}
102 Änderung des Passworts
103 {{/figureCaption}}
104 {{/figure}}
105
106 In diesem Fall erscheint in der Liste aller Client Commands unter// Eigenschaften// das Symbol [[image:image-20240215115512-1.png]]als Zeichen für ein Passwortgeschütztes Client Command.
107
108 Wenn Sie kein Passwort mehr für das Client Command haben möchten, müssen Sie das Häkchen aus der Checkbox //Geschützt// entfernen und das alte Passwort nochmals eingeben. Erst dann ist das Client Command nicht mehr geschützt.
109
110 Außerdem können Sie bestimmten Usern und Gruppen Rechte an diesem Client Command erteilen oder entziehen.
111
112 Um einer Gruppe oder einem Benutzer ein Recht zu vergeben, müssen Sie diese zunächst zur Auswahl hinzufügen. Zur Auswahl stehen die Rechte //Bearbeiten, Ausführen// und// Sichtbar//. Über Hinzufügen und Entfernen ermöglichen und entziehen Sie Gruppen und Benutzern das Zugriffsrecht auf das Client Command.
113
114 {{aagon.infobox}}
115 Das Anlegen von Gruppen und Benutzern erfolgt vorab unter System > Benutzerverwaltung. Dort können neue Gruppen und Benutzer hinzugefügt werden, die anschließend dann in der Zugriffsauswahl des Client Commands ausgewählt werden können.
116 {{/aagon.infobox}}
117
118 == Icon ==
119
120 Wenn Sie ein spezielles Icon statt des Standard-Icons für das Client Command auswählen möchten, können Sie hier ein neues hinzufügen, ein bestehendes Icon editieren oder löschen. Dies ist dann sinnvoll, wenn dieses Client Command von besonderer Bedeutung ist.
121
122 {{aagon.infobox}}
123 Das neue Icon wird lediglich für die Einträge zum Client Command in der Ribbonbar verwendet. In der ACMP Console hat es weiterhin das gelbe Puzzleteil, dasselbe gilt für den Command Launcher.
124 {{/aagon.infobox}}
125
126 {{figure}}
127 (% style="text-align:center" %)
128 [[image:66.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Menüleiste.WebHome@Client Command_Eigenschaften_Icon.png]]
129
130 {{figureCaption}}
131 Auswahl des Icons
132 {{/figureCaption}}
133 {{/figure}}
134
135 Wird kein Icon ausgewählt, dann erhält das Client Command automatisch das Standard-Icon.
136
137 {{aagon.infobox}}
138 Wollen Sie ein eigenes Icon hinzufügen, dann muss das Icon das Maß 16x16 Pixel besitzen sowie eine .bmp- oder .ico-Datei sein.
139 {{/aagon.infobox}}
140
141 == Info ==
142
143 Hier können Sie Informationen zum Client Command angeben, wenn dieses z.B. von einem fremden Hersteller kommt und in ACMP importiert wurde.
144
145 {{figure}}
146 (% style="text-align:center" %)
147 [[image:66.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Menüleiste.WebHome@Client Command_Eigenschaften_Info.png]]
148
149 {{figureCaption}}
150 Infos zum Client Command
151 {{/figureCaption}}
152 {{/figure}}
153
154 Neben dem Namen des Erstellers und der Version können Sie auch etwas zum Markenzeichen hinzufügen.
155
156 == File Repositories ==
157
158 Über diese Einstellung können Sie entscheiden, ob das Client Command mit allen File Repositories oder nur mit ausgewählten synchronisiert werden soll.
159
160 {{figure}}
161 (% style="text-align:center" %)
162 [[image:66.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Menüleiste.WebHome@Client Commmand_Eigenschaften_File Repo.png]]
163
164 {{figureCaption}}
165 Zu synchronisierende File Repositories für das Client Command
166 {{/figureCaption}}
167 {{/figure}}
168
169 {{aagon.infobox}}
170 Weitere, neue File Repositories können Sie unter //System //> //Verteilte File Repositories// hinzufügen.
171 {{/aagon.infobox}}
172
173 == Kommentare ==
174
175 Unter Kommentare wird der Kommentar angezeigt, der hinzugefügt worden ist, nachdem eine neue Client Command Version angelegt wurde. I.d.R. werden Sie dort aufgefordert, einen Kommentar hinzuzufügen. Dieser kann hier eingesehen werden.
176
177 Wenn eine neue Client Command Version angelegt wird, werden Sie automatisch dazu aufgefordert, einen Kommentar zu verfassen. Auf dieser Seite können diese Kommentare eingesehen werden.
178
179 == Parameter ==
180
181 Mithilfe von Parametern auf Basis von CC Projektvariablen können Sie einem Client Command Werte übergeben. So können aus der ACMP Console heraus Client Command Jobs über die Parameter gesteuert werden, ohne vorher das Console Skript des CCs ausführen zu müssen.
182
183 Die Parameter selber können im ACMP überall dort genutzt werden, wo auch Jobs benötigt und eingesetzt werden:
184
185 * Über die manuelle Ausführung von [[Jobs ausführen>>doc:ACMP.66.ACMP-Solutions.Jobs.WebHome]]
186 * Über die Einbindung in den [[Job Collections>>doc:ACMP.66.ACMP-Solutions.Jobs.Job Collections.WebHome]]
187 * Über die Nutzung in [[Containern>>doc:ACMP.66.ACMP-Solutions.Client-Management.Container.WebHome]]
188 * Über vorab getroffene Einstellungen im [[ACMP Kiosk>>doc:ACMP.66.ACMP-Solutions.Client-Management.ACMP Kiosk.WebHome]]
189 * Über die Commands [[Enqueue ACMP Jobs>>doc:ACMP.66.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Commandlist.ACMP.WebHome||anchor="HEnqueueACMPJob"]] und [[Run Client Command>>doc:ACMP.66.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Commandlist.ACMP.WebHome||anchor="HRunClientCommand"]]
190
191 === **Benutzerdefinierte Parameter definieren** ===
192
193 Sie haben die Möglichkeit, Parameter für ein Client Command auf Basis einer CC Projektvariable zu definieren. Diese sind dann Client Command spezifische Einstellungen, die nur diesem CC mitgegeben werden.
194
195 Definiert werden die Parameter hierfür im Client Command Center bzw. Editor. Zum Hinzufügen von Parameterwerten können Sie über 2 Wege gehen:
196
197 1. In der Navigation über //Client Commands > Erstellen > Rechtsklick auf einen bereits bestehenden CC > Eigenschaften > Client Command spezifisch > Parameter//.
198 1. Über einen Doppelklick auf ein bereits bestehendes CC oder ein neu erstelltes > Oberhalb der Befehle auf// Eigenschaften //> //Client Command spezifisch > Parameter//.
199
200 {{figure}}
201 (% style="text-align:center" %)
202 [[image:66.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Menüleiste.WebHome@Eigenschaften Parameter.PNG]]
203
204 {{figureCaption}}
205 Parameterwerte definieren
206 {{/figureCaption}}
207 {{/figure}}
208
209 In diesem Bereich werden alle bestehenden Parameter angezeigt. Über [[image:https://doc.aagon.com/bin/download/66/ACMP-Solutions/Client%20Commands/Client%20Command%20erstellen/Client%20Commands%20neu%20hinzuf%C3%BCgen/Client%20Command%20Editor/Men%C3%BCleiste/WebHome/image-20230710101736-1.png?width=21&height=20&rev=1.1||alt="image-20230710101736-1.png"]] fügen Sie dem CC einen neuen Parameter hinzu, über  [[image:https://doc.aagon.com/bin/download/66/ACMP-Solutions/Client%20Commands/Client%20Command%20erstellen/Client%20Commands%20neu%20hinzuf%C3%BCgen/Client%20Command%20Editor/Men%C3%BCleiste/WebHome/1688977083738-222.png?rev=1.1||alt="1688977083738-222.png"]] löschen Sie den Parameter, über [[image:https://doc.aagon.com/bin/download/66/ACMP-Solutions/Client%20Commands/Client%20Command%20erstellen/Client%20Commands%20neu%20hinzuf%C3%BCgen/Client%20Command%20Editor/Men%C3%BCleiste/WebHome/1688977109352-790.png?rev=1.1||alt="1688977109352-790.png"]] editieren Sie die Parameter. Beim Hinzufügen gibt es 3 Typen von Parametern, zwischen denen Sie auswählen können:
210
211 **~1. Text**
212
213 {{figure}}
214 (% style="text-align:center" %)
215 [[image:66.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Menüleiste.WebHome@Parameter Text.PNG]]
216
217 {{figureCaption}}
218 Parameter-Typ: Text
219 {{/figureCaption}}
220 {{/figure}}
221
222 Bei diesem Parameter-Typen können Sie die Parameterwerte über einen Freitext angeben.
223
224 Unter //Variablenname //wählen Sie eine CC Projektvariable aus, die Sie über [[image:https://doc.aagon.com/bin/download/66/ACMP-Solutions/Client%20Commands/Client%20Command%20erstellen/Client%20Commands%20neu%20hinzuf%C3%BCgen/Client%20Command%20Editor/Men%C3%BCleiste/WebHome/image-20230710101949-5.png?rev=1.1||alt="image-20230710101949-5.png"]]im CC Editor ausgewählt haben oder geben Sie direkt den Namen der CC Projektvariable ein.
225
226 Dabei können nur
227
228 1. schreibbare Projektvariablen verwendet werden und
229 1. eine bereits von einem anderen Parameter verwendete Projektvariable kann nicht bei einem weiteren Parameter angewendet werden.
230
231 Geben Sie dann eine deutsche oder eine englische Bezeichnung an.
232
233 {{aagon.infobox}}
234 Diese Bezeichnung ist der Text, der in einer deutschen oder englischen Console angezeigt wird, wenn auch der Parameter angezeigt wird.
235 {{/aagon.infobox}}
236
237 Über die Einstellung //Option //wird die Sichtbarkeit des CCs für den Endbenutzer im ACMP Kiosk eingestellt. Sie haben die Auswahl aus //Unsichtbar für Endanwender//, //Nur lesbar für Endanwender //und //Editierbar für Endanwender. //Über //Standardwert //geben Sie einen Wert in Form eines Freitextes an, der standardmäßig eingestellt sein soll.
238
239 {{aagon.infobox}}
240 Dieser Wert ist nicht der Standardwert der CC Projektvariable. Dieser Wert wird bei der Ausführung des CC Jobs an das CC Skript übergeben und überschreibt somit den Standardwert der CC Projektvariablen.
241 {{/aagon.infobox}}
242
243 **2. Combobox**
244
245 {{figure}}
246 (% style="text-align:center" %)
247 [[image:66.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Menüleiste.WebHome@Combobox.PNG]]
248
249 {{figureCaption}}
250 Parameter-Typ: Combobox
251 {{/figureCaption}}
252 {{/figure}}
253
254 Bei diesem Parameter-Typen können Sie die Parameterwerte über eine Combobox angeben.
255
256 Unter //Variablenname// wählen Sie eine CC Projektvariable aus, die Sie über [[image:https://doc.aagon.com/bin/download/66/ACMP-Solutions/Client%20Commands/Client%20Command%20erstellen/Client%20Commands%20neu%20hinzuf%C3%BCgen/Client%20Command%20Editor/Men%C3%BCleiste/WebHome/image-20230710101949-5.png?rev=1.1||alt="image-20230710101949-5.png"]]im CC Editor ausgewählt haben oder geben direkt den Namen der CC Projektvariable ein.
257
258 Dabei können nur
259
260 1. schreibbare Projektvariablen verwendet werden und
261 1. eine bereits von einem anderen Parameter verwendete Projektvariable kann nicht bei einem weiteren Parameter angewendet werden.
262
263 Geben Sie dann eine deutsche oder eine englische Bezeichnung an.
264
265 {{aagon.infobox}}
266 Diese Bezeichnung ist der Text, der in einer deutschen oder englischen Console angezeigt wird, wenn auch der Parameter angezeigt wird.
267 {{/aagon.infobox}}
268
269 Über die Einstellung //Option //wird die Sichtbarkeit des CCs für den Endbenutzer im ACMP Kiosk eingestellt. Sie haben die Auswahl aus //Unsichtbar für Endanwender//,// Nur lesbar für Endanwender //und //Editierbar für Endanwender. //In //Combobox-Konfiguration// können die möglichen Combobox-Elemente konfiguriert werden.// //
270
271 Geben Sie über //Hinzufügen// den Wert der Variable ein, der in die Projektvariable geschrieben werden wird, wenn dieser Eintrag der Combobox gewählt wird. I.d.R. handelt es sich dabei um Software, die installiert oder deinstalliert werden soll. Sprechende Werte dafür wären „Installieren“ und „Deinstallieren“.
272
273 {{figure}}
274 (% style="text-align:center" %)
275 [[image:66.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Menüleiste.WebHome@Parameter.png||height="648" width="450"]]
276
277 {{figureCaption}}
278 Konfigurationen zur Combobox eintragen
279 {{/figureCaption}}
280 {{/figure}}
281
282 Die Reihenfolge, in der die Combobox-Einträge beim Erstellen von Jobs angezeigt werden, kann angepasst werden sowie welcher Eintrag der Standardwert des neuen Jobs ist.
283
284 **3. Checkbox**
285
286 {{figure}}
287 (% style="text-align:center" %)
288 [[image:66.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Menüleiste.WebHome@Checkbox.PNG]]
289
290 {{figureCaption}}
291 Parameter-Typ: Checkbox
292 {{/figureCaption}}
293 {{/figure}}
294
295 Bei diesem Parameter-Typen können Sie die Parameterwerte in einer Checkbox angeben.
296 Unter //Variablenname// wählen Sie eine CC Projektvariable aus, die Sie über [[image:https://doc.aagon.com/bin/download/66/ACMP-Solutions/Client%20Commands/Client%20Command%20erstellen/Client%20Commands%20neu%20hinzuf%C3%BCgen/Client%20Command%20Editor/Men%C3%BCleiste/WebHome/image-20230710101949-5.png?rev=1.1||alt="image-20230710101949-5.png"]] im CC Editor ausgewählt haben oder geben direkt den Namen der CC Projektvariable ein.
297
298 Dabei können nur
299
300 1. schreibbare Projektvariablen verwendet werden und
301 1. eine bereits von einem anderen Parameter verwendete Projektvariable kann nicht bei einem weiteren Parameter angewendet werden.
302
303 Geben Sie dann eine deutsche oder eine englische Bezeichnung an.
304
305 {{aagon.infobox}}
306 Diese Bezeichnung ist der Text, der in einer deutschen oder englischen Console angezeigt wird, wenn auch der Parameter angezeigt wird.
307 {{/aagon.infobox}}
308
309 Über die Einstellung //Option// wird die Sichtbarkeit des CCs für den Endbenutzer im ACMP Kiosk eingestellt. Sie haben die Auswahl aus //Unsichtbar für Endanwender//, //Nur lesbar für Endanwender// und //Editierbar für Endanwender//. In der// Checkbox-Konfiguration// können Sie einstellen, welcher Wert, also 1 oder 0, an das CC übergeben werden soll. Über den Standardwert legen Sie fest, ob standardmäßig der Wert 1 für „angekreuzt“ oder 0 für „Nicht angekreuzt“ voreingestellt ist.
310
311 Klicken Sie in allen drei Fällen des Parameter-Typs auf //Speichern//. Anschließend können Sie über das Anlegen von neu erstellten oder Auswählen von bereits angelegten [[Client Command Jobs >>doc:ACMP.66.ACMP-Solutions.Jobs.WebHome||anchor="HParameterfFCrClientCommandJobseinstellen"]]die Parameter anwenden.
312
313 === Änderungen an den Parametern ===
314
315 Da Parameter Client Command spezifisch sind, wirken sich jegliche Änderungen immer auf alle Versionen des CCs aus. Folgende Fälle und ihre Auswirkungen kann dies für das CC bedeuten:
316
317 |=Änderungen|=Auswirkungen
318 |Parameter wird hinzugefügt|Für bereits bestehende Jobs wird der zum Zeitpunkt der Erstellung des Parameters geltende Defaultwert des neuen Parameters verwendet.
319 |Parameter wird entfernt|Der Parameter wird auch bei bestehenden Jobs nicht mehr verwendet. Das kann zu fehlschlagenden alten CC Versionen führen.
320 |Defaultwert wird geändert|Bestehende Jobs werden nicht verändert. Bei neu erstellten Jobs wird der neue Defaultwert angewendet.
321 |Name des Parameters wird geändert|Bestehende Jobs werden nicht verändert. Der Name ist nicht relevant für die Ausführung.
322 |Mögliche Werte des Parameters werden geändert|(((
323 **Checkbox:**
324
325 Es werden die neu eingestellten Werte verwendet, auch bei bestehenden Jobs. Das kann zu fehlschlagenden alten CC Versionen führen.
326 )))
327 | |(((
328 **Text:**
329
330 Jegliche Änderungen am Freitext ändern nur den Defaultwert. Sie ändern nichts an bestehenden Jobs. Bei neuen Jobs wird dann der neue Default angewendet.
331 )))
332 | |(((
333 **Combobox:**
334
335 //Einen neuen Eintrag hinzufügen//
336
337 Bestehende Jobs werden nicht verändert. Bei neuen Jobs oder beim Editieren bestehender Jobs ist der neue Eintrag verfügbar.
338
339 //Einen bereits bestehenden Eintrag löschen//
340
341 Bei Jobs, bei denen der gelöschte Eintrag eingestellt war, wird stattdessen der Defaulteintrag des Parameters verwendet.
342
343 //Einen Defaulteintrag löschen//
344
345 Wenn der Defaulteintrag gelöscht wird, muss ein neuer Defaulteintrag ausgewählt werden. Bei Jobs, bei denen der gelöschte Eintrag eingestellt war, wird stattdessen der neue Defaulteintrag des Parameters verwendet.
346
347 //Den Wert eines Eintrags ändern//
348
349 Es wird der neu eingestellte Wert verwendet, auch bei bestehenden Jobs. Das kann zu fehlschlagenden alten CC Versionen führen.
350
351 //Einen bereits bestehenden Eintrag umbenennen//
352
353 Bestehende Jobs werden nicht verändert. Der Name ist nicht relevant für die Ausführung.
354
355 //Den Defaulteintrag wechseln//
356
357 Bestehende Jobs werden nicht verändert. Bei neuen Jobs wird der neue Defaulteintrag vorausgewählt.
358 )))
359
360 = Versionsspezifisch =
361
362 {{aagon.infobox}}
363 Diese Einstellungen gelten nur für diese spezifische Version des Client Commands. Wenn Sie Änderungen an diesen Einstellungen vornehmen, wirken sie sich nicht auf andere Versionen aus. Versionsbezogene Eigenschaften können nur geändert werden, wenn das Client Command sich im Status „Erstellen“ befindet.
364 {{/aagon.infobox}}
365
366 == Allgemein ==
367
368 In den Versionseinstellungen können Sie mit den sogenannten „Leveln“ eines Client Commands arbeiten. Ein Level ist für den Anwendungsfall gedacht, wenn ein Client Command in einem Container einmalig ausgeführt werden soll.
369
370 {{figure}}
371 (% style="text-align:center" %)
372 [[image:66.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Menüleiste.WebHome@Client Command_Eigenschaften_Versionsspezifisch allgemein.png]]
373
374 {{figureCaption}}
375 Versionseinstellungen des Client Commands
376 {{/figureCaption}}
377 {{/figure}}
378
379 Wenn Sie eine neue Version erstellen, in der alle Clients eines Containers das bereits ausgeführte Client Command erneut ausführen sollen, dann müssen Sie neben der Version auch das Level erhöhen.
380
381 Erhöhen Sie das Level des Client Commands, indem Sie auf //Level erhöhen// klicken. Das Client Command besitzt dann das Level 1. Jedes Client Command, das danach erneut ausgeführt werden soll, erhöht sich um +1.
382
383 In die Beschreibung können Sie weitere Informationen hinzufügen, die für eine Version wichtig sein können.
384
385 == Bedingung ==
386
387 Unter //Bedingungen// können Sie zusätzliche Bedingungen angeben, welche bei der Ausführung des Commands berücksichtigt werden sollen.
388
389 {{figure}}
390 (% style="text-align:center" %)
391 [[image:66.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Menüleiste.WebHome@CC_Eigenschaften_Bedingungen.PNG]]
392
393 {{figureCaption}}
394 Versionsspezifische Bedingungen des Client Commands
395 {{/figureCaption}}
396 {{/figure}}
397
398 Dazu ziehen Sie eine Bedingung von der linken Seite per Drag-and-Drop oder per Doppelklick auf die rechte Seite auf die ODER- bzw. die UND-Bedingung. Dies ist ähnlich den Filtern, welche bei einer Abfrage gesetzt werden können.
399
400 Sie können die Bedingungen auch verschachteln, sodass eine Bedingung z.B. nach dem Muster X ODER (Y UND Z) entsteht. Ziehen Sie z.B. eine Bedingung auf eine bereits bestehende UND-Bedingung, so werden diese beiden Bedingungen in den Kontext mit einer ODER-Bedingung gesetzt.
401
402 {{aagon.infobox}}
403 Bedingungen können für jede Version eines Client Command angepasst werden.
404 {{/aagon.infobox}}
405
406 Im Folgenden werden die verschiedenen Bedingungen genauer erläutert:
407
408 |**Conditions**|**Bedingung**
409 |If file exists|Mit dieser Bedingung können Sie überprüfen, ob eine bestimmte Datei existiert.
410 |Is machine in AD group|Mit dieser Bedingung können Sie prüfen, ob der Rechner zur angegebenen AD-Gruppe gehört. Dazu geben Sie entweder eine Gruppe in der Form von „Domänenname\Gruppenname“ oder die SID der Gruppe an. Der Button neben dem Eingabefeld listet Ihnen dazu alle verfügbaren Domains auf.
411 |Is user in AD group|Mit dieser Bedingung können Sie prüfen, ob ein bestimmter Benutzer zur angegebenen AD-Gruppe gehört. Dazu geben Sie entweder eine Gruppe in der Form von „Domänenname\Gruppenname“ oder die SID der Gruppe an. Der Button neben dem Eingabefeld listet Ihnen dazu alle verfügbaren Domains auf.
412 |If OS architecture is|Mit dieser Bedingung können Sie überprüfen, ob ein 32- oder 64-bit Betriebssystem auf dem Client vorhanden ist.
413 |If ADS Container/Property matches|Mit dieser Bedingung können Sie überprüfen, ob der aktuelle Benutzer bzw. der Client in einem bestimmten AD-Container liegt oder eine bestimmte Eigenschaft besitzt. Um die AD-Container bzw. die Eigenschaften auszuwählen, klicken Sie auf den Button rechts neben dem Eingabefeld.
414 |If machine is in domain|Mit dieser Bedingung können Sie prüfen, ob ein Client zur angegebenen Domain gehört. Dazu geben Sie einfach eine Domain an. Der Button neben dem Eingabefeld listet Ihnen dazu alle verfügbaren Domains auf.
415 |If registry value name exists|(((
416 Mit dieser Bedingung können Sie überprüfen, ob ein bestimmter Schlüssel der Registry existiert und einen bestimmten Wert besitzt. Geben Sie dazu aus dem DropDown-Feld den Hauptschlüssel und anschließend den Unterschlüssel an. Den Wert tragen Sie ebenfalls ein.
417
418 Über den Button unter den Eingabefeldern öffnet sich ein Registryeditor, womit Sie einen Schlüssel direkt auswählen können.
419 )))
420 |If registry key exists|Mit dieser Bedingung können Sie überprüfen, ob ein bestimmter Schlüssel der Registry existiert. Geben Sie dazu aus dem DropDown-Feld den Hauptschlüssel und anschließend den Unterschlüssel an. Über den Button unter den Eingabefeldern öffnet sich ein Registryeditor, womit Sie einen Schlüssel direkt auswählen können.
421 |Is CPU speed|(((
422 Mit dieser Bedingung können Sie den CPU-Takt überprüfen. Dazu stehen Ihnen die mathematischen Operatoren zur Verfügung wozu Sie noch den passenden Takt in Hz (Hertz) angeben.
423
424 {{aagon.infobox}}
425 Die Bedingung bezieht sich immer auf die zum Prüfzeitpunkt aktuelle Taktrate der CPU. Diese ändert sich bei modernen CPUs im laufenden Betrieb.
426 {{/aagon.infobox}}
427 )))
428 |If free product licenses are available|Mit dieser Bedingung können Sie überprüfen, ob freie Produktlizenzen innerhalb des Lizenzmanagements verfügbar sind.
429 |Is RAM capacity|Mit dieser Bedingung können Sie den freien Arbeitsspeicher überprüfen. Dazu stehen Ihnen die mathematischen Operatoren zur Verfügung, wozu Sie noch die Größe des RAM angeben.
430 |If directory exists|Mit dieser Bedingung können Sie überprüfen, ob ein bestimmtes Verzeichnis existiert. Dazu geben Sie einfach das entsprechende Verzeichnis an.
431 |Compare strings|Mit dieser Bedingung können Sie überprüfen, ob zwei Zeichenketten gleich sind. So können Sie z.B. als erste Zeichenkette eine ACMP Systemvariable eingeben und als zweite Zeichenkette einen bestimmten Wert. Variablen werden im Format //%Variablenname%// angegeben.
432 |Is file version|Mit dieser Bedingung können Sie die Dateiversion überprüfen. Dazu stehen Ihnen die mathematischen Operatoren zur Verfügung, wozu Sie noch die passende Datei auswählen und die Dateiversion angeben. Nur ausführbare Dateien haben eine Versionsnummer.
433 |Is file date|Mit dieser Bedingung können Sie das Änderungsdatum einer Datei überprüfen. Dazu stehen Ihnen die mathematischen Operatoren zur Verfügung, wozu Sie noch die passende Datei auswählen und das Änderungsdatum im Format dd.mm.yy hh:mm:ss angeben.
434 |Is free disk space|Mit dieser Bedingung können Sie den freien Speicher einer Partition der Festplatte überprüfen. Dazu stehen Ihnen die mathematischen Operatoren zur Verfügung, wozu Sie noch die Größe des Speichers sowie die Partition angeben.
435 |Is operating system|Mit dieser Bedingung können Sie überprüfen, ob das Betriebssystem eine bestimmte Version besitzt, z.B. Windows 10 oder Windows 11. Wählen Sie dazu einfach die passende Version aus dem DropDown-Feld.
436 |Is machine name|Mit dieser Bedingung können Sie überprüfen, ob der Rechnername gleich einem angegebenen Namen ist. Dazu klicken Sie auf den Button rechts neben dem Eingabefeld. Dort werden Ihnen alle Rechner einer Domain aufgelistet. Klicken Sie auf den Button darunter, werden ihnen nur Rechner aufgelistet, welche im ACMP inventarisiert sind.
437 |Is user local admin|Mit dieser Bedingung können Sie überprüfen, ob der angemeldete Benutzer lokale Administratorrechte besitzt.
438 |Is logon user|Mit dieser Bedingung können Sie überprüfen, ob ein bestimmter Benutzer am Client angemeldet ist. Klicken Sie auf den Button rechts neben dem Eingabefeld und es werden Ihnen alle vorhandenen und bekannten User einer Domain aufgelistet. Markieren Sie einen entsprechenden User und klicken Sie auf //Hinzufügen//. Wenn Sie alle nötigen User hinzugefügt haben klicken Sie auf //OK.//
439 |Is in container|Mit dieser Bedingung können Sie überprüfen, ob der inventarisierte Rechner in einem bestimmten Container liegt.
440 |Is software installed|(((
441 Mit dieser Bedingung können Sie überprüfen, ob eine bestimmte Software installiert ist.
442
443 {{aagon.infobox}}
444 Diese Bedingung bezieht sich darauf, ob das Command „Set software installed“ mit einem bestimmten Softwarenamen ausgeführt wurde, es prüft also nicht, ob z.B. Firefox generell installiert ist!
445 {{/aagon.infobox}}
446 )))
© Aagon GmbH 2025
Besuchen Sie unsere neue Aagon-Community