Verwenden der macOS-Befehlszeilenschnittstelle für Windows-App

Windows-App für macOS bietet eine Befehlszeilenschnittstelle (CLI), mit der Sie verschiedene Aufgaben als Alternative zur Benutzeroberfläche ausführen können. Die Verwendung der CLI kann für einige Aufgaben effizienter sein, insbesondere wenn Sie dieselbe Aufgabe mehrmals ausführen oder einen Vorgang automatisieren müssen. Unter macOS verwenden Sie die integrierte Terminal-App , um die CLI-Befehle auszuführen.

In diesem Artikel erfahren Sie, wie Sie die macOS CLI für Windows-App verwenden.

Voraussetzungen

Bevor Sie die CLI für Windows-App unter macOS verwenden können, müssen Sie die Windows-App für macOS installieren. Weitere Informationen finden Sie unter "Erste Schritte mit der Windows-App" zum Herstellen einer Verbindung mit Geräten und Apps.

Ausführen von Befehlen

So führen Sie einen Befehl mit der CLI für Windows-App aus:

1. Öffnen Sie die Terminal-App auf Ihrem macOS-Gerät.

2. Der Standardpfad mit der ausführbaren Datei der Windows App lautet /Applications/Windows App.app/Contents/MacOS, wobei die Groß-/Kleinschreibung beachtet wird. Wechseln Sie zu diesem Verzeichnis, indem Sie den folgenden Befehl ausführen:

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

3. Von diesem Speicherort aus können Sie die ausführbare Datei der Windows App mit verschiedenen Modulen ausführen. Um zu überprüfen, ob Sie Befehle ausführen können, drucken Sie die Hilfemeldung, indem Sie den folgenden Befehl ausführen:

   ./'Windows App' --script
   

   Die Ausgabe lautet wie folgt:

   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. Die verfügbaren Module werden in der Ausgabe des vorherigen Befehls aufgeführt. Sie können die vollständige Syntax für jedes Modul abrufen, indem Sie den Modulnamen gefolgt von helphinzufügen, wie in der Ausgabe des vorherigen Schritts gezeigt. Um beispielsweise die Hilfeinformationen für das modul bookmark zu drucken, führen Sie den folgenden Befehl aus:

   ./'Windows App' --script bookmark help
   

   Die Ausgabe lautet wie folgt:

   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. Schließlich können Sie auch jeden Befehl für jedes Modul durchlaufen, um die Hilfeinformationen zu drucken. Fügen Sie hierfür den Befehlsnamen hinzu, gefolgt von help, wie in der Ausgabe des vorherigen Schritts zu sehen ist.

Die in der Windows-App für jedes Modul und jeden Befehl verfügbaren Hilfeinformationen enthalten Verwendungsanweisungen, Parameterdetails und Beispiele für die Verwendung der einzelnen Befehle.

Modultipps

Die folgenden Tipps helfen Ihnen bei der effektiveren Verwendung der CLI für Windows-App:

• Für Befehle, die eine eindeutige ID erfordern, können Sie den Befehl uuidgen in der Terminal-App ausführen, um eine eindeutige ID zu generieren.

• Um eine gespeicherte Textmarke zu bearbeiten, geben Sie dieselbe eindeutige ID wie die zum Erstellen der Textmarke verwendete ein. Der Befehl write aktualisiert die vorhandene Textmarke mit den neuen Informationen.

• Für das feed-Modul kann nur eine Remotedesktopdienste-Umgebung hinzugefügt werden, die eine Authentifizierung mit Benutzernamen und Kennwort verwendet. Sie können keine Azure Virtual Desktop-, Windows 365- oder Microsoft Dev Box-Ressourcen hinzufügen, da sie anspruchsbasierte Authentifizierung verwendet.