次の方法で共有


Windows アプリの macOS コマンド ライン インターフェイスを使用する

Windows App for macOS には、ユーザー インターフェイスの代わりにさまざまなタスクを実行するために使用できるコマンド ライン インターフェイス (CLI) が用意されています。 CLI を使用すると、特に同じタスクを複数回実行したり、タスクを自動化したりする必要がある場合に、一部のタスクの方が効率的になります。 macOS では、組み込みの ターミナル アプリを使用して CLI コマンドを実行します。

この記事では、Windows アプリ用の macOS CLI を使用する方法について説明します。

前提 条件

macOS で Windows アプリ用 CLI を使用する前に、macOS 用 Windows アプリをインストールする必要があります。 詳細については、「 Windows アプリを使ってデバイスとアプリに接続する」を参照してください。

コマンドを実行する

Windows アプリ用 CLI を使用してコマンドを実行するには:

  1. macOS デバイスで ターミナル アプリを開きます。

  2. Windows アプリの実行ファイルを含む既定のパスは /Applications/Windows App.app/Contents/MacOS であり、大文字と小文字が区別されます。 次のコマンドを実行して、このディレクトリに移動します。

    cd '/Applications/Windows App.app/Contents/MacOS'
    
  3. この場所から、さまざまなモジュールで Windows アプリの実行可能ファイルを実行できます。 コマンドを実行できることを確認するには、次のコマンドを実行してヘルプ メッセージを出力します。

    ./'Windows App' --script
    

    出力は次のとおりです。

    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. 使用可能なモジュールは、前のコマンドの出力に一覧表示されます。 前の手順の出力に示すように、モジュール名を追加し、その後に helpを追加することで、各モジュールの完全な構文を取得できます。 たとえば、bookmark モジュールのヘルプ情報を出力するには、次のコマンドを実行します。

    ./'Windows App' --script bookmark help
    

    出力は次のとおりです。

    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. 最後に、前の手順の出力に示すように、各モジュールの各コマンドを反復処理して、コマンド名を追加し、その後に helpを追加してヘルプ情報を出力することもできます。

各モジュールとコマンドの Windows アプリで使用できるヘルプ情報には、使用方法、パラメーターの詳細、各コマンドの使用方法の例が記載されています。

モジュールのヒント

次のヒントは、Windows アプリ用 CLI をより効果的に使用するのに役立ちます。

  • 一意の ID を必要とするコマンドの場合は、uuidgen アプリでコマンドを実行して、一意の ID を生成できます。

  • 保存したブックマークを編集するには、ブックマークの作成に使用した ID と同じ一意の ID を入力します。 write コマンドは、既存のブックマークを新しい情報で更新します。

  • feed モジュールでは、ユーザー名とパスワード認証を使用するリモート デスクトップ サービス環境のみを追加できます。 要求ベースの認証を使用するため、Azure Virtual Desktop、Windows 365、または Microsoft Dev Box のリソースを追加することはできません。