Zuletzt geändert von Sabrina V. am 2024/08/22 12:50
Zeige letzte Bearbeiter
1 {{aagon.priorisierung}}
2 160
3 {{/aagon.priorisierung}}
4
5 {{aagon.floatingbox/}}
6
7 = Ausgangslage =
8
9 Im normalen Arbeitsalltag kommt es oft vor, dass Sie den Mitarbeitern Ihres Unternehmens neue Software zur Verfügung stellen wollen. Entweder können Sie die Installationsressourcen manuell an jeden einzelnen Client verteilen oder Sie stellen die Dateien einfach als Client Command bereit, sodass jeder darauf zugreifen kann.
10 In diesem Beispiel erfahren Sie, wie Sie eine MSI-Datei an die Clients verteilen. Hierbei wird exemplarisch das Datenkompressionsprogramm //7-Zip //über Ihren Agent hochgeladen und anschließend bereitgestellt. Grundsätzlich kann es mehrere Wege geben, wie Sie so eine Datei verteilen können. An dieser Stelle soll nur aufgezeigt werden, wie Sie dies über die File Repositories von ACMP erledigen können. Durch das File Repository stellen Sie sicher, dass trotz unterschiedlicher oder wechselnder Standorte alle Mitarbeiter die Ressource erhalten. Gehen Sie dafür wie folgt vor:
11
12 == Skript auswählen ==
13
14 1. Navigieren Sie ins Modul //Client Commands// > //Erstellen//.
15 1. Klicken Sie in der Ribbonleiste auf //Hinzufügen//. Es öffnet sich der Client Command Editor, in dem Sie entscheiden müssen, ob es sich um ein Console- oder Clientskript handelt. In diesem Fall wählen Sie das Clientskript aus.
16
17 == Dateiupload in das File Repository ==
18
19 (% class="wikigeneratedid" %)
20 Um mit den eigentlichen Arbeiten am Client Command zu beginnen, müssen Sie zunächst die Installationsressource im File Repository hinterlegen.
21
22 1. Öffnen Sie das File Repository über die Commandliste ([[image:image-20230809131053-1.png]]).
23 1. Klicken Sie auf die Spalte des File Repositories, sodass sich die Unterordner öffnen.
24 1. Wählen Sie den Ordner //Private //aus.
25
26 {{aagon.infobox}}
27 Es ist wichtig, dass Sie den Ordner Private auswählen, da die Installationsressource nur für das Client Command genutzt werden soll.
28 {{/aagon.infobox}}
29
30 4. Fügen Sie die Datei dem privaten File Repository hinzu, indem Sie auf das entsprechende Icon ([[image:image-20230809131133-3.png]]) klicken.
31 5. Es öffnet sich ein Dialog. Wählen Sie die Installationsressource aus, die Sie im Client Command zur Verfügung stellen wollen. In diesem Beispiel wird 7-Zip verwendet.
32 6. Laden Sie die MSI-Datei per Doppelklick hinein.
33 Es erscheint ein Ladebalken, der Sie über den Fortschritt informiert. In diesem Beispiel wurde die 7x2201-x64.msi Datei von 7-Zip erfolgreich in das File Repository geladen.
34 7. Klicken Sie abschließend auf //Schließen//.
35
36 {{figure}}
37 (% style="text-align:center" %)
38 [[image:65_Use Case Client Commands_Installationsressource im File Repository hinterlegen.png]]
39
40 {{figureCaption}}
41 Installationsressource im File Repository hinterlegen
42 {{/figureCaption}}
43 {{/figure}}
44
45 == Command //Download File// einfügen und anpassen ==
46
47 1. Navigieren Sie in die Commandliste und wählen Sie den Befehl //File Repository //>// Download File //aus.
48 1. Öffnen Sie den Befehl per Doppelklick.
49 1. Klicken Sie unter //Datei(en) auswählen //auf das Icon rechts neben dem Feld.
50 1. Öffnen Sie im File Repository unter dem Ordner //Private //die hinzugefügte Datei (7x2201-x64.msi), indem Sie einen Haken vor der Datei setzen. Es müssen nun die Punkte //File Repository//, //Private //und //7x2201-x64.msi// angehakt sein.
51 1. Klicken Sie anschließend auf //Schließen//, um wieder zum vorherigen Fenster zu gelangen.
52 1. Navigieren Sie zu //Speichern unter//. Dort können Sie entweder den Pfad, wo die Datei gespeichert werden soll, unter dem Icon rechts neben dem Feld auswählen. Alternativ können Sie aber auch die //%PROJECTDIR% //Variable verwenden.
53
54 {{aagon.infobox}}
55 PROJECTDIR ist eine temporäre Variable, die während der Ausführung vom Client Command ein Verzeichnis generiert und nach der Laufzeit des Client Commands dieses auch automatisch aufräumt. Hierdurch werden Dateien in das PROJECTDIR heruntergeladen.
56 {{/aagon.infobox}}
57
58 7. Rufen Sie die %PROJECTDIR% Variable über STRG + Leertaste auf.
59 8. Wechseln Sie in den //Allgemein //Tab.
60 9. Fügen Sie dort eine neue Beschreibung der Aktion ein, zum Beispiel "7-Zip ins %PROJECTDIR% herunterladen.
61 10. Beenden Sie Ihre Arbeiten an dem Befehl, indem Sie auf //OK //klicken.
62
63 {{figure}}
64 (% style="text-align:center" %)
65 [[image:65_Use Case Client Commands_Datei herunterladen.png]]
66
67 {{figureCaption}}
68 Datei herunterladen
69 {{/figureCaption}}
70 {{/figure}}
71
72 == Command //Install MSI package //einfügen und bearbeiten ==
73
74 1. Laden Sie den Befehl //Install MSI package //(MSI) in das Skript, indem Sie es wie die vorherigen aus der Commandliste per Doppelklick auswählen.
75 1. Klicken Sie im Bereich //Paket //auf das //Durchsuchen //Icon.
76 1. Wählen Sie dort die 7-Zip Installationsdatei aus und klicken dann auf //Öffnen//.
77 1. Entfernen Sie den Pfad bis auf den Dateinamen und ersetzen Sie diesen Teil durch die %PROJECTDIR% Variable. Wählen Sie dazu mit STRG + Leertaste die Variable %PROJECTDIR% aus. Es sollte nun an dieser Stelle „%PROJECTDIR%7z2201-x64.msi“ stehen.
78
79 {{aagon.infobox}}
80 Zwischen der Variable und dem Dateinamen darf kein Backslash stehen, da sämtliche Verzeichnisvariablen im ACMP auf einen Backslash enden.
81 {{/aagon.infobox}}
82
83 5. Haken Sie unter den Richtlinien den //Registry Schlüssel 'Immer mit erhöhten Rechten installieren' setzen //an.
84 6. Schließen Sie diesen Befehl mit //OK//.
85
86 {{figure}}
87 (% style="text-align:center" %)
88 [[image:65_Use Case Client Commands_MSI Paket installieren.png]]
89
90 {{figureCaption}}
91 MSI Paket installieren
92 {{/figureCaption}}
93 {{/figure}}
94
95 == Command //Run Client Task //einfügen und editieren ==
96
97 Diesen Befehl können Sie Ihrem Client Command hinzufügen, um den Software Scanner direkt im Anschluss starten zu lassen. So wird sichergestellt, dass die neue Software direkt inventarisiert wird und in der Console zur Verfügung steht.
98
99 1. Wählen Sie den Befehl //ACMP// > //Run Client Task //aus der Commandliste aus.
100 1. Öffnen Sie den //Allgemein //Tab.
101 1. Fügen Sie unter //Beschreibung der Aktion //einen Namen ein, z.B. „Software Scanner als geplante Aufgabe ausführen“.
102 1. Wechseln Sie zurück in den Tab //Details//.
103 1. Wählen Sie unter //Als geplante Aufgabe ausführen// den //Software Scanner// aus. Hierdurch wird das System inventarisiert und die neu hinzugefügte Software in der Console aktualisiert.
104 1. Klicken Sie auf //OK//.
105
106 {{figure}}
107 (% style="text-align:center" %)
108 [[image:65_Use Case Client Commands_Software Scanner als geplante Aufgabe ausführen.png]]
109
110 {{figureCaption}}
111 Software Scanner als geplante Aufgabe ausführen
112 {{/figureCaption}}
113 {{/figure}}
114
115 Speichern Sie Ihr Client Command. Es empfiehlt sich, je nach Größe der Umgebung, einen treffenden Namen zu vergeben, damit Sie schnell das Command wiederfinden können. Dieses Beispiel wurde „7-Zip 7x2201-x64 Installation“ genannt und setzt sich aus dem Namen der Software sowie der Versionsnummer zusammen.
116
117 {{figure}}
118 (% style="text-align:center" %)
119 [[image:65_Use Case Client Commands_Übersicht exemplarische Bereitstellung und Ausführung einer Datei über das File Repository (MSI-Datei)_1377.png]]
120
121 {{figureCaption}}
122 Client Command-Editor: Exemplarische Bereitstellung und Ausführung einer Datei über das File Repository (MSI-Datei)
123 {{/figureCaption}}
124 {{/figure}}
125
126 == Client Command-Phasen durchlaufen lassen ==
127
128 Das Client Command muss abschließend die Phasen [[Testen>>doc:ACMP.65.ACMP-Solutions.Client Commands.Client Command testen.WebHome]], [[Synchronisieren>>doc:ACMP.65.ACMP-Solutions.Client Commands.Client Command synchronisieren.WebHome]], [[Freigeben>>doc:ACMP.65.ACMP-Solutions.Client Commands.Client Command freigeben.WebHome]] und [[Ausführen>>doc:ACMP.65.ACMP-Solutions.Client Commands.Client Command freigeben.WebHome]] durchlaufen, damit es verwendet werden kann. Danach haben Sie die Möglichkeit die Installationsressource der Software 7-Zip an Ihre Clients zu verteilen und auszuführen.
© Aagon GmbH 2025
Besuchen Sie unsere neue Aagon-Community