接続前の準備
Windows 側で RDP サービスを有効にし、リモートログインが許可されたアカウントを用意してください。Mac からサーバーに到達できるネットワークも必要です。必要に応じて LAN や VPN を使用します。クライアントのインストールだけで Windows の RDP サービスが有効になるわけではありません。
ダウンロードページで Mac のチップに合うパッケージを選びます。Apple シリコン版は macOS 13 以降、Intel 版は macOS 12 以降が必要です。ダウンロードの提供状況も同ページで確認してください。対応する DMG を取得し、rdp-cli を「アプリケーション」にドラッグします。次のコマンドで CLI を設定します。見つからない場合は新しいターミナルを開くか、アプリ内の実行ファイルをフルパスで指定してください。DMG には単体の実行ファイルも含まれます。
/Applications/rdp-cli.app/Contents/MacOS/rdp-cli install-cli
rdp-cli --help
セッションを作成する
サンプルのアドレスと USER を、利用を許可されたサーバーとアカウントに置き換えます。macOS のターミナル（zsh）に次のコマンドを貼り付け、表示される案内に従ってパスワードを入力し、Return キーを押します。パスワードは画面に表示されず、rdp-cli に渡した後、入力は自動的に終了します。
ドメインアカウントでは --domain DOMAIN を追加します。保存済み資格情報なら --credential-ref CREDENTIAL を代わりに使い、複数のパスワード指定方法を併用しないでください。現在の RDP 証明書ポリシーの既定値は ignore です。rdp-cli connect --help で確認し、環境に合った検証を設定します。
応答 JSON の状態やエラーを読み、data.session を保存します。接続済みでもログイン画面や「ようこそ」が表示されることがあります。
read -r -s "rdp_password?パスワード: "
printf '\n'
printf '%s' "$rdp_password" | rdp-cli connect --host 192.0.2.20 --user USER --password-stdin
unset rdp_password
実際の画面を確認する
SESSION を返されたセッション値に置き換え、作成された first-screen.png を開きます。応答には data.observation も含まれます。この画像に基づいて入力するときに使ってください。再接続、操作権の変更、ディスプレイ構成の変更後は、新しい観測が必要です。
rdp-cli screenshot --session SESSION --out first-screen.png
見たいときだけウィンドウを開く
リモート接続にローカルウィンドウは必要ありません。進行状況を見たいときは、同じセッションのビューアーを開きます。最初は閲覧専用です。操作ボタンで一時停止や引き継ぎができます。閲覧専用ウィンドウを閉じても接続は続き、操作権を持つウィンドウを閉じると入力が一時停止します。
rdp-cli watch --session SESSION --viewer window
接続できない場合
アドレス、ネットワーク、RDP サービス、アカウントの権限を確認します。パスワードを繰り返し送る前に、構造化エラーを読んでください。古いサーバー向けの互換設定は必要な接続に限定します。既存セッションは rdp-cli status --session SESSION で状態を確認できます。