Configurer le lanceur d’interpréteur de commandes

• S’applique à:

  ✅ Windows 11, ✅ Windows 10

Il existe deux façons de configurer le lanceur d’interpréteur de commandes :

1. Utilisation du ShellLauncher nœud du fournisseur de services de configuration d’accès affecté (CSP), qui active également automatiquement le lanceur d’interpréteur de commandes sur l’appareil, si l’appareil le prend en charge
2. Utilisation des fournisseurs WMI du lanceur d’interpréteur de commandes directement dans une application. Lorsque vous utilisez cette méthode, vous devez d’abord activer le lanceur d’interpréteur de commandes

Vous pouvez configurer les options suivantes pour le lanceur d’interpréteur de commandes :

• Ajouter/supprimer une configuration d’interpréteur de commandes pour un utilisateur ou un groupe spécifique
• Modifier la configuration de l’interpréteur de commandes par défaut
• Obtenir des informations sur une configuration d’interpréteur de commandes pour un utilisateur ou un groupe spécifique

Remarque

Les modifications n’entrent pas en vigueur tant qu’un utilisateur ne se connecte pas.

Activer le lanceur d’interpréteur de commandes

Le lanceur d’interpréteur de commandes est un composant facultatif dans Windows qui n’est pas activé par défaut. Pour le configurer, vous devez d’abord l’activer. Vous pouvez activer et configurer le lanceur d’interpréteur de commandes dans une image Windows personnalisée, ou vous pouvez l’activer avant d’appliquer un package d’approvisionnement pour le configurer.

Remarque

Lorsque vous configurez le lanceur d’interpréteur de commandes avec le fournisseur de services de configuration d’accès (CSP) affecté, le lanceur d’interpréteur de commandes est automatiquement activé si l’appareil le prend en charge. Il n’est pas nécessaire d’activer le lanceur d’interpréteur de commandes séparément lorsque vous le configurez à l’aide du fournisseur csp à accès affecté.

Il existe plusieurs façons d’activer le lanceur d’interpréteur de commandes. Sélectionnez la méthode qui correspond le mieux à vos besoins pour en savoir plus.

Panneau de configuration,

Pour activer le lanceur d’interpréteur de commandes à l’aide de Panneau de configuration, procédez comme suit :

1. Ouvrez Panneau de configuration>ProgrammesActiver ou désactiver les > fonctionnalités Windows ou utilisez la commandeoptionalfeatures.exe
2. Développez Verrouillage de l’appareil et sélectionnez Lanceur d’interpréteur de commandes
3. Sélectionnez OK pour activer le lanceur d’interpréteur de commandes

PowerShell

Pour activer le lanceur d’interpréteur de commandes à l’aide de PowerShell, procédez comme suit :

1. Ouvrir une fenêtre PowerShell avec des privilèges d’administrateur

2. Exécutez la commande suivante :

   Enable-WindowsOptionalFeature -FeatureName Client-DeviceLockdown,Client-EmbeddedShellLauncher -Online
   

DISM

L’exemple suivant utilise une image Windows appelée install.wim, mais vous pouvez utiliser la même procédure pour appliquer un package d’approvisionnement.

1. Ouvrez une invite de commandes avec des privilèges d’administrateur.
2. Copiez install.wim dans un dossier temporaire sur le disque dur (dans les étapes suivantes, nous supposons qu’il s’appelle C:\wim)
3. Modifiez le script suivant pour qu’il corresponde à votre environnement :

@echo off
REM Create a new directory
md c:\wim

REM Mount the image
dism /mount-wim /wimfile:c:\bootmedia\sources\install.wim /index:1 /MountDir:c:\wim

REM Enable the feature
dism /image:c:\wim /enable-feature /all /featureName:Client-EmbeddedShellLauncher

REM Commit the change
dism /unmount-wim /MountDir:c:\wim /Commit

Pour plus d’informations sur DISM, consultez Qu’est-ce que la maintenance et la gestion des images de déploiement ?

WMI

Vous pouvez activer ou désactiver le lanceur d’interpréteur de commandes en appelant la SetEnabled fonction dans la classe WESL_UserSettingWMI (Windows Management Instrumentation).

Pour plus d’informations, consultez WESL_UserSetting.

Lancer différents interpréteurs de commandes pour différents comptes d’utilisateur

Par défaut, le lanceur d’interpréteur de commandes exécute l’interpréteur de commandes par défaut, qui est spécifié lorsque vous créez l’image du système d’exploitation au moment du design. L’interpréteur de commandes par défaut est défini sur le processeur de commandes Windows (Cmd.exe), mais vous pouvez spécifier n’importe quel fichier exécutable comme interpréteur de commandes par défaut.

Vous pouvez également configurer le lanceur d’interpréteur de commandes pour lancer un autre interpréteur de commandes pour des utilisateurs ou des groupes spécifiques si vous ne souhaitez pas exécuter l’interpréteur de commandes par défaut. Par exemple, vous pouvez configurer un appareil pour lancer un interpréteur de commandes d’application personnalisé pour les comptes invités, mais exécuter l’interpréteur de commandes Windows Explorer standard pour les comptes d’administrateur pour la maintenance de l’appareil.

Lorsque le compte connecté actuel appartient à deux groupes ou plus qui ont des configurations différentes définies pour chaque groupe, le lanceur d’interpréteur de commandes utilise la première configuration qu’il trouve. L’ordre de recherche n’étant pas défini, nous vous recommandons d’éviter d’affecter un utilisateur à plusieurs groupes avec différentes configurations de lanceur d’interpréteur de commandes.

Remarque

Si vous utilisez le fournisseur WMI pour configurer le lanceur d’interpréteur de commandes pour un utilisateur ou un groupe au moment de l’exécution, vous devez utiliser l’identificateur de sécurité (SID) pour ce principal de sécurité. Vous ne pouvez pas utiliser le nom d’utilisateur ou de groupe.

Pour plus d’informations sur les identificateurs de sécurité courants, consultez SIDs connus.

Comportement de démarrage et de sortie du lanceur d’interpréteur de commandes

Le lanceur d’interpréteur de commandes traite les Run clés de Registre et RunOnce avant de démarrer l’interpréteur de commandes personnalisé, de sorte que votre interpréteur de commandes personnalisé n’a pas besoin de gérer le démarrage automatique d’autres applications et services.

Le lanceur d’interpréteur de commandes gère également le comportement du système lorsque votre interpréteur de commandes personnalisé se ferme. Vous pouvez configurer le comportement de sortie de l’interpréteur de commandes si le comportement par défaut ne répond pas à vos besoins. Lorsqu’un interpréteur de commandes personnalisé se ferme, le lanceur d’interpréteur de commandes peut effectuer l’une des quatre actions suivantes :

• 0: Redémarrez l’interpréteur de commandes
• 1: Redémarrez l’appareil
• 2: arrêt de l’appareil
• 3: Ne rien faire

Important

Assurez-vous que votre application shell ne se ferme pas automatiquement et n’est pas fermée automatiquement par des fonctionnalités telles que filtre de boîte de dialogue, car cela peut entraîner un cycle infini de fermeture et de redémarrage, sauf si l’action de code de retour est définie pour ne rien faire.

Action de code de retour par défaut

Vous pouvez définir une action de code de retour par défaut pour le lanceur d’interpréteur de commandes avec le paramètre DefaultReturnCodeAction. Si vous ne modifiez pas la valeur initiale, l’action de code de retour par défaut est définie sur 0 (zéro), ce qui indique que le lanceur d’interpréteur de commandes redémarre l’interpréteur de commandes à la sortie de l’interpréteur de commandes.

Mapper le code de sortie à une action de lanceur d’interpréteur de commandes

Le lanceur d’interpréteur de commandes peut effectuer une action spécifique basée sur le code de sortie retourné par l’interpréteur de commandes. Pour tout code de sortie donné retourné par l’interpréteur de commandes, vous pouvez configurer l’action du lanceur d’interpréteur de commandes en mappant ce code de sortie à l’une des actions de sortie de l’interpréteur de commandes.

Si le code de sortie ne correspond pas à une valeur définie, le lanceur d’interpréteur de commandes effectue l’action de code de retour par défaut.

Par exemple, votre interpréteur de commandes peut retourner des valeurs de code de sortie de -1, 0, 1ou 255 en fonction de la façon dont l’interpréteur de commandes se ferme. Vous pouvez configurer le lanceur d’interpréteur de commandes pour :

• redémarrer l’appareil (1) lorsque l’interpréteur de commandes retourne un code de sortie de valeur -1
• redémarrer l’interpréteur de commandes (0) lorsque l’interpréteur de commandes retourne un code de sortie de valeur 0
• ne rien faire (3) lorsque l’interpréteur de commandes retourne un code de sortie de valeur 1
• arrêter l’appareil (2) lorsque l’interpréteur de commandes retourne un code de sortie de valeur 255

Votre mappage d’action de code de retour personnalisé se présente comme suit :

Code de sortie	Action
-1	1 (redémarrez l’appareil)
0	0 (redémarrer l’interpréteur de commandes)
1	3 (ne rien faire)
255	2 (arrêter l’appareil)

Définir votre interpréteur de commandes personnalisé avec le fournisseur de services de configuration Accès affecté

La configuration du lanceur d’interpréteur de commandes est effectuée à l’aide d’un fichier XML. Le fichier XML est appliqué à l’appareil via le csp Accès affecté, à l’aide de l’une des options suivantes :

• Une solution mobile Gestion des appareils (GPM), comme Microsoft Intune
• Packages de configuration
• Fournisseur WMI du pont MDM

Remarque

La configuration du lanceur d’interpréteur de commandes à l’aide du fournisseur csp à accès attribué active automatiquement le lanceur d’interpréteur de commandes sur l’appareil, si l’appareil le prend en charge.

Pour savoir comment configurer le fichier XML du lanceur d’interpréteur de commandes, consultez Créer un fichier de configuration de lanceur d’interpréteur de commandes.

Les instructions suivantes fournissent des détails sur la configuration de vos appareils. Sélectionnez l’option qui convient le mieux à vos besoins.

Intune/CSP

Vous pouvez configurer des appareils à l’aide d’une stratégie personnalisée avec le fournisseur csp AssignedAccess.

• Réglage:./Vendor/MSFT/AssignedAccess/ShellLauncher
• Valeur : contenu du fichier de configuration XML

Affectez la stratégie à un groupe qui contient en tant que membres les appareils que vous souhaitez configurer.

PPKG

Vous pouvez configurer le lanceur d’interpréteur de commandes en créant un package d’approvisionnement, puis en appliquant le package d’approvisionnement pendant le déploiement de l’image ou au moment de l’exécution :

• Si vous créez un support d’installation avec les paramètres du lanceur d’interpréteur de commandes inclus dans l’image, ou si vous appliquez un package d’approvisionnement pendant l’installation, vous devez activer shell Launcher sur le support d’installation avec DISM pour qu’un package d’approvisionnement s’applique correctement
• Si vous exécutez le package d’approvisionnement au moment de l’exécution, veillez à activer le lanceur d’interpréteur de commandes avant d’appliquer le package d’approvisionnement

Utilisez les paramètres suivants pour créer un package d’approvisionnement :

Chemin d'accès	Nom du paramètre	Valeur
SMISettings/ShellLauncher/	Enable	ACTIVER
SMISettings/ShellLauncher/	*	Cela dépend de paramètres spécifiques.

Appliquez le package d’approvisionnement aux appareils que vous souhaitez configurer.

PowerShell

Configurez vos appareils à l’aide de scripts PowerShell via le fournisseur WMI du pont MDM.

Important

Pour tous les paramètres d’appareil, le client WMI Bridge doit être exécuté en tant que compte SYSTEM (LocalSystem).

Pour tester le script PowerShell, vous pouvez :

1. Télécharger l’outil psexec
2. Ouvrez une invite de commandes avec élévation de privilèges et exécutez : psexec.exe -i -s powershell.exe
3. Exécuter le script dans la session PowerShell

$shellLauncherConfiguration = @"

# content of the XML configuration file

"@

$namespaceName="root\cimv2\mdm\dmmap"
$className="MDM_AssignedAccess"
$obj = Get-CimInstance -Namespace $namespaceName -ClassName $className
$obj.ShellLauncher = [System.Net.WebUtility]::HtmlEncode($shellLauncherConfiguration)
$obj = Set-CimInstance -CimInstance $obj -ErrorVariable cimSetError -ErrorAction SilentlyContinue
if($cimSetError) {
    Write-Output "An ERROR occurred. Displaying error record and attempting to retrieve error logs...`n"
    Write-Error -ErrorRecord $cimSetError[0]

    $timeout = New-TimeSpan -Seconds 30
    $stopwatch = [System.Diagnostics.Stopwatch]::StartNew()
    $eventLogFilterHashTable = @{ LogName='Microsoft-Windows-AssignedAccess/Admin' }
    do{
        $events = Get-WinEvent -FilterHashtable $eventLogFilterHashTable -ErrorAction Ignore
    } until ($events.Count -or $stopwatch.Elapsed -gt $timeout) # wait for the log to be available

    if($events.Count) {
        $events | ForEach-Object {
            Write-Output "$($_.TimeCreated) [$($_.LevelDisplayName.ToUpper())] $($_.Message -replace "`n|`r")"
        }
    } else {
        Write-Warning "Timed-out attempting to retrieve event logs..."
    }

    Exit 1
}

Write-Output "Successfully applied Shell Launcher configuration"

Pour plus d’informations, consultez Utiliser des scripts PowerShell avec le fournisseur de pont WMI.

Astuce

Pour obtenir des exemples pratiques, consultez démarrage rapide : configurer une expérience kiosque avec Shell Launcher.

Expérience de l'utilisateur

Une fois les paramètres appliqués, les utilisateurs configurés pour utiliser le lanceur d’interpréteur de commandes exécutent l’interpréteur de commandes personnalisé après la connexion.

Selon votre configuration, vous pouvez avoir un utilisateur pour se connecter automatiquement à l’appareil.

Supprimer le lanceur d’interpréteur de commandes

Voici les options pour supprimer le lanceur d’interpréteur de commandes, sélectionnez la méthode qui répond le mieux à vos besoins :

Intune/CSP

Annulez ou supprimez la stratégie qui contient la configuration.

PPKG

Désinstallez le package d’approvisionnement qui contient la configuration.

PowerShell

$namespaceName="root\cimv2\mdm\dmmap"
$className="MDM_AssignedAccess"
$obj = Get-CimInstance -Namespace $namespaceName -ClassName $className
$obj.Configuration = $null
Set-CimInstance -CimInstance $obj

Étapes suivantes

Découvrez comment configurer le fichier XML du lanceur d’interpréteur de commandes :

Créer un fichier de configuration du lanceur d’interpréteur de commandes