Hinzufügen eines benutzerdefinierten Skripts zu Windows Setup

  • Artikel
  • 3 Minuten Lesedauer

Windows Setupskripts

Setupcomplete.cmd und ErrorHandler.cmd sind benutzerdefinierte Skripts, die während oder nach dem Windows Setupprozess ausgeführt werden. Sie können verwendet werden, um Anwendungen zu installieren oder andere Aufgaben mithilfe von Cscript/wscript-Skripts auszuführen.

  • %WINDIR%\Setup\Skripts\SetupComplete.cmd: Dieses Skript wird mit lokalen Systemberechtigungen ausgeführt und sofort gestartet, nachdem der Benutzer den Desktop angezeigt hat. Diese Einstellung ist beim Verwenden von OEM-Product Keys deaktiviert, außer bei Enterprise Editionen und Windows Serverbetriebssystemen.
  • %WINDIR%\Setup\Skripts\ErrorHandler.cmd: Dieses Skript wird automatisch ausgeführt, wenn Setup einen tödlichen Fehler auftritt. Es wird mit lokaler Systemberechtigung ausgeführt.

Ausführen eines Skripts nach Abschluss des Setups (SetupComplete.cmd)

Reihenfolge der Vorgänge

  1. Nachdem Windows installiert wurde, aber bevor der Anmeldebildschirm angezeigt wird, sucht Windows Setup nach der Datei "SetupComplete.cmd" im Verzeichnis %WINDIR%\Setup\Skripts\.

  2. Wenn eine SetupComplete.cmd-Datei gefunden wird, führt Windows Setup das Skript aus. Windows Setup protokolliert die Aktion in der Datei "C:\Windows\Panther\UnattendGC\Setupact.log".

    Setup überprüft keine Exitcodes oder Fehlerstufen im Skript, nachdem es SetupComplete.cmd ausführt.

    Warnung

    Sie können das System nicht neu starten und die Ausführung von SetupComplete.cmd fortsetzen. Sie sollten das System nicht neu starten, indem Sie einen Befehl wie herunterfahren -r hinzufügen. Dadurch wird das System in einen schlechten Zustand versetzt.

  3. Wenn der Computer während der Installation eine Domäne verknüpft, wird die Gruppenrichtlinie, die in der Domäne definiert ist, nicht auf den Computer angewendet, bis Setupcomplete.cmd abgeschlossen ist. Dies besteht darin, sicherzustellen, dass die Gruppenrichtlinie Konfigurationsaktivität das Skript nicht beeinträchtigt.

Führen Sie ein Skript aus, wenn Windows Setup einen tödlichen Fehler (ErrorHandler.cmd) aufweist.

ErrorHandler.cmd ist nützlich, wenn Sie viele Systeme gleichzeitig installieren. Dadurch können Sie erkennen, wann während Windows Setup ein Fehler auftritt. Wenn dies der Fall ist, führt Setup automatisch ein Skript aus, das benutzerdefinierte Befehle oder Aktionen enthält, um die Ursache des Fehlers zu beheben.

Wenn Windows Setup einen schwerwiegenden Fehler auftritt und verhindert wird, die Installation abzuschließen, sucht Windows Setup nach einem Befehlsskript im folgenden Verzeichnis: %WINDIR%\Setup\Setup\Script\ErrorHandler.cmd. Je nachdem, ob das Skript gefunden wird, tritt eine von zwei Aktionen auf.

  • Wenn das Skript nicht gefunden wird, wird ein Dialogfeld mit dem Fehlertext angezeigt. Ein Benutzer muss das Dialogfeld schließen, bevor Windows Setup beendet wird.
  • Wenn das Skript gefunden wird, wird das Skript synchron ausgeführt. Kein Dialogfeld oder Fehlertext wird angezeigt. Nachdem das ErrorHandler.cmd-Skript ausgeführt wurde, wird Windows Setup beendet.

Abhängig von der Phase von Windows Setup wird der Computer an die Umgebung zurückgegeben, von der Windows Setup ausgeführt wurde, z. B. eine frühere Version des Betriebssystems oder Windows Preinstallation Environment (Windows PE).

Möglicherweise gibt es Instanzen, wenn Windows Setup mehr als einen Fehler auftritt und das ErrorHandler.cmd-Skript mehr als einmal ausführt. Stellen Sie beim Entwickeln des Codes für ErrorHandler.cmd sicher, dass Sie dieses Skript mehrmals ausführen können.

Verwenden von ErrorHandler.cmd

Um ErrorHandler.cmd zu verwenden, können Sie eine der folgenden Aktionen ausführen:

  • Fügen Sie das Bild ein, und fügen Sie es dem Bild in %WINDIR%\Setup\Skripts\ErrorHandler.cmd hinzu. Heben Sie die Bereitstellung des Images auf.

    Oder

  • Fügen Sie ErrorHandler.cmd zu einem temporären Dateispeicherort hinzu (z. B. C:\Temp\ErrorHandler.cmd), und führen Sie dann Windows Setup mithilfe der Option /m aus.

    Setup /m:C:\Temp

    Weitere Informationen finden Sie unter Windows Setup Command-Line Optionen.

Verwenden von Unattend zum Ausführen von Skripts

Erstellen Sie eine Unattend.xml Datei mit einer dieser Einstellungen, die während des Windows Setupvorgangs ausgeführt werden sollen. Dies kann mit OEM-Product Keys verwendet werden.

Um Dienste oder Befehle auszuführen, die gleichzeitig gestartet werden können, verwenden Sie RunAsynchronousCommands.

Einige dieser Einstellungen werden im Benutzerkontext ausgeführt, andere werden im Systemkontext abhängig vom Konfigurationspass ausgeführt.

  • Fügen Sie Microsoft-Windows-Setup\RunAsynchronousCommand oder RunSynchronousCommand hinzu, um ein Skript auszuführen, da Windows Setup gestartet wird. Dies kann hilfreich sein, um Festplattenpartitionen festzulegen.

  • Fügen Sie Microsoft-Windows-Deployment\RunAsynchronousCommand oder RunSynchronousCommand zum AuditUser-Konfigurationspass hinzu, um ein Skript auszuführen, das ausgeführt wird, wenn der PC den Überwachungsmodus eingibt. Dies kann hilfreich für Aufgaben wie die automatisierte App-Installation oder -Tests sein.

  • Fügen Sie Microsoft-Windows-Shell-Setup\LogonCommands\AsynchronCommands\FirstLogonCommands\SynchronCommand hinzu, um nach der Out of Box Experience (OOBE) auszuführen, aber bevor der Benutzer den Desktop sieht. Dies kann besonders nützlich sein, um sprachspezifische Apps oder Inhalte einzurichten, nachdem der Benutzer bereits seine Sprache ausgewählt hat.

    Verwenden Sie diese Skripts sparsam, da lange Skripts verhindern können, dass der Benutzer die Startbildschirm schnell erreicht. Für Einzelhandelsversionen von Windows gelten zusätzliche Einschränkungen für diese Skripts. Informationen finden Sie im Leitfaden für Lizenzierung und Richtlinien im OEM Partner Center.

    Hinweis

    Wenn Sie ein Skript mithilfe von FirstLogonCommands hinzufügen, wird sie im nächsten Start ausgelöst, auch wenn Sie mit STRG+UMSCHALT+F3 in den Überwachungsmodus starten. Um den Überwachungsmodus zu starten, ohne diese Skripts auszulösen, fügen Sie die Einstellung hinzu: Microsoft-Windows-Deployment\Reseal\Mode = Überwachungs.

Windows technischen Referenz zum Einrichteneines benutzerdefinierten Bildstarts Windowszum Überwachungsmodus oder OOBEHinzufügen von Gerätetreibern zu Windows während Windows Setups