Uninstalling an MSI file

1

2

160

= Initial situation =

8

9

case, you may need to remove software that has already been installed from the Clients. This is where the fact that uninstalling an MSI file in a Client Command takes very little time comes in handy. All you need is an unique ID that has already been read by ACMP during the inventory scan and that you can access. This means that the entry is already in the list, which you just need to access and select.

10

11

This use case explains how to uninstall installed software. This use case is related to the "Installing an MSI file" use case, so we will continue with the example and uninstall the data compression utility 7-Zip.

12

13

If you want to uninstall a different MSI package at a later date, you can use this example as a template and replace the information where appropriate. To uninstall a MSI file, follow these steps:

== Select Script ==

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.

19

20

== **Select and edit the //Uninstall MSI package //Command** ==

21

22

1. Double click the //Uninstall MSI Package// (MSI) Command to load it into the Script.

23

1. Under //Product Information//, click the Browse icon next to the product code.

24

A new window will open.

25

1. From the list of installed MSI packages, select the software you want to remove from the Clients.

26

In this example, the software //7-Zip 22.01 (x64 Edition//) is selected.

27

28

29

(% style="text-align:center" %)

30

[[image:65_Use Case Client Commands_Deinstallation einer MSI Datei_Produktcode Suche_616.png]]

Find product code

4. Click //OK//.

5. You will be returned to the previous window where the product code field was filled in. This is the product code stored internally by the 7-Zip software.

39

40

41

Find and select the appropriate product code for soft entry in your environment.

42

43

44

6. Select //Unattended// under the display mode.

45

7. Under Options, you can select //Suppress restart//. If the uninstaller requires a reboot, it will not reboot immediately. This means that other open programs or files will not simply be closed without you having saved them.

46

8. Change to the //Error Code// tab.

47

48

49

It is possible that the Command may fail if, for example, you select software that exists in multiple versions. If you enter an incorrect product code in the version number, you will not be able to exit the Command. It is therefore advisable to include error codes that are to be ignored. These error codes are defined by Microsoft and can be found [[here>>doc:65.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Commandlist.MSI.WebHome||anchor="HMSIFehlercodes"]].

50

51

52

9. Insert error codes 1605 and 3010 one below the other so that they are added to the list of exceptions that will be ignored when the command is processed.

53

10. Optional: Switch to the //General// tab.

54

~11. Optional: Change the description of the action, for example by adding the name, e.g. "Uninstall MSI package (7-Zip 22.01 (x64 edition)".

55

12. Click //OK// to close the Command.

56

57

58

(% style="text-align:center" %)

59

[[image:65_Use Case Client Commands_Produktinformationen zum Deinstallieren eines MSI-Pakets.png]]

60

61

62

Product information on how to uninstall an MSI package

== To insert and edit **//Run Client Task //Command** ==

67

68

1. Select //ACMP// > //Run Client Task// from the Command List.

69

1. Open the //General// tab.

70

1. In the //Description of actions// box, enter a name. It is recommended that you add the name of the scanner, e.g. „Run software scanner as a scheduled task“.

71

1. Return to the //Details// tab.

72

1. Under //Run as a scheduled task//, select the software scanner. This will update the system, delete the software from the inventory and it will no longer appear on the Clients.

1. Click //OK//.

(% style="text-align:center" %)

77

[[image:65_Use Case Client Commands_Software Scanner als geplante Aufgabe ausführen.png]]

78

79

80

Run Software scanner as a scheduled task

The final step is to save your Client Commands in the Editor.

85

86

87

(% style="text-align:center" %)

88

[[image:65_Use Case Client Commands_Client Command Editor MSI-Paket deinstallieren.png]]

89

90

91

Client Command Editor: Uninstall MSI Package

== Client Command-Phasen durchlaufen lassen ==

96

97

The Client Commands must then go through the [[Test>>doc:ACMP.65.ACMP-Solutions.Client Commands.Client Command testen.WebHome]], [[Synchronize>>doc:ACMP.65.ACMP-Solutions.Client Commands.Client Command synchronisieren.WebHome]], [[Release>>doc:ACMP.65.ACMP-Solutions.Client Commands.Client Command freigeben.WebHome]] and [[Execute>>doc:ACMP.65.ACMP-Solutions.Client Commands.Client Command ausführen.WebHome]] phases before they can be used. During the execution of the Client Command, the 7-Zip software is uninstalled from the Clients.

Wiki source code of Deinstallation einer MSI-Datei

Navigation

author	version	line-number	content
		1	{{aagon.priorisierung}}
		2	160
		3	{{/aagon.priorisierung}}
		4
		5	{{aagon.floatingbox/}}
		6
		7	= Initial situation =
		8
		9	case, you may need to remove software that has already been installed from the Clients. This is where the fact that uninstalling an MSI file in a Client Command takes very little time comes in handy. All you need is an unique ID that has already been read by ACMP during the inventory scan and that you can access. This means that the entry is already in the list, which you just need to access and select.
		10
		11	This use case explains how to uninstall installed software. This use case is related to the "Installing an MSI file" use case, so we will continue with the example and uninstall the data compression utility 7-Zip.
		12
		13	If you want to uninstall a different MSI package at a later date, you can use this example as a template and replace the information where appropriate. To uninstall a MSI file, follow these steps:
		14
		15	== Select Script ==
		16
		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.
		19
		20	== Select and edit the //Uninstall MSI package //Command ==
		21
		22	1. Double click the //Uninstall MSI Package// (MSI) Command to load it into the Script.
		23	1. Under //Product Information//, click the Browse icon next to the product code.
		24	A new window will open.
		25	1. From the list of installed MSI packages, select the software you want to remove from the Clients.
		26	In this example, the software //7-Zip 22.01 (x64 Edition//) is selected.
		27
		28	{{figure}}
		29	(% style="text-align:center" %)
		30	[[image:65_Use Case Client Commands_Deinstallation einer MSI Datei_Produktcode Suche_616.png]]
		31
		32	{{figureCaption}}
		33	Find product code
		34	{{/figureCaption}}
		35	{{/figure}}
		36
		37	4. Click //OK//.
		38	5. You will be returned to the previous window where the product code field was filled in. This is the product code stored internally by the 7-Zip software.
		39
		40	{{aagon.infobox}}
		41	Find and select the appropriate product code for soft entry in your environment.
		42	{{/aagon.infobox}}
		43
		44	6. Select //Unattended// under the display mode.
		45	7. Under Options, you can select //Suppress restart//. If the uninstaller requires a reboot, it will not reboot immediately. This means that other open programs or files will not simply be closed without you having saved them.
		46	8. Change to the //Error Code// tab.
		47
		48	{{aagon.infobox}}
		49	It is possible that the Command may fail if, for example, you select software that exists in multiple versions. If you enter an incorrect product code in the version number, you will not be able to exit the Command. It is therefore advisable to include error codes that are to be ignored. These error codes are defined by Microsoft and can be found [[here>>doc:65.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Commandlist.MSI.WebHome\|\|anchor="HMSIFehlercodes"]].
		50	{{/aagon.infobox}}
		51
		52	9. Insert error codes 1605 and 3010 one below the other so that they are added to the list of exceptions that will be ignored when the command is processed.
		53	10. Optional: Switch to the //General// tab.
		54	~11. Optional: Change the description of the action, for example by adding the name, e.g. "Uninstall MSI package (7-Zip 22.01 (x64 edition)".
		55	12. Click //OK// to close the Command.
		56
		57	{{figure}}
		58	(% style="text-align:center" %)
		59	[[image:65_Use Case Client Commands_Produktinformationen zum Deinstallieren eines MSI-Pakets.png]]
		60
		61	{{figureCaption}}
		62	Product information on how to uninstall an MSI package
		63	{{/figureCaption}}
		64	{{/figure}}
		65
		66	== To insert and edit //Run Client Task //Command ==
		67
		68	1. Select //ACMP// > //Run Client Task// from the Command List.
		69	1. Open the //General// tab.
		70	1. In the //Description of actions// box, enter a name. It is recommended that you add the name of the scanner, e.g. „Run software scanner as a scheduled task“.
		71	1. Return to the //Details// tab.
		72	1. Under //Run as a scheduled task//, select the software scanner. This will update the system, delete the software from the inventory and it will no longer appear on the Clients.
		73	1. Click //OK//.
		74
		75	{{figure}}
		76	(% style="text-align:center" %)
		77	[[image:65_Use Case Client Commands_Software Scanner als geplante Aufgabe ausführen.png]]
		78
		79	{{figureCaption}}
		80	Run Software scanner as a scheduled task
		81	{{/figureCaption}}
		82	{{/figure}}
		83
		84	The final step is to save your Client Commands in the Editor.
		85
		86	{{figure}}
		87	(% style="text-align:center" %)
		88	[[image:65_Use Case Client Commands_Client Command Editor MSI-Paket deinstallieren.png]]
		89
		90	{{figureCaption}}
		91	Client Command Editor: Uninstall MSI Package
		92	{{/figureCaption}}
		93	{{/figure}}
		94
		95	== Client Command-Phasen durchlaufen lassen ==
		96
		97	The Client Commands must then go through the [[Test>>doc:ACMP.65.ACMP-Solutions.Client Commands.Client Command testen.WebHome]], [[Synchronize>>doc:ACMP.65.ACMP-Solutions.Client Commands.Client Command synchronisieren.WebHome]], [[Release>>doc:ACMP.65.ACMP-Solutions.Client Commands.Client Command freigeben.WebHome]] and [[Execute>>doc:ACMP.65.ACMP-Solutions.Client Commands.Client Command ausführen.WebHome]] phases before they can be used. During the execution of the Client Command, the 7-Zip software is uninstalled from the Clients.