WESL_UserSetting.SetDefaultShell
This method sets the default Shell Launcher configuration.
Windows edition requirements
The following list contains the Windows editions that support Shell Launcher:
✅ Enterprise / Enterprise LTSC
✅ Education
✅ IoT Enterprise / IoT Enterprise LTSC
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.