Usar a interface de linha de comando do macOS para Windows App

O Aplicativo do Windows para macOS fornece uma interface de linha de comando (CLI) que você pode usar para executar várias tarefas como alternativa à interface do usuário. Usar a CLI pode ser mais eficiente para algumas tarefas, especialmente quando você precisa executar a mesma tarefa várias vezes ou automatizar uma tarefa. No macOS, você usa o aplicativo Terminal integrado para executar os comandos da CLI.

Este artigo mostra como usar a CLI do macOS para Windows App.

Pré-requisitos

Antes de poder usar a CLI para Windows App no macOS, você precisa instalar o Windows App para macOS. Para obter mais informações, consulte Introdução ao Aplicativo Windows para se conectar a dispositivos e aplicativos.

Executar comandos

Para executar um comando usando a CLI para Windows App:

1. Abra a aplicação Terminal no seu dispositivo macOS.

2. O caminho padrão que contém o executável do Aplicativo do Windows é /Applications/Windows App.app/Contents/MacOS, que é sensível a maiúsculas e minúsculas. Mude para este diretório executando o seguinte comando:

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

3. A partir deste local, você pode executar o executável do Aplicativo do Windows com diferentes módulos. Para verificar se você pode executar comandos, imprima a mensagem de ajuda executando o seguinte comando:

   ./'Windows App' --script
   

   A saída é a seguinte:

   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. Os módulos disponíveis estão listados na saída do comando anterior. Você pode obter a sintaxe completa para cada módulo adicionando o nome do módulo, seguido por help, conforme mostrado na saída da etapa anterior. Por exemplo, para imprimir as informações de ajuda para o módulo bookmark, execute o seguinte comando:

   ./'Windows App' --script bookmark help
   

   A saída é a seguinte:

   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. Finalmente, você também pode percorrer cada comando para cada módulo para imprimir as informações de ajuda adicionando o nome do comando, seguido de help, como mostrado na saída da etapa anterior.

As informações de ajuda disponíveis na Aplicação Windows para cada módulo e comando fornecem instruções de utilização, detalhes de parâmetros e exemplos de como utilizar cada comando.

Dicas do módulo

As dicas a seguir podem ajudá-lo a usar a CLI para Windows App de forma mais eficaz:

• Para comandos que exigem um ID exclusivo, pode executar o comando uuidgen na aplicação Terminal para gerar um ID exclusivo.

• Para editar um marcador guardado, introduza o mesmo ID exclusivo que utilizou para criar o marcador. O comando write atualiza o marcador existente com as novas informações.

• Para o módulo feed, apenas um ambiente de Serviços de Área de Trabalho Remota que usa autenticação de nome de usuário e senha pode ser adicionado. Não é possível adicionar recursos da Área de Trabalho Virtual do Azure, Windows 365 ou Microsoft Dev Box porque ele usa autenticação baseada em declarações.