Zuletzt geändert von Jannis Klein am 2024/03/19 17:56
Zeige letzte Bearbeiter
1 {{aagon.priorisierung}}
2 160
3 {{/aagon.priorisierung}}
4
5 {{aagon.floatingbox/}}
6
7 = Ausgangslage =
8
9 Mithilfe des Client Command Bausteins „modify registry value“ können Sie einzelne Registry-Werte bearbeiten oder neu setzen. Möchten Sie jedoch gebündelt mehrere Registry-Werte anpassen oder verändern, können Sie eine Registry-Datei über den Baustein „Shell execute command“ importieren.
10 Hierzu müssen Sie eine Reg-Datei importieren, die Sie bereits zuvor angelegt oder exportiert haben. Diese Datei können Sie aus der Registry eines Muster-Clients exportieren, um sie dann bei allen anderen Clients wieder zu importieren. Hierdurch sparen Sie nicht nur Zeit, es werden auch einheitliche Werte und Parameter weitergegeben.
11 \\Neben dem Import einer Reg-Datei können Sie diese Datei auch exportieren. Der Export der Datei hilft Ihnen dabei, dass die angegebenen Schlüssel, Einträge und Werte des lokalen Computers kopiert und auf einen anderen Server oder Client übertragen werden können. Dies ist beispielsweise dann hilfreich, wenn Sie die Einstellungen des Betriebssystems auch auf anderen Computern verwenden wollen.
12 \\In diesem Use Case werden sowohl die Herangehensweisen eines Imports als auch eines Exports einer Reg-Datei aufgeführt. Beide Teilbereiche können unabhängig voneinander angewendet werden. Gehen Sie wie folgt vor:
13
14 = Reg-Datei importieren =
15
16 == Skript auswählen ==
17
18 1. Navigieren Sie ins Modul //Client Commands// > //Erstellen//.
19 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 Consolen- oder Clientskript handelt. In diesem Fall wählen Sie das Clientskript aus.
20
21 == Command //Action Group //einfügen und anpassen ==
22
23 1. Wählen Sie zunächst aus der Commandliste das Command //Miscellaneous// > //Action Group //aus. Diesen Befehl benötigen Sie dafür, um das Skript zu strukturieren und es lesbarer zumachen.
24 1. Öffnen Sie den Befehl per Doppelklick.
25 1. Geben Sie unter //Beschreibung der Aktion// einen Namen ein, wie z.B. „Reg-Datei importieren“.
26 1. Klicken Sie auf //OK//.
27 Es erscheint der erste Befehl in der Zeile 1.
28
29 == Command //Download File// einfügen und anpassen ==
30
31 1. Navigieren Sie zurück in die Commandliste und wählen Sie den Befehl //File Repository //> //Download File// aus.{{aagon.infobox}}Rücken Sie diesen Befehl entweder über die Schnellwahlleiste oder den Shortcut STRG + -> ein, sodass er unterhalb des ersten Befehls (Action group) angezeigt wird. Beim Hinzufügen dieses Befehls können Sie auch das Command einfach auf die Zeile des Reg-Datei importieren ziehen, wodurch es korrekt eingegliedert wird. {{/aagon.infobox}}
32 1. Öffnen Sie den Befehl und klicken Sie in den Tab //Allgemein//.
33 1. Fügen Sie unter //Beschreibung der Aktion //einen Namen ein, z.B. „Datei herunterladen“.
34 1. Wechseln Sie anschließend in den Tab //Datei(en) suchen.//
35 1. Klicken Sie dort auf das Icon innerhalb des Feldes //Datei(en) auswählen//. Es öffnet sich das File Repository Fenster.
36 1. Laden Sie die zuvor exportierte //logging.reg//-Datei in den Ordner „Private“ hoch. Nachdem die Datei hochgeladen wurde, markieren Sie noch die Datei zum Download. Setzen Sie dafür den Haken vor dem Dateinamen.
37 1. Klicken Sie nun auf //Schließen//, um wieder zum vorherigen Fenster zu gelangen.{{aagon.infobox}}Durch das Hochladen in das Private-Verzeichnis stellen Sie sicher, dass die Datei ausschließlich für das aktuelle Client Command nutzbar ist. Die Reg-Datei, die Sie hiermit herunterladen, wird auf den verteilten File Repositories synchronisiert.{{/aagon.infobox}}
38 1. Tragen Sie unter dem Bereich //Speichern unter //die %PROJECTDIR% Variable ein. Hierdurch wird ein temporäres Zielverzeichnis verwendet, welches am Ende der Laufzeit des Client Commands automatisch durch den ACMP Client wieder bereinigt wird. Das bedeutet, dass die Datei nach dem Import nicht noch von Ihnen manuell entfernt werden muss.
39
40 {{figure}}
41 (% style="text-align:center" %)
42 [[image:64_Use Case_Client Command_Reg-Dateien_Download File_708.png]]
43
44 {{figureCaption}}
45 Angepasstes Command Download File
46 {{/figureCaption}}
47 {{/figure}}
48
49 9. Klicken Sie auf //OK//, um den Befehl in der Zeile 2 anzeigen zu lassen.
50
51 == **Command //Shell execute command// einfügen und bearbeiten** ==
52
53 1. Laden Sie den Befehl //Shell execute command //(Processes and Shell) in das Skript, indem Sie es wie die vorherigen aus der Commandliste per Doppelklick auswählen.
54 Optional: Sollten Sie mit dem Befehl //Action group //arbeiten, müssen Sie den Befehl //Shell execute command //eingerücken. Dies überstützt Sie bei der Lesbarkeit und der Struktur des Client Commands. Sollten Sie dies bereits erledigt haben, können Sie diesen Schritt überspringen.
55 1. Öffnen Sie den Tab //Allgemein//.
56 1. Vergeben Sie einen Namen unter der //Beschreibung der Aktion//, z.B. „Befehl ausführen“.
57 1. Wechseln Sie in den Tab //Details//.
58 1. Unter den Aufrufoptionen müssen Sie einen Dateinamen und die Parameter eintragen.
59 1. Geben Sie folgende Angaben in den Bereichen ein:
60
61 |**Dateiname**|reg.exe oder den Dateipfad{{aagon.infobox}}Standardmäßig befindet sich die reg.exe im Pfad C:\Windows\System32\reg.exe{{/aagon.infobox}}
62 |**Parameter**|import "%PROJECTDIR%logging.reg“
63
64 {{figure}}
65 (% style="text-align:center" %)
66 [[image:64_Use Case_Client Command_Reg-Dateien_Shell execute command import_708.png]]
67
68 {{figureCaption}}
69 Angepasstes Command Shell execute command
70 {{/figureCaption}}
71 {{/figure}}
72
73 7. Bestätigen Sie die Angaben, indem Sie auf //OK //klicken.
74 Es wird die Zeile 3 eingefügt.
75 8. Speichern Sie nun das Client Command ab, sollten Sie keine inhaltlichen Änderungen mehr vornehmen wollen.
76
77
78 Sollten Sie lediglich eine Reg-Datei importieren wollen, reichen diese drei Befehle bereits aus. Speichern Sie das Command ab und fahren Sie mit dem Durchlauf der Client Command-Phasen fort.
79
80 {{figure}}
81 (% style="text-align:center" %)
82 [[image:64_Client Command Use Case_Reg import_1350.png||alt="64_Client Command Use Case_Reg export_1350.png"]]
83
84 {{figureCaption}}
85 Client Command-Editor: Reg-Datei importieren
86 {{/figureCaption}}
87 {{/figure}}
88
89 == **Client Command-Phasen durchlaufen lassen** ==
90
91 Das Client Command muss abschließend die Phasen [[//Testen//>>doc:ACMP.64.ACMP-Solutions.Client Commands.Client Command testen.WebHome]], [[//Synchronisieren//>>doc:ACMP.64.ACMP-Solutions.Client Commands.Client Command synchronisieren.WebHome]], [[//Freigeben// >>doc:ACMP.64.ACMP-Solutions.Client Commands.Client Command freigeben.WebHome]]und [[//Ausführen// >>doc:ACMP.64.ACMP-Solutions.Client Commands.Client Command ausführen.WebHome]]durchlaufen, damit es verwendet werden kann. Erst danach können die Reg-Dateien importiert werden.
92
93 = Reg-Datei exportieren =
94
95 == Skript auswählen ==
96
97 1. Navigieren Sie ins Modul //Client Commands// > //Erstellen//.
98 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 Consolen- oder Clientskript handelt. In diesem Fall wählen Sie das Clientskript aus.
99
100 == **Command //Action Group// einfügen und anpassen** ==
101
102 1. Wählen Sie zunächst aus der Commandliste das Command //Miscellaneous// > //Action group //aus.
103 1. Öffnen Sie den Befehl per Doppelklick.
104 1. Geben Sie unter //Beschreibung der Aktion// einen Namen ein, wie z.B. „Reg-Schlüssel in Reg-Datei exportieren“.
105 1. Klicken Sie auf //OK//.
106
107 == **Command //Shell execute command// einfügen und bearbeiten** ==
108
109 1. Wählen Sie den Befehl //Processes and Shell// > //Shell execute command //aus der Commandliste aus.
110 Optional:  Beachten Sie, dass dieser Befehl unterhalb des vorherigen eingerückt sein sollte. Dies können Sie entweder über den Shortcut STRG + -> oder über die Pfeile in der Toolbar erreichen. 
111 1. Fügen Sie in den Tab //Allgemein// eine //Beschreibung der Aktion// ein, wie z.B. „Befehl ausführen“.
112 1. Wechseln Sie in den Tab //Details//.
113 1. Tragen Sie unter den Dateinamen die Reg-Datei ein, die für den Export verwendet werden soll, z.B. „reg.exe“.
114 1. Geben Sie für den Parameter den Wert //export //gemeinsam mit dem Pfad //HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Aagon\ACMP „C:\Temp\export.reg“ //ein. Der vollständige Parameter muss demnach wie folgt lauten: export HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Aagon\ACMP „C:\Temp\export.reg“.
115
116 {{figure}}
117 (% style="text-align:center" %)
118 [[image:64_Use Case_Client Command_Reg-Dateien_Shell execute command export_708.png]]
119
120 {{figureCaption}}
121 Angepasstes Shell execute command
122 {{/figureCaption}}
123 {{/figure}}
124
125 6. Bestätigen Sie Ihre Eingaben mit //OK//.
126
127 Nachdem Sie alle relevanten Bausteine für die Erstellung eines Exports für eine Reg-Datei eingefügt haben, sollte die Oberfläche des Client Command Editors wie folgt aussehen:
128
129 {{figure}}
130 (% style="text-align:center" %)
131 [[image:64_Client Command Use Case_Reg export_1350.png]]
132
133 {{figureCaption}}
134 Client Command-Editor: Reg-Datei exportieren
135 {{/figureCaption}}
136 {{/figure}}
137
138 Speichern Sie nun das Client Command ab, sollten Sie keine inhaltlichen Änderungen mehr vornehmen wollen.
139
140
141 == **Client Command-Phasen durchlaufen lassen** ==
142
143 Das Client Command muss abschließend die Phasen [[//Testen//>>doc:ACMP.64.ACMP-Solutions.Client Commands.Client Command testen.WebHome]], [[//Synchronisieren//>>doc:ACMP.64.ACMP-Solutions.Client Commands.Client Command synchronisieren.WebHome]], [[//Freigeben// >>doc:ACMP.64.ACMP-Solutions.Client Commands.Client Command freigeben.WebHome]]und [[//Ausführen// >>doc:ACMP.64.ACMP-Solutions.Client Commands.Client Command ausführen.WebHome]]durchlaufen, damit es verwendet werden kann. Erst danach können die Reg-Dateien exportiert werden.

Navigation

© Aagon GmbH 2024
Besuchen Sie unsere neue Aagon-Community