Edit

Share via

WESL_UserSetting.SetDefaultShell

  • Article
  • Applies to:
    ✅ Windows 11, ✅ Windows 10

This method sets the default Shell Launcher configuration.

Syntax

[Static] uint32 SetDefaultShell (
    [In, Required] string Shell,
    [In, Required] sint32 DefaultAction
);

Parameters

Shell
[in, required] The application or executable that Shell Launcher starts as the shell.

DefaultAction
[in, required] The default action that Shell Launcher takes when the Shell application exits.

The possible actions are defined in the following table:

Value Description
0 Restart the shell.
1 Restart the device.
2 Shut down the device.
3 Do nothing.

Return Value

Returns an HRESULT value that indicates WMI status or a WMI error.

Remarks

Shell Launcher uses the default configuration when the security identifier (SID) of the user who is currently signed in does not match any custom defined Shell Launcher configurations.

Requirements

Windows Edition Supported
Windows Home No
Windows Pro No
Windows Enterprise Yes
Windows Education Yes
Windows IoT Enterprise Yes