This commit is contained in:
Paolo Matarazzo
2025-03-06 17:20:12 -05:00
parent 5dcee82034
commit 7f9c97f34c
3 changed files with 13 additions and 16 deletions

View File

@ -2,19 +2,21 @@
title: Configure Shell Launcher with the WMI provider title: Configure Shell Launcher with the WMI provider
description: Learn how to configure a Windows kiosk using the WMI provider for Shell Launcher. description: Learn how to configure a Windows kiosk using the WMI provider for Shell Launcher.
ms.date: 02/27/2025 ms.date: 02/27/2025
ms.topic: how-to ms.topic: reference
--- ---
# Configure Shell Launcher with the WMI provider # Configure Shell Launcher with the WMI provider
> [!NOTE] This article provides a guide on configuring Shell Launcher using the WMI provider, which consists of a set of classes for managing Shell Launcher settings.
> When using the WMI providers option, you must first [enable Shell Launcher](enable.md).
## Verify Shell Launcher license Included in this article is a PowerShell script that demonstrates how to utilize the WMI provider for configuring Shell Launcher. The script offers examples on setting the default shell, assigning a custom shell to a user, and removing a custom shell. Additionally, the WMI provider can be used to enable or disable Shell Launcher.
Shell Launcher is a licensed feature. You can verify that the Shell Launcher license is enabled on the device by executing the following sample PowerShell script. The script checks the license status and then displays the current license status. > [!IMPORTANT]
> The script is not intended to be run as-is. You must modify the script to match your environment and requirements. For example, you must change the user name in the script to match an existing user on your system. The script is provided as a reference only.
```PowerShell ```PowerShell
# Verify Shell Launcher license
function Check-ShellLauncherLicenseEnabled function Check-ShellLauncherLicenseEnabled
{ {
[string]$source = @" [string]$source = @"
@ -59,10 +61,6 @@ if (-not($result))
exit exit
} }
```
```PowerShell
$COMPUTER = "localhost" $COMPUTER = "localhost"
$NAMESPACE = "root\standardcimv2\embedded" $NAMESPACE = "root\standardcimv2\embedded"
@ -144,5 +142,3 @@ $IsShellLauncherEnabled = $ShellLauncherClass.IsEnabled()
"`nEnabled is set to " + $IsShellLauncherEnabled.Enabled "`nEnabled is set to " + $IsShellLauncherEnabled.Enabled
``` ```
> [!NOTE]
> The previous script includes examples of multiple configuration options, including removing a custom shell and disabling Shell Launcher. It is not intended to be run as-is.

View File

@ -20,13 +20,14 @@ To enable Shell Launcher using Control Panel, follow these steps:
1. Open **Control Panel** > **Programs** > **Turn Windows features on or off** or use the command `optionalfeatures.exe` 1. Open **Control Panel** > **Programs** > **Turn Windows features on or off** or use the command `optionalfeatures.exe`
1. Expand **Device Lockdown** and select **Shell Launcher** 1. Expand **Device Lockdown** and select **Shell Launcher**
1. Select **OK** to enable Shell Launcher
#### [:::image type="icon" source="../images/icons/powershell.svg"::: **PowerShell**](#tab/powershell) #### [:::image type="icon" source="../images/icons/powershell.svg"::: **PowerShell**](#tab/powershell)
To enable Shell Launcher using PowerShell, follow these steps: To enable Shell Launcher using PowerShell, follow these steps:
1. Open a PowerShell window with administrator privileges 1. Open a PowerShell window with administrator privileges
1. Run the following command to enable Shell Launcher: 1. Run the following command:
```powershell ```powershell
Enable-WindowsOptionalFeature -FeatureName Client-DeviceLockdown,Client-EmbeddedShellLauncher -Online Enable-WindowsOptionalFeature -FeatureName Client-DeviceLockdown,Client-EmbeddedShellLauncher -Online

View File

@ -5,10 +5,8 @@ items:
href: index_old.md href: index_old.md
- name: 🟡 Enable Shell Launcher - name: 🟡 Enable Shell Launcher
href: enable.md href: enable.md
- name: Configure a kiosk - name: Configure Shell Launcher
href: configure.md href: configure.md
- name: Configure a kiosk (wmi)
href: configure-wmi.md
- name: "Quickstart: Configure a kiosk" - name: "Quickstart: Configure a kiosk"
href: quickstart-kiosk.md href: quickstart-kiosk.md
- name: Create a configuration file - name: Create a configuration file
@ -35,3 +33,5 @@ items:
href: wesl-usersettingsetdefaultshell.md href: wesl-usersettingsetdefaultshell.md
- name: SetEnabled - name: SetEnabled
href: wesl-usersettingsetenabled.md href: wesl-usersettingsetenabled.md
- name: Configure Shell Launcher with WMI
href: configure-wmi.md