Uninstalling a MSI file

Last modified by Sabrina V. on 2024/10/08 11:35

Initial situation

In some 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.

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.

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.
  2. 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.

Select and edit the Uninstall MSI package Command

  1. Double click the Uninstall MSI Package (MSI) Command to load it into the Script.
  2. Under Product Information, click the Browse icon next to the product code.
    A new window will open.
  3. From the list of installed MSI packages, select the software you want to remove from the Clients.
    In this example, the software 7-Zip 22.01 (x64 Edition) is selected.

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.

Hinweis  Note:  

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

       6. Select Unattended under the display mode.
       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.
       8. Change to the Error Code tab.

Hinweis  Note:  

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.

       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.
     10. Optional: Switch to the General tab.
     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)".
     12. Click OK to close the Command.

65_Use Case Client Commands_Produktinformationen zum Deinstallieren eines MSI-Pakets.png

Product information on how to uninstall an MSI package

To insert and edit Run Client Task Command

  1. Select ACMP > Run Client Task from the Command List.
  2. Open the General tab.
  3. 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“.
  4. Return to the Details tab.
  5. 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.
  6. Click OK.

65_Use Case Client Commands_Software Scanner als geplante Aufgabe ausführen.png

Run Software scanner as a scheduled task

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

65_Use Case Client Commands_Client Command Editor MSI-Paket deinstallieren.png

Client Command Editor: Uninstall MSI Package

Client Command-Phasen durchlaufen lassen

The Client Commands must then go through the Test, Synchronize, Release and Execute phases before they can be used. During the execution of the Client Command, the 7-Zip software is uninstalled from the Clients.

 

© Aagon GmbH 2024
Besuchen Sie unsere neue Aagon-Community