diff --git a/windows/configuration/shell-launcher/configure-wmi.md b/windows/configuration/shell-launcher/configure-wmi.md index cb9580ad62..bbc8674142 100644 --- a/windows/configuration/shell-launcher/configure-wmi.md +++ b/windows/configuration/shell-launcher/configure-wmi.md @@ -10,10 +10,11 @@ ms.topic: how-to > [!NOTE] > When using the WMI providers option, you must first [enable Shell Launcher](enable.md). -Modify the following PowerShell script as appropriate and run the script on the device. +## Verify Shell Launcher license + +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. ```PowerShell -# Check if shell launcher license is enabled function Check-ShellLauncherLicenseEnabled { [string]$source = @" @@ -54,10 +55,14 @@ $result = Check-ShellLauncherLicenseEnabled "`nShell Launcher license enabled is set to " + $result if (-not($result)) { - "`nThis device doesn't have required license to use Shell Launcher" + "`nThis device doesn't have required license to use Shell Launcher" exit } +``` + +```PowerShell + $COMPUTER = "localhost" $NAMESPACE = "root\standardcimv2\embedded" diff --git a/windows/configuration/shell-launcher/enable.md b/windows/configuration/shell-launcher/enable.md index b1d8896d94..3999329e77 100644 --- a/windows/configuration/shell-launcher/enable.md +++ b/windows/configuration/shell-launcher/enable.md @@ -7,27 +7,30 @@ ms.topic: how-to # Enable Shell Launcher -Shell Launcher is an optional component and isn't turned on by default in Windows. It must be turned on before configuring it. You can turn on and configure Shell Launcher in a customized Windows image, or you must turn on Shell Launcher before applying a provisioning package to configure Shell Launcher. +Shell Launcher is an optional component in Windows that is not enabled by default. To configure it, you must first enable it. You can enable and configure Shell Launcher in a customized Windows image, or you can enable it before applying a provisioning package to configure it. > [!NOTE] > When you configure Shell Launcher with the Assigned Access Configuration Service Provider (CSP), Shell Launcher is automatically enabled, if the device supports it. There's no need to enable Shell Launcher separately when you configure it using Assigned Access CSP. +There are multiple ways to enable Shell Launcher, select the method that best fits your needs to learn more. + #### [:::image type="icon" source="../images/icons/control-panel.svg"::: **Control Panel**](#tab/control-panel) -1. In the **Search the web and Windows** field, type **Programs and Features** and either press **Enter** or tap or select **Programs and Features** to open it. -1. In the **Programs and Features** window, select **Turn Windows features on or off**. -1. In the **Windows Features** window, expand the **Device Lockdown** node, select or clear the checkbox for **Shell Launcher**, and then select **OK.** -1. The **Windows Features** window indicates that Windows is searching for required files and displays a progress bar. Once found, the window indicates that Windows is applying the changes. When completed, the window indicates the requested changes are completed. -1. Select **Close** to close the **Windows Features** window. +To enable Shell Launcher using Control Panel, follow these steps: - -Control Panel > Programs > Turn Windows features on or off or use the command `optionalfeatures.exe` - -Expand **Device Lockdown** and select **Shell Launcher** +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** #### [:::image type="icon" source="../images/icons/powershell.svg"::: **PowerShell**](#tab/powershell) -Enable-WindowsOptionalFeature -FeatureName Client-DeviceLockdown,Client-EmbeddedShellLauncher -Online +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: + + ```powershell + Enable-WindowsOptionalFeature -FeatureName Client-DeviceLockdown,Client-EmbeddedShellLauncher -Online + ``` #### [:::image type="icon" source="../images/icons/provisioning-package.svg"::: **PPKG**](#tab/ppkg)