Wiki-Quellcode von Deinstallation einer MSI-Datei
Zuletzt geändert von Sabrina V. am 2025/03/04 07:08
Verstecke letzte Bearbeiter
| author | version | line-number | content |
|---|---|---|---|
 |
1.1 | 1 | {{aagon.priorisierung}} |
| 2 | 160 | ||
| 3 | {{/aagon.priorisierung}} | ||
| 4 | |||
| 5 | {{aagon.floatingbox/}} | ||
| 6 | |||
| 7 | = Ausgangslage = | ||
| 8 | |||
| 9 | Manche Neuinstallationen benötigen eine Deinstallation älterer Programme, da ein hochpatchen nicht möglich ist. In diesem Fall kann es also vorkommen, dass Sie die bereits installierte Software wieder von den Clients entfernen müssen. Hier kommt es zu Gute, dass eine Deinstallation einer MSI-Datei in einem Client Command nur wenig Zeit in Anspruch nimmt. Sie benötigen lediglich eine eindeutige ID, die bereits von ACMP während des Inventarisierungsscans ausgelesen wurde und auf die Sie zugreifen können. Dadurch befindet sich der Eintrag schon in der Liste, die Sie nur noch aufrufen und auswählen müssen. | ||
| 10 | \\Dieser Anwendungsfall erklärt, wie Sie eine installierte Software wieder deinstallieren können. Thematisch knüpft der Fall an dem Use Case „Installation einer MSI-Datei“ an, weshalb das Beispiel fortgesetzt und das Datenkompressionsprogramm //7-Zip// deinstalliert wird. | ||
| 11 | \\Sollten Sie zu einem späteren Zeitpunkt ein anderes MSI-Paket deinstallieren wollen, können Sie dieses Beispiel als Vorlage nutzen und an den jeweiligen Stellen die Angaben austauschen. Gehen Sie wie folgt vor, um eine MSI-Datei zu deinstallieren: | ||
| 12 | |||
| 13 | == Skript auswählen == | ||
| 14 | |||
| 15 | 1. Navigieren Sie ins Modul //Client Commands// > //Erstellen//. | ||
| 16 | 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. | ||
| 17 | |||
| 18 | == Befehl**// Uninstall MSI package //auswählen und bearbeiten** == | ||
| 19 | |||
| 20 | 1. Laden Sie den Befehl //Uninstall MSI package //(MSI) in das Skript, indem Sie es per Doppelklick auswählen. | ||
| 21 | 1. Klicken Sie unter //Produktinformationen //auf das Durchsuchen Icon neben dem Produktcode. | ||
| 22 | Es öffnet sich ein neues Fenster. | ||
| 23 | 1. Wählen Sie aus der Liste der installierten MSI-Paketen die Software aus, die Sie von den Clients entfernen möchten. | ||
| 24 | In diesem Beispiel wird die Software //7-Zip 22.01 (x64 edition)// ausgewählt. | ||
| 25 | |||
| 26 | {{figure}} | ||
| |
4.1 | 27 | [[image:65_Use Case Client Commands_Deinstallation einer MSI Datei_Produktcode Suche_616.png||data-xwiki-image-style-alignment="center"]] |
| |
1.1 | 28 | |
| 29 | {{figureCaption}} | ||
| 30 | Produktcode Suche | ||
| 31 | {{/figureCaption}} | ||
| 32 | {{/figure}} | ||
| 33 | |||
| 34 | 4. Klicken Sie anschließend auf //OK//. | ||
| 35 | 5. Sie gelangen zurück ins vorherige Fenster, wo das Feld des Produktcodes ausgefüllt wurde. Hierbei handelt es sich um den intern hinterlegten Produktcode der 7-Zip Software. | ||
| 36 | |||
| 37 | {{aagon.infobox}} | ||
| 38 | Suchen Sie in Ihrer Umgebung nach dem passenden Produktcode für den Softeintrag und wählen Sie diesen aus. | ||
| 39 | {{/aagon.infobox}} | ||
| 40 | |||
| 41 | 6. Wählen Sie unter Anzeigemodus die Option //Unbeaufsichtigt //aus. | ||
| 42 | 7. Unter Optionen können Sie //Neustart unterdrücken// anhaken. Sollte für die Deinstallation ein Neustart nötig sein, wird dieser nicht direkt im Anschluss durchgeführt. | ||
| 43 | Hierdurch werden andere offene Programme oder Dateien nicht einfach geschlossen, ohne dass Sie diese abgespeichert haben. | ||
| 44 | 8. Wechseln Sie in den Tab //Fehlercode//. | ||
| 45 | |||
| 46 | {{aagon.infobox}} | ||
| |
9.1 | 47 | Möglicherweise könnte der Befehl in einen Fehler laufen, sollten Sie beispielsweise eine Software auswählen, die mehrfach in unterschiedlichen Versionsnummern bei Ihnen vorkommt. Wenn Sie in der Versionsnummer einen falschen Produktcode angeben, kann der Befehl nicht beendet werden. Es bietet sich demnach an, Fehlercodes einzufügen, die ignoriert werden sollen. Diese Fehlercodes sind von Microsoft fest definiert und können [[hier>>doc:ACMP.67.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Commandlist.MSI.WebHome||anchor="HMSIFehlercodes"]] nachgelesen werden |
| |
1.1 | 48 | {{/aagon.infobox}} |
| 49 | |||
| 50 | 9. Fügen Sie die Fehlercodes 1605 und 3010 untereinander ein, damit diese auf die Ausnahmeliste gesetzt werden, die bei der Abarbeitung des Befehls ignoriert werden. | ||
| 51 | 10. Optional: Wechseln Sie in den Tab //Allgemein//. | ||
| 52 | ~11. Optional: Ändern Sie die Beschreibung der Aktion, indem Sie beispielsweise zusätzlich noch die Namensbezeichnung hinzufügen, z.B. „MSI Paket (7-Zip 22.01 (x64 edition) deinstallieren“. | ||
| 53 | 12. Schließen Sie den Befehl mit //OK//. | ||
| 54 | |||
| 55 | {{figure}} | ||
| |
4.1 | 56 | [[image:65_Use Case Client Commands_Produktinformationen zum Deinstallieren eines MSI-Pakets.png||data-xwiki-image-style-alignment="center"]] |
| |
1.1 | 57 | |
| 58 | {{figureCaption}} | ||
| 59 | Produktinformationen zum Deinstallieren eines MSI-Pakets | ||
| 60 | {{/figureCaption}} | ||
| 61 | {{/figure}} | ||
| 62 | |||
| 63 | == Befehl **//Run Client Task //einfügen und editieren** == | ||
| 64 | |||
| 65 | 1. Wählen Sie den Befehl //ACMP// > //Run Client Task //aus der Commandliste aus. | ||
| 66 | 1. Öffnen Sie den //Allgemein //Tab. | ||
| 67 | 1. Fügen Sie unter //Beschreibung der Aktion //einen Namen ein. Es empfiehlt sich, den Namen des Scanners zu ergänzen, also z.B. „Software Scanner als geplante Aufgabe ausführen“ zu schreiben. | ||
| 68 | 1. Wechseln Sie zurück in den Tab //Details//. | ||
| 69 | 1. Wählen Sie unter //Als geplante Aufgabe ausführen// den //Software Scanner// aus. Hierdurch wird das System aktualisiert, die Software aus dem Inventar gelöscht und auch nicht mehr auf den Clients angezeigt. | ||
| 70 | 1. Klicken Sie auf //OK//. | ||
| 71 | |||
| 72 | {{figure}} | ||
| |
4.1 | 73 | [[image:65_Use Case Client Commands_Software Scanner als geplante Aufgabe ausführen.png||data-xwiki-image-style-alignment="center"]] |
| |
1.1 | 74 | |
| 75 | {{figureCaption}} | ||
| 76 | Software Scanner als geplante Aufgabe ausführen | ||
| 77 | {{/figureCaption}} | ||
| 78 | {{/figure}} | ||
| 79 | |||
| 80 | Als letzten Schritt müssen Sie Ihr Client Command im Editor abspeichern. | ||
| 81 | |||
| 82 | {{figure}} | ||
| |
4.1 | 83 | [[image:65_Use Case Client Commands_Client Command Editor MSI-Paket deinstallieren.png||data-xwiki-image-style-alignment="center"]] |
| |
1.1 | 84 | |
| 85 | {{figureCaption}} | ||
| 86 | Client Command-Editor: MSI-Paket deinstallieren | ||
| 87 | {{/figureCaption}} | ||
| 88 | {{/figure}} | ||
| 89 | |||
| 90 | == Client Command-Phasen durchlaufen lassen == | ||
| 91 | |||
| |
9.1 | 92 | Das Client Command muss abschließend die Phasen [[Testen>>doc:ACMP.67.ACMP-Solutions.Client Commands.Client Command testen.WebHome]], [[Synchronisieren>>doc:ACMP.67.ACMP-Solutions.Client Commands.Client Command synchronisieren.WebHome]], [[Freigeben>>doc:ACMP.67.ACMP-Solutions.Client Commands.Client Command freigeben.WebHome]] und [[Ausführen>>doc:ACMP.67.ACMP-Solutions.Client Commands.Client Command ausführen.WebHome]] durchlaufen, damit es verwendet werden kann. Bei der Ausführung des Client Commands wird die Software 7-Zip von den Clients deinstalliert. |