diff --git a/windows/configuration/shell-launcher/configure-wmi.md b/windows/configuration/shell-launcher/configure-wmi.md index bbc8674142..fc16301fe4 100644 --- a/windows/configuration/shell-launcher/configure-wmi.md +++ b/windows/configuration/shell-launcher/configure-wmi.md @@ -2,19 +2,21 @@ title: Configure Shell Launcher with the WMI provider description: Learn how to configure a Windows kiosk using the WMI provider for Shell Launcher. ms.date: 02/27/2025 -ms.topic: how-to +ms.topic: reference --- # Configure Shell Launcher with the WMI provider -> [!NOTE] -> When using the WMI providers option, you must first [enable Shell Launcher](enable.md). +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. -## 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 +# Verify Shell Launcher license + function Check-ShellLauncherLicenseEnabled { [string]$source = @" @@ -59,10 +61,6 @@ if (-not($result)) exit } -``` - -```PowerShell - $COMPUTER = "localhost" $NAMESPACE = "root\standardcimv2\embedded" @@ -144,5 +142,3 @@ $IsShellLauncherEnabled = $ShellLauncherClass.IsEnabled() "`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. diff --git a/windows/configuration/shell-launcher/enable.md b/windows/configuration/shell-launcher/enable.md index 3999329e77..0bd724e045 100644 --- a/windows/configuration/shell-launcher/enable.md +++ b/windows/configuration/shell-launcher/enable.md @@ -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. 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) To enable Shell Launcher using PowerShell, follow these steps: 1. Open a PowerShell window with administrator privileges -1. Run the following command to enable Shell Launcher: +1. Run the following command: ```powershell Enable-WindowsOptionalFeature -FeatureName Client-DeviceLockdown,Client-EmbeddedShellLauncher -Online diff --git a/windows/configuration/shell-launcher/toc.yml b/windows/configuration/shell-launcher/toc.yml index 95a0965447..8a0b2afad9 100644 --- a/windows/configuration/shell-launcher/toc.yml +++ b/windows/configuration/shell-launcher/toc.yml @@ -5,10 +5,8 @@ items: href: index_old.md - name: 🟡 Enable Shell Launcher href: enable.md -- name: Configure a kiosk +- name: Configure Shell Launcher href: configure.md -- name: Configure a kiosk (wmi) - href: configure-wmi.md - name: "Quickstart: Configure a kiosk" href: quickstart-kiosk.md - name: Create a configuration file @@ -34,4 +32,6 @@ items: - name: SetDefaultShell href: wesl-usersettingsetdefaultshell.md - name: SetEnabled - href: wesl-usersettingsetenabled.md \ No newline at end of file + href: wesl-usersettingsetenabled.md + - name: Configure Shell Launcher with WMI + href: configure-wmi.md \ No newline at end of file