Aggiungere uno script personalizzato al programma di installazione di Windows

Articolo
06/20/2023

Script di installazione di Windows

Setupcomplete.cmd e ErrorHandler.cmd sono script personalizzati eseguiti durante o dopo il processo di installazione di Windows. Possono essere usati per installare applicazioni o eseguire altre attività usando script cscript/wscript .

%WINDIR%\Setup\Scripts\SetupComplete.cmd: questo script viene eseguito con autorizzazioni di sistema locali e viene avviato immediatamente dopo che l'utente vede il desktop. Questa impostazione viene disabilitata quando si usano chiavi prodotto OEM, ad eccezione delle edizioni Enterprise e dei sistemi operativi Windows Server.
%WINDIR%\Setup\Scripts\ErrorHandler.cmd: questo script viene eseguito automaticamente quando il programma di installazione rileva un errore irreversibile. Viene eseguito con l'autorizzazione del sistema locale.

Eseguire uno script dopo il completamento dell'installazione (SetupComplete.cmd)

Ordine delle operazioni

Dopo l'installazione di Windows, ma prima che venga visualizzata la schermata di accesso, il programma di installazione di Windows cerca il file SetupComplete.cmd nella directory %WINDIR%\Setup\Scripts\ .
Se viene trovato un file SetupComplete.cmd , il programma di installazione di Windows esegue lo script. Il programma di installazione di Windows registra l'azione nel file C:\Windows\Panther\UnattendGC\Setupact.log .

L'installazione non verifica i codici di uscita o i livelli di errore nello script dopo l'esecuzione di SetupComplete.cmd.

Avviso

Non è possibile riavviare il sistema e riprendere l'esecuzione di SetupComplete.cmd. Non è consigliabile riavviare il sistema aggiungendo un comando, ad esempio arresto -r. Questo metterà il sistema in uno stato non valido.
Se il computer aggiunge un dominio durante l'installazione, il Criteri di gruppo definito nel dominio non viene applicato al computer fino al completamento dell'installazione.cmd. Si tratta di assicurarsi che l'attività di configurazione Criteri di gruppo non interferisca con lo script.

Eseguire uno script se il programma di installazione di Windows rileva un errore irreversibile (ErrorHandler.cmd)

ErrorHandler.cmd è utile quando si installano molti sistemi contemporaneamente. Ciò consente di rilevare quando si verifica un errore durante l'installazione di Windows. Al termine, l'installazione esegue automaticamente uno script che può contenere comandi o azioni personalizzati per risolvere la causa dell'errore.

Se il programma di installazione di Windows rileva un errore irreversibile e non viene completato l'installazione, il programma di installazione di Windows cerca uno script di comando nella directory seguente: %WINDIR%\Setup\Scripts\ErrorHandler.cmd. Si verificherà una delle due azioni, a seconda che lo script venga trovato.

Se lo script non viene trovato, viene visualizzata una finestra di dialogo con il testo dell'errore. Un utente deve ignorare la finestra di dialogo prima dell'uscita dall'installazione di Windows.
Se lo script viene trovato, lo script viene eseguito in modo sincrono. Non viene visualizzato alcun testo di dialogo o di errore. Al termine dell'esecuzione dello script ErrorHandler.cmd , il programma di installazione di Windows viene chiuso.

A seconda della fase di installazione di Windows, il computer restituirà all'ambiente da cui è stato eseguito l'installazione di Windows, ad esempio una versione precedente del sistema operativo o Windows Preinstallation Environment (Windows PE), ad esempio.

Potrebbero verificarsi istanze quando il programma di installazione di Windows rileva più di un errore ed esegue lo script ErrorHandler.cmd più volte. Quando si sviluppa il codice per ErrorHandler.cmd, assicurarsi di poter eseguire questo script più volte.

Usare ErrorHandler.cmd

Per usare ErrorHandler.cmd, è possibile eseguire una delle operazioni seguenti:

Montare l'immagine e aggiungerla all'immagine in %WINDIR%\Setup\Scripts\ErrorHandler.cmd. Smontare l'immagine.

-oppure-
Aggiungere ErrorHandler.cmd a un percorso di file temporaneo,ad esempio C:\Temp\ErrorHandler.cmd, quindi eseguire l'installazione di Windows usando l'opzione /m .
```
Setup /m:C:\Temp
```
Per altre informazioni, vedere Installazione di Windows Command-Line Opzioni.

Usare Unattend per eseguire script

Creare un file Unattend.xml con una di queste impostazioni da eseguire durante il processo di installazione di Windows. Questa operazione può essere usata con chiavi prodotto OEM.

Per eseguire servizi o comandi che possono iniziare contemporaneamente, usare RunAsynchronousCommands.

Alcune di queste impostazioni vengono eseguite nel contesto utente, altre vengono eseguite nel contesto di sistema a seconda del passaggio di configurazione.

Aggiungere Microsoft-Windows-Setup\RunAsynchronousCommand o RunSynchronousCommand per eseguire uno script durante l'avvio dell'installazione di Windows. Questo può essere utile per impostare le partizioni del disco rigido.
Aggiungere Microsoft-Windows-Deployment\RunAsynchronousCommand o RunSynchronousCommand al passaggio di configurazione auditUser per eseguire uno script eseguito quando il PC entra in modalità di controllo. Questo può essere utile per le attività come l'installazione automatica dell'app o il test.
Aggiungere Microsoft-Windows-Shell-Setup\LogonCommands\SyncCommands o FirstLogonCommands\SynchronousCommands per l'esecuzione dopo l'esperienza Out of Box (OOBE) ma prima che l'utente visualizzi il desktop. Questo può essere particolarmente utile per configurare app o contenuti specifici della lingua dopo che l'utente ha già selezionato la lingua.

Usare questi script in modo semplice perché gli script lunghi possono impedire all'utente di raggiungere rapidamente la schermata Start. Per le versioni al dettaglio di Windows, si applicano restrizioni aggiuntive a questi script. Per info, vedi le indicazioni su licenze e criteri nel centro per i partner OEM.

Nota

Quando si aggiunge uno script usando FirstLogonCommands, verrà attivato nell'avvio successivo, anche se si avvia in modalità di controllo usando CTRL+MAIUSC+F3. Per avviare la modalità di controllo senza attivare questi script, aggiungere l'impostazione: Microsoft-Windows-Deployment\Reseal\Mode = Audit.

Guida di riferimento tecnico per l'installazione di Windows Distribuisci un'immagine personalizzata in modalità di controllo o OOBE Aggiungi driver di dispositivo a Windows durante l'installazione di Windows