mirror of
https://github.com/MicrosoftDocs/windows-itpro-docs.git
synced 2025-06-16 10:53:43 +00:00
updates
This commit is contained in:
@ -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.
|
|
||||||
|
@ -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
|
||||||
|
@ -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
|
||||||
@ -34,4 +32,6 @@ items:
|
|||||||
- name: SetDefaultShell
|
- name: SetDefaultShell
|
||||||
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
|
Reference in New Issue
Block a user