Table of contents
TOC
Collapse the table of content
Expand the table of content

Microsoft-Windows-Embedded-ShellLauncher

Last Updated: 12/12/2016

You can use shell launcher to replace the default OS shell with a custom shell. You can use any application or executable as your custom shell, such as a command window or a custom dedicated application.

Important

  • You may specify any executable file to be the default shell except C:\Windows\System32\Eshell.exe. Using Eshell.exe as the default shell will result in a blank screen after a user signs in.

    You can also configure shell launcher to launch different shell applications for different users or user groups.

  • You cannot use shell launcher to launch a Windows Store app as a custom shell. However, you can use the application launcher to launch a Windows Store app at startup.

Shell launcher processes the Run and RunOnce registry keys before starting the custom shell, so your custom shell doesn't need to handle the automatic startup of other applications or services. Shell launcher also handles the behavior of the system when your custom shell exits. You can configure the shell exit behavior if the default behavior does not meet your needs.

Important
A custom shell is launched with the same level of user rights as the account that is signed in. This means that a user with administrator rights can perform any system action that requires administrator rights, including launching other applications with administrator rights, while a user without administrator rights cannot. If your shell application requires administrator rights and needs to be elevated, and User Account Control (UAC) is present on your device, you must disable UAC in order for shell launcher to launch the shell application.

Child elements

TopicDescription

DefaultReturnCodeAction

Specifies what action to take, based on the return code.

Shell

Specifies the application or executable to use as the default custom shell.

UserSettings

Use the UserSettings settings to specify what custom shell and what default return code action to use for specific users or user groups.

The default shell settings, DefaultReturnCodeAction and Shell, are used when shell launcher is enabled but the security identifier (SID) of the user who is currently signed in does not match any custom defined shell launcher configurations.

Use the UserSettings settings to specify what custom shell and what default return code action to use for specific users or user groups.

Applies to

To determine whether a component applies to the image you’re building, load your image into Windows SIM and search for the component or setting name. For information on how to view components and settings, see Configure Components and Settings in an Answer File.

Send comments about this topic to Microsoft

© 2017 Microsoft