Show-ADTInstallationWelcome

Erzeugt einen Willkommensdialog, der den Benutzer mit Informationen über die anstehende Installationen und Aktionen, die vor Beginn der Installation durchgeführt werden müssen, versorgt. In den Optionen definieren Sie zu schließende Applikationen und entscheiden, wie sich diese beim und nach dem Schließen verhalten sollen. Weiterhin legen Sie fest ob, ein Aufschub der Installation für eine bestimmte Anzahl von Versuchen, Tagen oder bis zu einem bestimmten Enddatum möglich ist.

Dieser Befehl bildet die Funktion 'Show-InstallationWelcome' aus dem PowerShell App Deployment Toolkit ab.


Befehlseingaben:

  • Zu schließende Anwendungen (als kommagetrennte Liste)
    Gibt eine kommagetrennte Liste von Applikationen an, die durch den Dialog beendet werden. Der Name der zu beendenden Prozesse wird ohne die Dateiendung (z.B. .exe) angegeben. Weiterhin kann eine benutzerdefinierte Beschreibung der Prozesse durch folgende Syntax angegeben werden: winword=Microsoft Office Word,chrome=Google Chrome Browser
  • Den Benutzer zum Speichern seiner Dokumente auffordern
    Gibt an, ob der Benutzer zum Speichern seiner Arbeitsdokumente aufgefordert wird sofern er sich entscheidet, alle Anwendungen durch Auswahl der Schaltfläche "Programme schließen" zu beenden.
  • Neustart der Anwendungen verhindern
    Verhindert das erneute Starten der unter "Zu schließende Anwendungen" angegebenen Prozesse und Anwendungen durch den Benutzer.
  • Anwendung nach Countdown schließen
    Ermöglicht die Anzeige eines Countdowns in Sekunden, bis die angegebenen Anwendungen automatisch geschlossen werden. Diese Option wird nur wirksam sofern ein Aufschub nicht erlaubt oder der dafür definierte Wert abgelaufen ist.
  • Aufschieben erlauben
    Bestimmt, ob ein Aufschieben der Installation durch den Benutzer möglich ist. Die folgenden Optionen zum Aufschieben sind verfügbar: 
    • Wenn zu schließende Anwendungen laufen
      Ermöglicht die Installation nur aufzuschieben, sofern Applikationen laufen, die geschlossen werden müssen.
    • Anzahl erlaubter Aufschiebungen
      Gibt an, wie oft die Installation aufgeschoben werden kann.
    • Anzahl der Tage, um die aufgeschoben werden darf
      Beschreibt die Anzahl der Tage seit der ersten Ausführung, um die die Installation aufgeschoben werden kann.
    • Aufschieben bis
      Gibt den Stichtag an, bis zu dem die Installation aufgeschoben werden kann.
  • Speicherplatz überprüfen
    Gibt an, ob eine Überprüfung auf ausreichend verfügbaren Speicherplatz für die Installation erfolgen soll. Falls der benötigte Speicherplatz in Megabyte (MB) nicht angegeben ist, wird dieser automatisch anhand der Größe der Paketdateien berechnet.
  • Alle Fenster minimieren, wenn diese Meldung angezeigt wird
    Legt fest, ob andere Fenster bei der Anzeige der Meldung automatisch minimiert werden sollen.
  • Immer im Vordergrund
    Definiert, dass das Fenster im Vordergrund erscheint und somit durchgängig sichtbar ist, unabhängig von anderen geöffneten Fenstern.

Hinweis: Wenn ein Paket über den Show-ADTInstallationWelcome-Befehl zurückgestellt wird und sich daher beendet, wird das Script mit dem Returncode 60012 verlassen.


Beispiel:

Das nachfolgende Beispiel erstellt einen Willkommensdialog, der eine Installation mit einer maximalen Verzögerung von 7 Tagen ermöglicht. Dabei wird überprüft ob Microsoft Office Prozesse existieren, und der Benutzer darauf hingewiesen, diese zu schließen. Beim Schließen der Anwendungen wird der Benutzer aufgefordert, seine Dokumente zu speichern. Der erstellte Dialog wird im Vordergrund angezeigt, wobei alle anderen Fenster minimiert werden, sobald der Dialog erscheint.


Entspricht ADT Funktion:


Siehe auch: