interface de ligne de commande Bac à sable Windows

À compter de Windows 11 version 24H2, l’interface de ligne de commande (CLI) Windows offre des outils puissants pour créer, gérer et contrôler des bacs à sable, exécuter des commandes et partager des dossiers au sein de sessions de bac à sable. Cette fonctionnalité est particulièrement utile pour l’écriture de scripts, l’automatisation des tâches et l’amélioration des workflows de développement. Dans cette section, vous allez découvrir le fonctionnement de l’interface CLI Bac à sable Windows, avec des exemples montrant comment utiliser chaque commande pour améliorer votre processus de développement.

Paramètres courants :

• --raw: met en forme toutes les sorties au format JSON.
• -?, -h, --help: afficher les informations d’aide et d’utilisation

Démarrer

La commande start crée et lance un nouveau bac à sable. La commande retourne l’ID de bac à sable, qui est un identificateur unique pour le bac à sable. L’ID de bac à sable peut être utilisé pour faire référence au bac à sable dans d’autres commandes.

• --id <id>: ID de l’environnement Bac à sable Windows.
• --c, --config <config>: chaîne mise en forme avec les paramètres qui doivent être utilisés pour créer l’environnement Bac à sable Windows.

Exemples :

• Créez un environnement Bac à sable Windows avec les paramètres par défaut :

  wsb start
  

• Créez un environnement Bac à sable Windows avec une configuration personnalisée :

  wsb start --config "<Configuration><Networking>Disabled</Networking></Configuration>"
  

List

La commande list affiche un tableau qui affiche les informations des sessions Bac à sable Windows en cours d’exécution pour l’utilisateur actuel. Le tableau inclut l’ID du bac à sable. Le status peut être en cours d’exécution ou arrêté. La durée d’activité correspond à la durée d’exécution du bac à sable.

wsb list

Exec

La commande exec exécute une commande dans le bac à sable. La commande prend deux arguments : l’ID de bac à sable et la commande à exécuter. La commande peut être une commande intégrée ou un fichier exécutable. La commande exec exécute la commande dans le bac à sable et retourne le code de sortie. La commande exec peut également prendre des arguments facultatifs qui sont passés au processus démarré dans le bac à sable.

Remarque

Actuellement, il n’existe aucune prise en charge des E/S de processus, ce qui signifie qu’il n’existe aucun moyen de récupérer la sortie d’une exécution de commande dans le bac à sable.

Une session utilisateur active est nécessaire pour exécuter une commande dans le contexte de l’utilisateur actuellement connecté. Par conséquent, avant d’exécuter cette commande, une connexion Bureau à distance doit être établie. Cette opération peut être effectuée à l’aide de la commande connect .

• --id <id>(OBLIGATOIRE) : ID de l’environnement Bac à sable Windows.
• -c, --command <command>(OBLIGATOIRE) : commande à exécuter dans Bac à sable Windows.
• -r, --run-as <ExistingLogin|System> (OBLIGATOIRE) : spécifie le contexte utilisateur dans lequel exécuter la commande. Si l’option Système est sélectionnée, la commande s’exécute dans le contexte système. Si l’option ExistingLogin est sélectionnée, la commande s’exécute dans la session utilisateur active ou échoue s’il n’y a pas de session utilisateur active.
• -d, --working-directory <directory>: répertoire dans lequel exécuter la commande.

wsb exec –-id 12345678-1234-1234-1234-1234567890AB -c app.exe -r System

Stop

La commande d’arrêt arrête l’exécution d’une session Bac à sable Windows. La commande prend l’ID de bac à sable comme argument.

La commande stop met fin au processus de bac à sable et libère les ressources allouées au bac à sable. La commande stop ferme également la fenêtre qui affiche le bureau du bac à sable.

wsb stop --id 12345678-1234-1234-1234-1234567890AB

Share

La commande de partage partage un dossier hôte avec le bac à sable. La commande prend trois arguments : l’ID de bac à sable, le chemin d’accès de l’hôte et le chemin du bac à sable. Le chemin d’accès de l’hôte doit être un dossier. Le chemin du bac à sable peut être un dossier existant ou nouveau. Une option Supplémentaire --allow-write peut être utilisée pour autoriser ou interdire l’écriture de l’environnement Bac à sable Windows dans le dossier.

• --id <id>(OBLIGATOIRE) : ID de l’environnement Bac à sable Windows.
• -f, --host-path <host-path> (OBLIGATOIRE) : chemin d’accès au dossier partagé à partir de l’hôte.
• -s, --sandbox-path <sandbox-path>(OBLIGATOIRE) : chemin d’accès au dossier dans le Bac à sable Windows.
• -w, --allow-write: s’il est spécifié, l’environnement Bac à sable Windows est autorisé à écrire dans le dossier partagé.

wsb share --id 12345678-1234-1234-1234-1234567890AB -f C:\host\folder -s C:\sandbox\folder --allow-write

Connecter

La commande connect démarre une session à distance dans le bac à sable. La commande prend l’ID de bac à sable comme argument. La commande connect ouvre une nouvelle fenêtre avec une session Bureau à distance. La commande connect permet à l’utilisateur d’interagir avec le bac à sable à l’aide de la souris et du clavier.

wsb connect --id 12345678-1234-1234-1234-1234567890AB

Adresse IP

La commande ip affiche l’adresse IP du bac à sable. La commande prend l’ID de bac à sable comme argument.

wsb ip --id 12345678-1234-1234-1234-1234567890AB