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

O Aplicativo do Windows para macOS fornece uma CLI (interface de linha de comando) que você pode usar para executar várias tarefas como uma 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 interno para executar os comandos da CLI.

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

Pré-requisitos

Antes de usar a CLI para o Aplicativo do Windows no macOS, você precisa instalar o Aplicativo do Windows 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 o Aplicativo windows:

1. Abra o aplicativo do Terminal em seu dispositivo macOS.

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

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

3. Nesse local, você pode executar o executável do Aplicativo Windows com módulos diferentes. 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 sã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 do 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. Por fim, você também pode percorrer cada comando de cada módulo para imprimir as informações de ajuda ao adicionar o nome do comando, seguido por help, conforme mostrado na saída da etapa anterior.

As informações de ajuda disponíveis no Aplicativo windows para cada módulo e comando fornecem instruções de uso, detalhes do parâmetro e exemplos de como usar cada comando.

Dicas de módulo

As dicas a seguir podem ajudá-lo a usar a CLI para o Aplicativo windows com mais eficiência:

• Para comandos que exigem uma ID exclusiva, você pode executar o comando no aplicativo do Terminal para gerar uma ID exclusiva.

• Para editar um indicador salvo, insira a mesma ID exclusiva que a que você usou para criar o indicador. O comando write atualiza o marcador existente com as novas informações.

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