Utiliser l’interface de ligne de commande macOS pour l’application Windows

L’application Windows pour macOS fournit une interface de ligne de commande (CLI) que vous pouvez utiliser pour effectuer différentes tâches en guise d’alternative à l’interface utilisateur. L’utilisation de l’interface CLI peut être plus efficace pour certaines tâches, en particulier lorsque vous devez effectuer la même tâche plusieurs fois ou automatiser une tâche. Sur macOS, vous utilisez l’application Terminal intégrée pour exécuter les commandes CLI.

Cet article vous montre comment utiliser l’interface CLI macOS pour l’application Windows.

Conditions préalables

Avant de pouvoir utiliser l’interface CLI pour l’application Windows sur macOS, vous devez installer l’application Windows pour macOS. Pour plus d’informations, consultez Prise en main de l’application Windows pour se connecter à des appareils et des applications.

Exécuter des commandes

Pour exécuter une commande à l’aide de l’interface CLI pour l’application Windows :

1. Ouvrez l’application terminal sur votre appareil macOS.

2. Le chemin par défaut qui contient l’exécutable de l’application Windows est /Applications/Windows App.app/Contents/MacOS, sensible à la casse. Accédez à ce répertoire en exécutant la commande suivante :

   cd '/Applications/Windows App.app/Contents/MacOS'
   

3. À partir de cet emplacement, vous pouvez exécuter l’exécutable de l’application Windows avec différents modules. Pour vérifier que vous pouvez exécuter des commandes, imprimez le message d’aide en exécutant la commande suivante :

   ./'Windows App' --script
   

   La sortie est la suivante :

   Usage:
   
     --script <module> <parameters>
   
     Modules:
   
       bookmark  Create, edit or delete a connection bookmark.
       feed      Subscribe to a resource feed, or edit or delete a subscription.
       gateway   Create, edit or delete a Remote Desktop gateway.
       defaults  Display client settings configurable through the defaults command
   
     To get help for a specific module:
   
       --script <module> help
   
     Examples:
   
       --script bookmark help
       --script feed help
       --script gateway help
   

4. Les modules disponibles sont répertoriés dans la sortie de la commande précédente. Vous pouvez obtenir la syntaxe complète de chaque module en ajoutant le nom du module, suivi de help, comme indiqué dans la sortie de l’étape précédente. Par exemple, pour imprimer les informations d’aide du module bookmark, exécutez la commande suivante :

   ./'Windows App' --script bookmark help
   

   La sortie est la suivante :

   Usage:
   
     --script bookmark <command> <unique ID> <parameter>
   
     Commands:
   
       write   Create or edit a connection bookmark.
       delete  Delete a connection bookmark.
       list    List all stored bookmarks.
       export  Output a bookmark as a formatted string.
   
     To get help for a specific command:
   
       --script bookmark <command> help
   
     Examples:
   
       --script bookmark write help
       --script bookmark delete help
       --script bookmark list help
       --script bookmark export help
   

5. Enfin, vous pouvez également effectuer une itération dans chaque commande pour chaque module pour imprimer les informations d’aide en ajoutant le nom de la commande, suivi de help, comme indiqué dans la sortie de l’étape précédente.

Les informations d’aide disponibles dans l’application Windows pour chaque module et commande fournissent des instructions d’utilisation, des détails de paramètre et des exemples d’utilisation de chaque commande.

Conseils sur le module

Les conseils suivants peuvent vous aider à utiliser plus efficacement l’interface CLI pour l’application Windows :

• Pour les commandes qui nécessitent un ID unique, vous pouvez exécuter la commande dans l’application Terminal pour générer un ID unique.

• Pour modifier un signet enregistré, entrez le même ID unique que celui que vous avez utilisé pour créer le signet. La commande write met à jour le signet existant avec les nouvelles informations.

• Pour le module feed, seul un environnement services Bureau à distance qui utilise l’authentification par nom d’utilisateur et mot de passe peut être ajouté. Vous ne pouvez pas ajouter de ressources Azure Virtual Desktop, Windows 365 ou Microsoft Dev Box, car elle utilise l’authentification basée sur les revendications.