Start-ADTMsiProcess (MSI, MSP,.) - Assistenten - ADTMSiProcess-Assistenten
Start-ADTMsiProcess (MSI, MSP,.) - Assistenten - ADTMSiProcess-Assistenten
Der ADTMSiProcess-Assistent dient zur komfortablen Erstellung von Aufrufen für die Funktion Start-ADTMSiProcess innerhalb eines PSADT-Setups.
Die grafische Oberfläche ermöglicht die Konfiguration aller relevanten MSI-Parameter, ohne die vollständige Befehlszeile manuell erstellen zu müssen.
Parameter
Die folgenden Parameter stehen zur Verfügung.
PSADT-Parameter: -Action
Definiert die MSI-Operation, die durch den Windows Installer ausgeführt werden soll.
Die Aktion bestimmt, ob eine Anwendung installiert, deinstalliert, repariert oder mit einem Patch aktualisiert wird.
Dieser Parameter steuert das grundlegende Verhalten des gesamten Prozesses.
Mögliche Werte:
- Install
- Uninstall
- Patch
- Repair
- ActiveSetup
|
|
Beispiel: -Action Install |
Dateipfad
Gibt den vollständigen Pfad zur MSI- oder MSP-Datei an, die verarbeitet werden soll.
Der Pfad kann direkt angegeben oder über PSADT-Variablen dynamisch aufgebaut werden.
Ohne einen gültigen Dateipfad kann keine Installation oder Wartungsoperation ausgeführt werden.
Über das Kontextmenü des Eingabefelds stehen vordefinierte Standardpfade sowie automatisch gefundene Dateien als Auswahloptionen zur Verfügung.
Die ausgewählten Einträge werden direkt in das Eingabefeld übernommen.
|
|
Beispiel: -FilePath "${adtSession.DirFiles}\7z2602-x64.msi" |
Transformationen
Legt eine oder mehrere MST-Dateien fest, die während der MSI-Installation angewendet werden.
Transformationen ermöglichen die Anpassung von MSI-Einstellungen wie Sprache, Installationsoptionen oder Unternehmensvorgaben, ohne das ursprüngliche MSI-Paket verändern zu müssen.
Über das Kontextmenü des Eingabefelds stehen vordefinierte Standardpfade sowie automatisch gefundene Dateien als Auswahloptionen zur Verfügung.
Die ausgewählten Einträge werden direkt in das Eingabefeld übernommen.
|
|
Beispiel: -Transform "${adtSession.DirFiles}\7-ZIP-x64.mst" |
Mehrere Transformationen:
|
|
Beispiel: -Transform @( "${adtSession.DirFiles}\Deutsch.mst", "${adtSession.DirFiles}\Firmenstandard.mst" ) |
Argumentliste
PSADT-Parameter: -ArgumentList
Übergibt zusätzliche Befehlszeilenparameter an den Windows Installer.
Darüber lassen sich beispielsweise die Benutzeroberfläche, das Neustartverhalten oder produktspezifische Eigenschaften steuern.
Über das Kontextmenü des Eingabefelds stehen vordefinierte Standardparameter zur Verfügung.
Ausgewählte Einträge werden direkt in das Eingabefeld übernommen.
Zusätzlich können MSI-Argumente über den MSI-Parameter-Assistenten ausgewählt und in die Argumentliste eingefügt werden.
|
|
Beispiel: -ArgumentList '/qn /norestart' |
Erfolgreiche Exit-Codes
PSADT-Parameter: -SuccessExitCodes
Definiert, welche Rückgabecodes als erfolgreiche Ausführung gewertet werden sollen.
Dies ist besonders nützlich, wenn Installationen herstellerspezifische Exit-Codes zurückgeben, die zwar erfolgreich sind, aber vom Standard abweichen.
Über das Kontextmenü des Eingabefelds stehen vordefinierte Standardparameter zur Verfügung.
Ausgewählte Einträge werden direkt in das Eingabefeld übernommen.
|
|
Beispiel: -SuccessExitCodes @(0, 3010, 1641) |
Sichere Argumentliste
PSADT-Parameter: -SecureArgumentList
Verhindert die Ausgabe sensibler Parameter im PSADT-Protokoll.
Dadurch werden beispielsweise Kennwörter oder Zugriffstoken vor unbeabsichtigter Offenlegung geschützt.
|
|
Beispiel: -SecureArgumentList -ArgumentList 'PASSWORD=GeheimesKennwort' |
Arbeitsverzeichnis
PSADT-Parameter: -WorkingDirectory
Legt das Verzeichnis fest, aus dem der Installationsprozess gestartet wird. Dies ist hilfreich, wenn die Installation Dateien über relative Pfadangaben referenziert.
Über das Kontextmenü des Eingabefelds stehen vordefinierte Standardpfade zur Verfügung.
Die ausgewählten Einträge werden direkt in das Eingabefeld übernommen.
|
|
Beispiel: -WorkingDirectory "$($adtSession.DirFiles)" |
Zusätzliche Argumentliste
PSADT-Parameter: -AdditionalArgumentList
Erweitert die automatisch erzeugten MSI-Parameter um zusätzliche Eigenschaften. Dies wird häufig genutzt, um produktspezifische MSI-Einstellungen zu übergeben.
|
|
Beispiel: -AdditionalArgumentList 'ALLUSERS=1' |
Weiteres Beispiel:
|
|
Beispiel: -AdditionalArgumentList 'INSTALLDIR=C:\Programme\7-Zip' |
Patches
Installiert einen oder mehrere MSP-Patches zusammen mit einer MSI-Installation.
Dadurch können Updates oder Hotfixes direkt während der Installation eingebunden werden.
|
|
Beispiel: -Patch "${adtSession.DirFiles}\Update.msp" |
Mehrere Patches:
|
|
Beispiel: -Patch @( "${adtSession.DirFiles}\Update1.msp", "${adtSession.DirFiles}\Hotfix1.msp" ) |
Umgebungsvariablen erweitern
PSADT-Parameter: -ExpandEnvironmentVariables
Löst Umgebungsvariablen innerhalb von Pfaden oder Argumenten automatisch auf.
Dadurch können flexibel unterschiedliche Zielsysteme unterstützt werden.
Protokollierungsoptionen
PSADT-Parameter: -LoggingOptions
Steuert die Detailtiefe der vom Windows Installer erzeugten Logdatei.
Umfangreiche Logging-Optionen erleichtern die Fehleranalyse bei Installationsproblemen.
|
|
Beispiel: -LoggingOptions '*vx' |
Protokoll-Dateiname
Definiert einen benutzerdefinierten Dateinamen für die MSI-Protokollierung. Dies erleichtert die Zuordnung von Logdateien bei mehreren Installationen.
|
|
Beispiel: -LogFileName '7Zip_Install.log' |
Reparaturmodus
Bestimmt, welche Reparaturoptionen bei einer MSI-Reparatur verwendet werden.
Damit kann gesteuert werden, ob beispielsweise nur Dateien geprüft oder zusätzlich Registrierungseinträge und Verknüpfungen wiederhergestellt werden.
|
|
Beispiel: -Action Repair -RepairMode FileMissing |
Reparatur aus Quelle
PSADT-Parameter: -RepairFromSource
Erzwingt die Wiederherstellung der Installation aus den ursprünglichen Installationsquellen.
Dadurch können beschädigte oder fehlende Dateien vollständig neu installiert werden.
|
|
Beispiel: -Action Repair -RepairFromSource |
MSI-Prüfung überspringen
PSADT-Parameter: -SkipMSIAlreadyInstalledCheck
Überspringt die Prüfung, ob das MSI bereits installiert ist.
Diese Option eignet sich für Sonderfälle oder für gezielte Neuinstallationen.
|
|
Beispiel: -SkipMSIAlreadyInstalledCheck |
Updates und Hotfixes einbeziehen
PSADT-Parameter: -IncludeUpdatesAndHotfixes
Berücksichtigt installierte MSP-Updates und Hotfixes bei MSI-Abfragen.
Dadurch werden auch aktualisierte Produktstände korrekt ausgewertet.
|
|
Beispiel: -IncludeUpdatesAndHotfixes |
Neustart-Exit-Codes
PSADT-Parameter: -RebootExitCodes
Definiert Rückgabecodes, die einen erforderlichen Neustart kennzeichnen.
Diese Codes können vom Deployment-System gesondert verarbeitet werden.
Über das Kontextmenü des Eingabefelds stehen vordefinierte Standardparameter zur Verfügung.
Ausgewählte Einträge werden direkt in das Eingabefeld übernommen.
|
|
Beispiel: -RebootExitCodes @(3010, 1641) |
Exit-Codes ignorieren
PSADT-Parameter: -IgnoreExitCodes
Bestimmt Rückgabecodes, die nicht als Fehler gewertet werden sollen.
Dadurch können bekannte und akzeptierte Rückmeldungen einer Installation ignoriert werden.
Über das Kontextmenü des Eingabefelds stehen vordefinierte Standardparameter zur Verfügung.
Ausgewählte Einträge werden direkt in das Eingabefeld übernommen.
|
|
Beispiel: -IgnoreExitCodes @(1605) |
Prioritätsklasse
PSADT-Parameter: -PriorityClass
Legt die Priorität des gestarteten MSI-Prozesses fest.
Eine niedrigere Priorität reduziert die Systembelastung, während höhere Prioritäten die Ausführung beschleunigen können.
|
|
Beispiel: -PriorityClass BelowNormal |
Weitere Werte:
- Idle
- BelowNormal
- Normal
- AboveNormal
- High
- RealTime
Bei Prozessfehler beenden
PSADT-Parameter: -ExitOnProcessFailure
Beendet das Deployment unmittelbar, wenn der MSI-Prozess einen Fehler zurückgibt.
Dadurch wird verhindert, dass nachgelagerte Installationsschritte trotz Fehler fortgesetzt werden.
|
|
Beispiel: -ExitOnProcessFailure |
Keine Desktop-Aktualisierung
Unterdrückt die Aktualisierung von Desktop, Startmenü und Explorer nach Abschluss der Installation.
Dadurch können insbesondere bei Masseninstallationen unnötige Systemaktualisierungen vermieden werden.
|
|
Beispiel: -NoRefresh |
PassThru
Gibt das vollständige Ergebnisobjekt der Funktion zurück.
Dadurch können Exit-Codes, Ausführungsinformationen und weitere Eigenschaften für individuelle Auswertungen verwendet werden.
Generierung des Befehls
Nach Abschluss der Konfiguration erzeugt der Assistent den vollständigen Aufruf von Start-ADTMSiProcess.
Dadurch wird eine konsistente und fehlerfreie Erstellung von MSI-Installationsbefehlen innerhalb von PSADT-Paketen gewährleistet.
Die automatische Befehlsgenerierung reduziert den manuellen Aufwand, vereinfacht die Pflege von Paketskripten und unterstützt eine standardisierte Umsetzung von Softwareinstallationen innerhalb der Paketierungsumgebung.