This documentation is archived and is not being maintained.

Winpeshl.ini Files

Published: October 22, 2009

Updated: October 22, 2009

Applies To: Windows 7

This content applies to Windows 7. For Windows 8 content, see Windows Deployment with the Windows ADK.

Winpeshl.ini controls whether a customized shell is loaded in Windows® PE or the default Command Prompt window. To load a customized shell, create a file named Winpeshl.ini and place it in %SYSTEMROOT%\System32 of your customized Windows PE image. The .ini file must have the following sections and entries.

AppPath = %SYSTEMDRIVE%\myshell.exe
%SYSTEMDRIVE%\mydir\application1.exe, {option}

Set the AppPath entry to the path to your shell application. You can use a fully qualified path, or you can use environment variables, such as %SYSTEMROOT%\System32\Myshell.exe. The AppPath entry does not support command-line options.

Use the [LaunchApps] section to run applications with command-line options. The applications run in the order listed. Separate the name of the application from its options with a comma.

When you exit the Command Prompt window or your customized shell application, Windows PE restarts.

Do not edit the value of CmdLine in the HKEY_LOCAL_MACHINE\SYSTEM\Setup registry key of to start your shell application. The value of CmdLine calls Winpeshl.exe, which performs a number of functions, including calling the default Command Prompt window in Windows PE or your customized shell application.

See Also