​

XBOX PC Remote Tools の FAQ とトラブルシューティング ガイド

​

よくある質問

​

Fully Managed と Lightweight のデバイス タイプの違いは?

​

アプリのバージョン番号はどこで確認できますか?

​

既知の問題、依存関係、および制限事項は?

​

既知の問題

1. PowerShell/DSC のセットアップが失敗する可能性があり、セットアップ中に XBOX PC Toolbox が予期せず終了することがあります。
   • 回避策: セットアップ中に PowerShell および DSC のプロビジョニングが失敗するを参照してください。
2. ドメイン参加済みのターゲット デバイス: Fully Managed モードでの OpenSSH 接続では、パスワード ベース認証のみがサポートされます (キー ベースの認証が推奨されますが利用できません)。ドメイン参加済みデバイスの代替として Lightweight プロビジョニングが利用できます。
   • 注記: この問題は Fully Managed モードを使用しているドメイン参加済みの Windows Pro デバイスに影響します。チームは将来の改善に向けて OpenSSH および Microsoft Entra ID チームと連携中です。
3. WinGet コマンド エラー (たとえば、winget search が失敗する)
   • 回避策: ターゲット デバイスを再起動します。製品チームがこの問題を調査中です。
4. Visual Studio デバッガーのパフォーマンス: XBOX PC Remote Debugger はまだパフォーマンスの最適化が行われていません。ローカル デバッグと比較してデバッグ時間が遅くなることが予想されます。将来のリリースでデバッガーのパフォーマンスが改善されます。
5. XBOX PC Remote Debugger は、複数回のデバッグ反復後に応答を停止する場合があります。約 50 回の反復ごとにターゲット デバイスを再起動してください。
   • 回避策: ターゲット デバイスを再起動してから、デバッガー セッションを再起動します。

​

依存関係と制限事項

• セットアップ中に両方のデバイスにインターネット アクセスが必要です。
• デバイスは同じローカル ネットワーク上にあり、相互に ping できる必要があります。
• XBOX PC Toolbox アプリは RETAIL サンドボックスでのみ利用できます。Microsoft Store からダウンロードするには、デバイスが RETAIL モードにあることを確認してください。
• サポートされるデバイス: Windows 10 または Windows 11 の Home または Pro エディション。
• セットアップ中は、両方のデバイスへの物理的なアクセスが必要です。
• セットアップには両方のデバイスで管理者アクセスが必要です。
• Microsoft Entra ID に参加済みのターゲット デバイスは Lightweight プロビジョニングでのみサポートされます。Entra 参加済みデバイスでは Fully Managed は利用できません。アプリはこれを自動的に検出し、セットアップ中に Fully Managed オプションを無効化します。

​

開発 PC からペアリングを解除すると、デバイスは完全に切断されますか?

​

デバイス接続情報はどこで確認できますか?

# PowerShell 7 ターミナルを開く
$env:ComputerName  # デバイス名
$env:Username      # ユーザー名  
ipconfig           # IP アドレス

​

デバイスの構成変更を確認するにはどうすればよいですか?

# DevPC 上で PowerShell 7 ターミナルを開く
dsc config test -f "$env:LOCALAPPDATA\XboxPCDeviceManager\config\devPC.dsc.yaml"

# ネットワーク (どちらのデバイスでも使用可能)  
dsc config test -f "$env:LOCALAPPDATA\XboxPCDeviceManager\config\network.dsc.yaml"

# TargetDevice 上で PowerShell 7 ターミナルを開く
dsc config test -f "$env:LOCALAPPDATA\XboxPCDeviceManager\config\targetDevice.dsc.yaml"

​

サンドボックスを確認および変更するにはどうすればよいですか?

​

セキュリティで保護されたチャネル セットアップで特定のネットワーク アダプターを選択するにはどうすればよいですか?

​

問題を報告するにはどうすればよいですか?

• オペレーティング システム のバージョン (Windows 10/11 のビルド)
• PowerShell のバージョン ($PSVersionTable) — XBOX Device Management PowerShell モジュールの問題向け
• ネットワーク構成 (Wi-Fi/イーサネット、企業/家庭)
• エラー メッセージ (正確なテキスト)
• 再現手順
• 使用したツール (XBOX PC Toolbox、XBOX Device Management PowerShell モジュール、wdRemote、または wdEndpoint)
• プレビュー バージョン

​

XBOX Device Management PowerShell モジュール (XDM) と wdRemote/wdEndpoint の違いは何ですか?

• XDM: セキュリティで保護された通信チャネルをセットアップします。
• wdRemote/wdEndpoint: これらのチャネル経由でゲームをデプロイして起動します。

​

XDM と wdRemote/wdEndpoint の両方が必要ですか?

​

なぜ最初は wdEndpoint を管理者として実行するのですか?

​

同じターゲット デバイスに複数のゲームをデプロイできますか?

​

デプロイ中にネットワーク接続が切断された場合はどうなりますか?

​

すべての通信は暗号化されていますか?

​

各タスクにどのツールを使用すべきですか?

• XBOX PC Toolbox: リモートでのデバイスのプロビジョニングと取得、セキュリティで保護されたチャネルのセットアップ、依存関係のインストール、およびデバイスの構成に使用します。
• 接続のテスト: ゲームをデプロイする前に XBOX PC Toolbox を使用します。
• リモート セッション: ターゲット デバイス上でコマンドを実行するには、XDM 対応のリモート セッションと PowerShell リモート処理を使用します。
• wdRemote/wdEndpoint: ゲームのデプロイ、テスト、および終了にこれらのツールを使用します。

​

これらのツールは任意の Windows ゲームで使用できますか?

​

これらのツールが使用するネットワーク ポートは何ですか?

• XDM: SSH (ポート 22)
• wdEndpoint: HTTPS (ポート 4275)

​

トラブルシューティング ガイド

​

企業ネットワーク環境でペアリングが失敗する

• 両方のデバイスがネットワーク上で相互に可視であることを確認してください。企業のファイアウォールやネットワーク セグメンテーションによって、デバイス間通信がブロックされる場合があります。
• デバイス間で次のポートが開いていることを確認してください: ポート 22 (OpenSSH) および ポート 4275 (Remote Iteration Tools)。
• ペアリングまたは接続を試みる前に、VPN を切断してください。
• 組織でデバイスの登録が必要な場合は、IT ポリシーに従ってデバイスが登録されていることを確認してください。

​

必要なツールのインストール時のエラー

• 回避策: %onedrive%/Documents/PowerShell/Modules/ からモジュール ディレクトリを削除して、もう一度お試しください。
• 原因: OneDrive が PowerShell モジュールのインストールを妨げる場合があります。

​

セットアップ中に PowerShell および DSC のプロビジョニングが失敗する

• 昇格されたターミナルを開き、次を実行します。

winget uninstall Microsoft.PowerShell
winget uninstall Microsoft.DSC
winget install Microsoft.PowerShell --installer-type wix
winget install Microsoft.DSC --installer-type zip

• これらの手順の後に DSC のインストール中にセットアップがハングした場合は、XBOX PC Toolbox を再起動して再試行してください。

​

OpenSSH エラー: kex_exchange_identification: read: Connection reset

• ターゲット デバイスを再起動します。
• デバイスがプライベート ネットワーク プロファイル上にあることを確認します。そうでない場合、ファイアウォールが接続をブロックする可能性があります。
• ローカル デバイス上の known_hosts ファイルが破損していないか確認します。

​

winget Microsoft PowerShell 7.5 のインストールが失敗する (0x8A150049)

• 回避策: PowerShell 7.6 (Visual Studio 2026 に付属) をアンインストールします。新しいバージョンがインストールの競合を引き起こしています。

​

ペアリング後の SSH 経由での winget 実行が失敗する

• 回避策: ターゲット デバイスで Repair-WinGetPackageManager を実行するか、ターゲット デバイスを再起動します。
• 原因: この問題は SSH 接続経由で発生します。

​

ハンドヘルド デバイス上でのゲーム デプロイが失敗する

• 回避策: デプロイ中にデバイスがスリープに入らないように、ターゲット デバイスの電源設定を調整します。デプロイ中は、デバイスのスリープ タイマーが長めに設定されているか、無効になっていることを確認します。
• 原因: XBOX PC Toolbox は DSC 経由でデバイスの電源設定を管理しなくなりました。積極的なスリープ タイマーを持つハンドヘルド デバイスでは、デプロイの途中でデバイスがスリープに入り、wdRemote が失敗する原因となります。

​

リモート ターゲット デバイスではペアリングが成功と表示されているのに、開発 PC で SSH 接続が失敗する

Get-Service sshd

Restart-Service sshd

ssh -o IdentitiesOnly=yes -i "$env:USERPROFILE\.ssh\XboxPCDeviceManagerKey" -o PreferredAuthentications=publickey user@target-ip "echo SUCCESS"

• このコマンドが 成功する 場合、ssh-agent が誤ったキーをキャッシュしています。以下の手順に従って修正してください。
• このコマンドが 失敗する 場合、問題はリモート ターゲット デバイス側にあります。さらに診断するには、OpenSSH ログの収集方法を参照してください。

# キャッシュされたすべてのキーをクリア
ssh-add -D

# エージェント サービスを再起動
Restart-Service ssh-agent

# 正しいキーのみを再追加
ssh-add "$env:USERPROFILE\.ssh\XboxPCDeviceManagerKey"

# ロードされているのが自分のキーだけであることを確認
ssh-add -l

# 接続をテスト
ssh -o PreferredAuthentications=publickey user@target-ip "echo SUCCESS"

​

OpenSSH ログの収集方法

1. メモ帳 を管理者として開きます。
2. ファイル C:\ProgramData\ssh\sshd_config を開きます。

3. # Logging で始まるセクションを見つけ、次のようになっているものを:
   # Logging
   #SyslogFacility AUTH
   #LogLevel INFO
   
   以下に変更します。
   # Logging
   SyslogFacility LOCAL0
   LogLevel Debug3
   
4. PowerShell ターミナルを管理者として開き、SSH サービスを再起動します。
   net stop sshd
   net start sshd
   
5. XBOX PC Toolbox アプリで問題を再現します。
6. C:\ProgramData\ssh\logs からログを収集します。開発チームと共有するため、フォルダーを .zip ファイルに圧縮します。
7. ログを収集した後、手順 3 で行った変更を元に戻し (各行の先頭に # を戻す)、手順 4 を使用して SSH サービスを再度再起動します。

​

関連項目

• XBOX PC Remote Tools の使用方法
• XBOX PC Remote Tools クイック スタート ガイド
• XBOX PC Remote Tools の概要