Show-ADTInstallationWelcome
|
PackageDeployment Modul Hilfe |
Package Deployment Module (DSM eScript Commands) |
|
Show-ADTInstallationWelcome Cmdlet |
Version 4.0.0.5 |
Show-ADTInstallationWelcome
Übersicht
Zeigen Sie einen Begrüßungsdialog an, in dem der Benutzer Informationen über die Installation und die vor Beginn der Installation auszuführenden Aktionen erhält.
Syntax
Show-ADTInstallationWelcome [-CloseApps <String>] [-CloseAppsCountdown <Int32>] [-Context <String>] [-DeferDays <Int32>] [-DeferDeadline <String>] [-DeferTimes <Int32>] [-ForceCloseAppsCountdown <Int32>] [-ForceCountdown <Int32>] [-MinimizeWindows <Boolean>] [-TopMost <Boolean>] [-AllowDefer] [-AllowDeferCloseApps] [-BlockExecution] [-CustomText] [-PersistPrompt] [-PromptToSave] [-Silent] [<CommonParameters>]
Show-ADTInstallationWelcome -CheckDiskSpace [-CloseApps <String>] [-CloseAppsCountdown <Int32>] [-Context <String>] [-DeferDays <Int32>] [-DeferDeadline <String>] [-DeferTimes <Int32>] [-ForceCloseAppsCountdown <Int32>] [-ForceCountdown <Int32>] [-MinimizeWindows <Boolean>] [-RequiredDiskSpace <Int32>] [-TopMost <Boolean>] [-AllowDefer] [-AllowDeferCloseApps] [-BlockExecution] [-CustomText] [-PersistPrompt] [-PromptToSave] [-Silent] [<CommonParameters>]
Beschreibung
Die folgenden Eingabeaufforderungen können in den Begrüßungsdialog aufgenommen werden:
- Schließen Sie die angegebenen laufenden Anwendungen, oder schließen Sie optional die Anwendungen, ohne eine Aufforderung anzuzeigen (mit dem Schalter -Silent).
- Verschieben Sie die Installation eine bestimmte Anzahl von Malen, für eine bestimmte Anzahl von Tagen oder bis zum Erreichen einer bestimmten Frist.
- Countdown bis zum automatischen Schließen der Anwendungen.
- Verhindern, dass Benutzer die angegebenen Anwendungen starten, während die Installation läuft.
Anmerkungen:
Die Prozessbeschreibungen werden von WMI abgerufen, wobei auf den Prozessnamen zurückgegriffen wird, wenn keine Beschreibung verfügbar ist. Alternativ können Sie die Beschreibung auch selbst mit einem '='-Symbol angeben - siehe Beispiele.
Das Dialogfeld wird nach der in der XML-Konfigurationsdatei angegebenen Zeitspanne (standardmäßig 1 Stunde und 55 Minuten) beendet, um zu verhindern, dass SCCM-Installationen eine Zeitüberschreitung verursachen und einen Fehlercode an SCCM zurückgeben. Wenn das Dialogfeld eine Zeitüberschreitung aufweist, wird das Skript beendet und ein Code 1618 (SCCM-Schnellwiederholungscode) zurückgegeben.
Parameter
|
-AllowDefer <SwitchParameter> |
||||||
|
Aktiviert eine optionale Schaltfläche, die es dem Benutzer ermöglicht, die Installation zu verschieben. |
||||||
|
|
-AllowDeferCloseApps <SwitchParameter> |
||||||
|
Aktiviert eine optionale Schaltfläche zum Aufschieben, damit der Benutzer die Installation nur dann aufschieben kann, wenn es laufende Anwendungen gibt, die geschlossen werden müssen. Dieser Parameter aktiviert automatisch -AllowDefer |
||||||
|
|
-BlockExecution <SwitchParameter> |
||||||
|
Option to prevent the user from launching processes/applications, specified in -CloseApps, during the installation. |
||||||
|
|
-CheckDiskSpace <SwitchParameter> |
||||||
|
Geben Sie an, ob geprüft werden soll, ob genügend Speicherplatz für die Installation vorhanden ist. Wenn dieser Parameter ohne den RequiredDiskSpace-Parameter angegeben wird, wird der erforderliche Speicherplatz automatisch anhand der Größe der Skriptquelle und der zugehörigen Dateien berechnet. |
||||||
|
|
-CloseApps <String> |
||||||
|
Name des anzuhaltenden Prozesses (ohne .exe). Geben Sie mehrere Prozesse durch ein Komma getrennt an. Geben Sie benutzerdefinierte Beschreibungen wie diese an: "winword=Microsoft Office Word,excel=Microsoft Office Excel" |
||||||
|
|
-CloseAppsCountdown <Int32> |
||||||
|
Option zur Angabe eines Countdowns in Sekunden, bis die angegebenen Anwendungen automatisch geschlossen werden. Dies wird nur wirksam, wenn ein Aufschub nicht erlaubt oder abgelaufen ist. |
||||||
|
|
-Context <String> |
||||||
|
User: Ausführung unter Benutzerkonto; Protokollierung in HKEY_CURRENT_USER, also für den Benutzer. |
||||||
|
|
-CustomText <SwitchParameter> |
||||||
|
Geben Sie an, ob eine in der XML-Datei angegebene benutzerdefinierte Meldung angezeigt werden soll. Die benutzerdefinierte Nachricht muss für jeden Sprachabschnitt in der XML-Datei eingegeben werden. |
||||||
|
|
-DeferDays <Int32> |
||||||
|
Geben Sie die Anzahl der Tage seit dem ersten Lauf an, die die Installation aufgeschoben werden kann. Dies wird in eine Frist umgewandelt. |
||||||
|
|
-DeferDeadline <String> |
||||||
|
Geben Sie den Stichtag an, bis zu dem die Installation aufgeschoben werden kann. Geben Sie das Datum in dem lokalen Länderformat an, wenn das Skript für dasselbe Länderformat bestimmt ist. Wenn das Skript auf DE-DE-Rechnern ausgeführt werden soll, geben Sie das Datum in dem Format an: "25.08.2013" oder "25.08.2013" oder "25.08.2013 18:00:00". Wenn das Skript für mehrere Länderformate bestimmt ist, geben Sie das Datum im universellen, sortierbaren Datums-/Zeitformat an: "2013-08-22 11:51:52Z". Das Stichtagsdatum wird dem Benutzer in dem Format seiner Länderformat angezeigt. |
||||||
|
|
-DeferTimes <Int32> |
||||||
|
Geben Sie an, wie oft die Installation verschoben werden kann. |
||||||
|
|
-ForceCloseAppsCountdown <Int32> |
||||||
|
Option zur Angabe eines Countdowns in Sekunden, bis die angegebenen Anwendungen automatisch geschlossen werden, unabhängig davon, ob ein Aufschub erlaubt ist. |
||||||
|
|
-ForceCountdown <Int32> |
||||||
|
Geben Sie einen Countdown an, der angezeigt werden soll, bevor automatisch mit der Installation fortgefahren wird, wenn eine Aufschiebung aktiviert ist. |
||||||
|
|
-MinimizeWindows <Boolean> |
||||||
|
Gibt an, ob andere Fenster bei der Anzeige der Eingabeaufforderung minimiert werden sollen. Voreinstellung: $true. |
||||||
|
|
-PersistPrompt <SwitchParameter> |
||||||
|
Geben Sie an, ob die Aufforderung Show-InstallationWelcome alle paar Sekunden in der Mitte des Bildschirms angezeigt werden soll, die in der Datei AppDeployToolkitConfig.xml angegeben ist. Der Benutzer hat dann keine andere Wahl, als auf die Aufforderung zu reagieren. Dies wird nur wirksam, wenn ein Aufschub nicht erlaubt oder abgelaufen ist. |
||||||
|
|
-PromptToSave <SwitchParameter> |
||||||
|
Legen Sie fest, ob Anwender aufgefordert werden sollen, Arbeitsdokumente zu speichern, wenn der Benutzer Anwendungen durch Auswahl der Schaltfläche "Programme schließen" schließt. |
||||||
|
|
-RequiredDiskSpace <Int32> |
||||||
|
Geben Sie den erforderlichen Festplattenspeicher in MB an, der in Kombination mit CheckDiskSpace verwendet wird. |
||||||
|
|
-Silent <SwitchParameter> |
||||||
|
Prozesse ohne Aufforderung des Benutzers anhalten. |
||||||
|
|
-TopMost <Boolean> |
||||||
|
Gibt an, ob das Fenster das oberste Fenster ist. Voreinstellung: $true. |
||||||
|
|
<CommonParameters> |
|
Weitere Informationen zu 'common parameters' finden Sie mit dem Kommando "Get-Help about_CommonParameters". |