This topic has not yet been rated - Rate this topic

Winpeshl.ini Files

Published: February 29, 2012

Updated: May 31, 2012

Applies To: Windows 8, Windows Server 2012

Winpeshl.ini controls whether a customized shell is loaded in Windows® Preinstallation Environment (Windows PE) or the default command prompt window.

The CmdLine entry in the HKEY_LOCAL_MACHINE\SYSTEM\Setup registry key calls Winpeshl.exe. The Winpeshl.exe file performs several important functions, including calling the default Command Prompt window in Windows PE and your customized shell application.

CautionCaution
Do not modify the value of the CmdLine entry in the HKEY_LOCAL_MACHINE\SYSTEM\Setup Setupreg.hiv registry key to start your shell application.

  1. 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. For example:

    [LaunchApp]
    AppPath = %SYSTEMDRIVE%\myshell.exe
    [LaunchApps]
    %SYSTEMDRIVE%\mydir\application1.exe,<option>,<option>,<option>
    
  2. 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.

  3. 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.

    noteNote
    You cannot specify a command that is greater than 250 characters.

  4. Exit the command prompt window or your customized shell application

    Windows PE restarts.

Did you find this helpful?
(1500 characters remaining)
© 2013 Microsoft. All rights reserved.