Last modified by Jannis Klein on 2024/08/13 08:28

Hide last authors
Jannis Klein 1.1 1 {{aagon.priorisierung}}
2 160
3 {{/aagon.priorisierung}}
4
5 {{aagon.floatingbox/}}
6
Sabrina V. 2.1 7 = Initial situation =
Jannis Klein 1.1 8
Sabrina V. 2.1 9 If you want to remove a registry key or value from one of your Clients, you need to find it specifically. This can be difficult if you do not know which Clients the value or key was set on in the past.  To avoid this problem, you can create a Client Command that checks whether such a value or key is generally available on the Client that you want to optionally remove.
Jannis Klein 1.1 10
Sabrina V. 2.1 11 This use case explains how to check whether a particular registry key or value exists and how to remove it in the Command. Both sections can be used independently. Proceed as follows:
Jannis Klein 1.1 12
Sabrina V. 2.1 13 = Remove registry key =
Jannis Klein 1.1 14
Sabrina V. 2.1 15 == Select Script ==
Jannis Klein 1.1 16
Sabrina V. 2.1 17 1. Navigate to the //Client Commands// > //Create// module.
18 1. Click //Add //on the ribbon bar. The Client Command Editor will open and you will need to decide whether it is a Console or Client Script. In this case select Client Script.
Jannis Klein 1.1 19
Sabrina V. 2.1 20 == **Adding and customising the //If registry key (not) exists //Command** ==
Jannis Klein 1.1 21
Sabrina V. 2.1 22 1. Select the //Condition// > //If registry key (not) exists// Command from the Command List.
23 1. Double click to open the Command.
24 1. In the //Details// tab, under Commands, select //If key exists//.
25 1. Under Registry, ensure that //HKEY_LOCAL_MACHINE// is selected under the root key.{{aagon.infobox}}The root key specifies the folder path where the registry key is located. {{/aagon.infobox}}
26 1. Enter the value you want to check under the key. You can either enter this key manually or search for it using the icon on the pages. In this example, the //ACMP Web Interface// is used as the key (\SOFTWARE\WOW6432Node\Aagon\ACMP Web Interfaces).
27 1. Click //OK// when you are done.
28 The first line of the Command appears.
29
Jannis Klein 1.1 30 {{figure}}
31 (% style="text-align:center" %)
32 [[image:642_Use Case Client Command_Wenn Registryschlüssel (nicht) existiert_538.png]]
33
34 {{figureCaption}}
Sabrina V. 2.1 35 Customised Command //If registry key (not) exists//
Jannis Klein 1.1 36 {{/figureCaption}}
37 {{/figure}}
38
Sabrina V. 2.1 39 == Select and edit the //Delete registry key or value //Command ==
Jannis Klein 1.1 40
Sabrina V. 2.1 41 1. Navigate back to the Command List and double click //Registry// > //Delete registry key or value//.
42 1. Select the //Details //tab.
43 1. Select //HKEY_LOCAL_MACHINE //under the root key.
44 1. Type the value you want to delete under the key. You can either enter this key manually or search for it using the icon on the pages. In this example, the //ACMP Web Interface// is used as the key (\SOFTWARE\WOW6432Node\Aagon\ACMP Web Interfaces).
45 1. Activate the //Delete key// combo box under //Actions//. This is the only way to execute the Command correctly, as it removes the entire registry key.
46 1. Click //OK// to display the Command in line 2.{{aagon.infobox}}ndent this Command either using the quick selection bar or the shortcut CTRL + -> so that it appears below the first Command (If the registry key (not) exists). When adding this Command, you can also simply drag the Command onto the line of the previous Command so that it is properly integrated.{{/aagon.infobox}}
47 1. Save the Client Commands if you do not wish to make any further changes to the content.
Jannis Klein 1.1 48
49 {{figure}}
50 (% style="text-align:center" %)
51 [[image:642_Use Case Client Command_Registryschlüssel oder Wert löschen_518.png]]
52
53 {{figureCaption}}
Sabrina V. 2.1 54 Custom Command //Delete registry key or value//
Jannis Klein 1.1 55 {{/figureCaption}}
56 {{/figure}}
57
Sabrina V. 2.1 58 At this point the Client Command is complete and can be used if you wish to delete registry keys. Save the Command and continue with the Client Command phases.
Jannis Klein 1.1 59
60 {{figure}}
61 (% style="text-align:center" %)
62 [[image:65_Use Case Client Command_Registrykey entfernen_1661.png||alt="642_Use Case Client Command_Registrykey entfernen_1661.png"]]
63
64 {{figureCaption}}
Sabrina V. 2.1 65 Client Command Editor: Identifying and removing registry keys
Jannis Klein 1.1 66 {{/figureCaption}}
67 {{/figure}}
68
Sabrina V. 2.1 69 == Running through the Client Command phases ==
Jannis Klein 1.1 70
Sabrina V. 2.1 71 Finally, the Client Command must go through the [[Test>>doc:ACMP.65.ACMP-Solutions.Client Commands.Client Command testen.WebHome]], [[Synchronise>>doc:ACMP.66.ACMP-Solutions.Client Commands.Client Command synchronisieren.WebHome]], [[Release>>doc:ACMP.66.ACMP-Solutions.Client Commands.Client Command freigeben.WebHome]] and [[Execute>>doc:ACMP.66.ACMP-Solutions.Client Commands.Client Command ausführen.WebHome]] phases before it can be used. Only then will it check that the registry key exists on your Clients, so that it can be deleted at the same time.
Jannis Klein 1.1 72
Sabrina V. 2.1 73 = Remove registry value =
Jannis Klein 1.1 74
Sabrina V. 2.1 75 == Select Script ==
Jannis Klein 1.1 76
Sabrina V. 2.1 77 1. Navigate to the //Client Commands// > //Create// module.
78 1. Click //Add //on the ribbon bar. The Client Command Editor will open and you will need to decide whether it is a Console or Client Script. In this case select Client Script.
Jannis Klein 1.1 79
Sabrina V. 2.1 80 == Adding and customise the Command //If registry value name (not) exists// ==
Jannis Klein 1.1 81
Sabrina V. 2.1 82 1. First select the //Condition// > //If registry value name (not) exists// Command from the Command List.
83 1. Double click to open the Command.
84 1. Select //If value name exists //under the //Details //tab.
85 1. Select the //HKEY_LOCAL_MACHINE// root key in the registry, if it is not already selected.{{aagon.infobox}}The root key specifies the folder path where the registry value is to be found. {{/aagon.infobox}}
86 1. Enter the key where the value to be deleted is located. In this example, //ACMP// is used (\SOFTWARE\WOW6432Node\Aagon\ACMP).
87 1. Enter the name of the value. If you know the name of the value, you can either type it manually or look it up using the icon on the page. In this case it will be //ActiveLevel//.
88 1. Click //OK// when finished.
89 The first line of the Command appears.
Jannis Klein 1.1 90
91 {{figure}}
92 (% style="text-align:center" %)
93 [[image:642_Use Case Client Command_Wenn Registry Wertename (nicht) exisitiert_484.png]]
94
95 {{figureCaption}}
Sabrina V. 2.1 96 Customised Command //If registry value name (not) exists//
Jannis Klein 1.1 97 {{/figureCaption}}
98 {{/figure}}
99
Sabrina V. 2.1 100 == Select and edit //Delete registry key or value //Command ==
Jannis Klein 1.1 101
Sabrina V. 2.1 102 1. Navigate back to the Command List and double click the //Registry// > //Delete registry key or value// Command.{{aagon.infobox}}Indent this Command either using the quick selection bar or the CTRL + -> shortcut so that it appears below the first Command (If the registry key (not) exists). When adding this Command, you can also simply drag the Command onto the line of the previous Command so that it is properly integrated.{{/aagon.infobox}}
103 1. Select the //Details// tab.
104 1. Select //HKEY_LOCAL_MACHINE// under the root key, if this has not already been done.
105 1. Enter the value you want to delete under the key. The key should be //ACMP// (\SOFTWARE\WOW6432Node\Aagon\ACMP).
106 1. Insert the name of the value. Either type it in manually or look it up using the icon on the pages. In this case it will be //ActiveLevel//.
107 1. Activate the //Delete Value// combo box under //Actions//. You need to do this to delete the value from the registry.
108 1. Click //OK// to display the Command in second row.
109 1. Save the Client Commands if you do not want to make any further changes to the content.
Jannis Klein 1.1 110
111 {{figure}}
112 (% style="text-align:center" %)
113 [[image:642_Use Case Client Command_Registryschlüssel oder Wert löschen (Registrywert löschen)_496.png]]
114
115 {{figureCaption}}
Sabrina V. 2.1 116 Custom Command //Delete registry key or value//
Jannis Klein 1.1 117 {{/figureCaption}}
118 {{/figure}}
119
Sabrina V. 2.1 120 The two Commands now allow you to check that the relevant registry value exists and also to remove it. Save the Command and proceed to the Client Commands phases.
Jannis Klein 1.1 121
122 {{figure}}
123 (% style="text-align:center" %)
124 [[image:65_Use Case Client Command_Registrywert entfernen_1661.png||alt="642_Use Case Client Command_Registrywert entfernen_1661.png"]]
125
126 {{figureCaption}}
Sabrina V. 2.1 127 Client Command Editor: Find and remove registry value
Jannis Klein 1.1 128 {{/figureCaption}}
129 {{/figure}}
130
Sabrina V. 2.1 131 == Running through the Client Command phases ==
Jannis Klein 1.1 132
Sabrina V. 2.1 133 Finally, the Client Command must go through the [[Test>>doc:ACMP.65.ACMP-Solutions.Client Commands.Client Command testen.WebHome]], [[Synchronise>>doc:ACMP.66.ACMP-Solutions.Client Commands.Client Command synchronisieren.WebHome]], [[Release>>doc:ACMP.66.ACMP-Solutions.Client Commands.Client Command freigeben.WebHome]] and [[Execute>>doc:ACMP.66.ACMP-Solutions.Client Commands.Client Command ausführen.WebHome]] phases before it can be used. Only when the Client Command has been released can it be deployed in Containers or directly to Clients.
© Aagon GmbH 2025
Besuchen Sie unsere neue Aagon-Community