リモート マシンの UWP アプリを Visual Studio からデバッグするDebug UWP apps on remote machines from Visual Studio

Visual Studio を使用して、別のコンピューターまたはデバイス上のユニバーサル Windows プラットフォーム (UWP) アプリを実行、デバッグ、プロファイリング、テストすることができます。You can use Visual Studio to run, debug, profile, and test a Universal Windows Platform (UWP) app on another computer or device. リモート マシンで UWP アプリを実行するのは、Visual Studio コンピューターで、タッチ、地理的位置、物理的な方向などの UWP 固有の機能がサポートされていない場合に特に便利です。Running the UWP app on a remote machine is especially helpful when the Visual Studio computer does not support UWP-specific functionality like touch, geo-location, or physical orientation.

必要条件Prerequisites

リモート デバイスの UWP アプリを Visual Studio からデバッグするには:To debug a UWP app on a remote device from Visual Studio:

  • Visual Studio プロジェクトは、リモート デバッグ用に構成されている必要があります。The Visual Studio project must be configured for remote debugging.
  • リモート マシンと Visual Studio コンピューターは、ネットワークを介して接続されているか、USB またはイーサネット ケーブルを使って直接接続されている必要があります。The remote machine and the Visual Studio computer must be connected over a network, or connected directly through a USB or Ethernet cable. インターネットを介したデバッグはサポートされません。Debugging over the internet is not supported.
  • Visual Studio コンピューターとリモート マシンの両方で、開発者モードを有効にする必要があります。You must turn on developer mode on both the Visual Studio computer and the remote machine.
  • リモート コンピューターで、Remote Tools for Visual Studio を実行している必要があります。Remote computers must be running the Remote Tools for Visual Studio.

リモート デバッグ用に Visual Studio プロジェクトを構成するConfigure a Visual Studio project for remote debugging

プロジェクトのプロパティを使用して、接続先のリモート デバイスを指定します。You use the project Properties to specify the remote device to connect to. 設定は、プログラミング言語によって異なります。The settings differ depending on the programming language.

注意事項

Windows 10 リモート接続の場合、既定では、プロパティ ページの [認証の種類][ユニバーサル (暗号化されていないプロトコル)] が設定されます。By default, the property page sets Universal (Unencrypted Protocol) as the Authentication Type for Windows 10 remote connections. リモート デバッガーに接続するには、場合によって [認証] を設定する必要があります。You may need to set No Authentication to connect to the remote debugger. [ユニバーサル (暗号化されていないプロトコル)] および [認証なし] プロトコルにはネットワーク セキュリティがないため、開発用コンピューターとリモート マシンの間で受け渡されるデータは脆弱です。Universal (Unencrypted Protocol) and No Authentication protocols have no network security, so data passed between the development and remote machines is vulnerable. これらの認証の種類は、悪意のあるトラフィックや敵対的なトラフィックのリスクがないことが確実な信頼されるネットワークに対してのみ選択してください。Choose these authentication types only for trusted networks that you are sure are not at risk from malicious or hostile traffic.

[認証の種類][Windows 認証] を選択した場合は、デバッグ時にリモート マシンにサインインする必要があります。If you choose Windows Authentication for the Authentication Type, you will need to sign in to the remote machine when debugging. リモート デバッガーも、Visual Studio コンピューターと同じユーザー アカウントを使用して Windows 認証 モードで実行されている必要があります。The remote debugger must also be running under Windows Authentication mode, with the same user account as on the Visual Studio machine.

リモート デバッグ用に C# または Visual Basic プロジェクトを構成するConfigure a C# or Visual Basic project for remote debugging

  1. Visual Studio のソリューション エクスプローラーで C# または Visual Basic プロジェクトを選択し、 [プロパティ] アイコンを選択して、Alt+Enter を押すか、右クリックして [プロパティ] を選択します。Select the C# or Visual Basic project in Visual Studio Solution Explorer and select the Properties icon, press Alt+Enter, or right-click and choose Properties.

  2. [デバッグ] タブを選択します。Select the Debug tab.

  3. [ターゲット デバイス] で、リモート コンピューターの場合は [リモート コンピューター] 、直接接続されている Windows Mobile 10 デバイスの場合は [デバイス] を選択します。Under Target device, select Remote Machine for a remote computer, or Device for a direct-connected Windows Mobile 10 device.

  4. リモート マシンの場合は、[リモート接続] ダイアログ ボックス[リモート コンピューター] フィールドにネットワーク名または IP アドレスを入力するか、 [検索] を選択してデバイスを検索します。For a remote machine, enter the network name or IP address in the Remote machine field, or select Find to search for the device in the Remote Connections dialog box.

    リモート デバッグ用のマネージド プロジェクト プロパティManaged project properties for remote debugging

リモートデバッグ用に C++ プロジェクトを構成するConfigure a C++ project for remote debugging

  1. Visual Studio のソリューション エクスプローラーで C++ プロジェクトを選択し、 [プロパティ] アイコンを選択して、Alt+Enter を押すか、右クリックして [プロパティ] を選択します。Select the C++ project in Visual Studio Solution Explorer and select the Properties icon, press Alt+Enter, or right-click and choose Properties.

  2. [デバッグ] タブを選択します。Select the Debugging tab.

  3. [起動するデバッガー] で、リモート コンピューターの場合は [リモート コンピューター] 、直接接続されている Windows Mobile 10 デバイスの場合は [デバイス] を選択します。Under Debugger to launch, select Remote Machine for a remote computer, or Device for a direct-connected Windows Mobile 10 device.

  4. リモート マシンの場合は、[リモート接続] ダイアログ ボックス[コンピューター名] フィールドにネットワーク名または IP アドレスを入力または選択するか、ドロップダウンして [検索] を選択してデバイスを検索します。For a remote machine, enter or select the network name or IP address in the Machine Name field, or drop down and select Locate to search for the device in the Remote Connections dialog box.

    リモート デバッグ用の C++ プロジェクト プロパティC++ project properties for remote debugging

[リモート接続] ダイアログ ボックスを使用するUse the Remote Connections dialog box

[リモート接続] ダイアログ ボックスでは、特定のリモート コンピューター名または IP アドレスを検索したり、最新の情報に更新する丸い矢印のアイコンを選択して接続を自動検出したりすることができます。In the Remote Connections dialog box, you can search for a specific remote computer name or IP address, or auto-detect connections by selecting the rounded-arrow refresh icon. このダイアログ ボックスでは、リモート デバッガーを現在実行しているローカル サブネット上のデバイスのみが検索されます。The dialog searches only devices on the local subnet that are currently running the remote debugger. [リモート接続] ダイアログ ボックスですべてのデバイスを検出できるわけではありません。Not all devices can be detected in the Remote Connections dialog box.

[リモート接続] ダイアログ ボックスRemote Connection dialog box

ヒント

名前を指定してリモート デバイスに接続できない場合は、IP アドレスを使用してみてください。If you can't connect to a remote device by name, try using its IP address. IP アドレスを確認するには、リモート デバイスのコマンド ウィンドウに「ipconfig」と入力します。To determine the IP address, on the remote device, enter ipconfig in a command window. IP アドレスは IPv4 アドレスとして表示されます。The IP address appears as IPv4 Address.

Remote Tools for Visual Studio をダウンロードしてインストールするDownload and install the Remote Tools for Visual Studio

Visual Studio でリモート コンピューター上のアプリをデバッグするには、リモート コンピューターで Remote Tools for Visual Studio が実行されている必要があります。For Visual Studio to debug apps on a remote computer, the remote computer must be running the Remote Tools for Visual Studio.

  • Windows Mobile 10 デバイスでは、リモート ツールは必要なく、サポートもされていません。Windows Mobile 10 devices do not require or support the remote tools.
  • Creators Update (バージョン 1703) 以降を実行している Windows 10 PC、Windows 10 の Xbox、IoT、HoloLens デバイスでアプリを展開するとリモート ツールが自動的にインストールされます。Windows 10 PCs running Creator's Update (version 1703) and later, Windows 10 Xbox, IoT, and HoloLens devices install the remote tools automatically when you deploy the app.
  • Creators Update より前の Windows 10 PC では、デバッグを開始する前に、リモート コンピューターでリモート ツールを手動でダウンロードしてインストールし、実行する必要があります。On pre-Creator's Update Windows 10 PCs, you must manually download, install, and be running the remote tools on the remote computer before you start debugging.

リモート ツールをダウンロードしてインストールするには:To download and install the remote tools:

Visual Studio マシンではなく、デバッグするリモート デバイスまたはサーバーで、次の表のリンクから適切なバージョンのリモート ツールをダウンロードしてインストールします。On the remote device or server that you want to debug on, rather than the Visual Studio machine, download and install the correct version of the remote tools from the links in the following table.

  • お使いのバージョンの Visual Studio 用の最新のリモート ツールをダウンロードします。Download the most recent remote tools for your version of Visual Studio. 最新バージョンのリモート ツールは、以前のバージョンの Visual Studio と互換性がありますが、以前のバージョンのリモート ツールは、以降のバージョンの Visual Studio と互換性がありませんThe latest remote tools version is compatible with earlier Visual Studio versions, but earlier remote tools versions aren't compatible with later Visual Studio versions. (たとえば、Visual Studio 2017 を使用している場合、Visual Studio 2017 用のリモート ツールの最新の更新プログラムをダウンロードします。(For example, if you are using Visual Studio 2017, download the latest update of the remote tools for Visual Studio 2017. このシナリオでは、Visual Studio 2019 用のリモート ツールをダウンロードしないでください)。In this scenario, do not download the remote tools for Visual Studio 2019.)
  • インストール先のマシンと同じアーキテクチャを持つリモート ツールをダウンロードします。Download the remote tools with the same architecture as the machine you're installing them on. たとえば、64 ビットのオペレーティング システムを実行しているリモート コンピューターで 32 ビット アプリをデバッグする場合は、64 ビットのリモート ツールをインストールします。For example, if you want to debug a 32-bit app on a remote computer running a 64-bit operating system, install the 64-bit remote tools.
バージョンVersion LinkLink メモNotes
Visual Studio 2019Visual Studio 2019 リモート ツールRemote tools すべてのバージョンの Visual Studio 2019 と互換性があります。Compatible with all Visual Studio 2019 versions. デバイスのオペレーティング システム (x86、x64、または ARM64) に一致するバージョンをダウンロードします。Download the version matching your device operating system (x86, x64, or ARM64). Windows Server の場合、リモート ツールのダウンロードについては、ファイルのダウンロードのブロック解除に関するページを参照してください。On Windows Server, see Unblock the file download for help downloading the remote tools.
Visual Studio 2017Visual Studio 2017 リモート ツールRemote tools すべてのバージョンの Visual Studio 2017 と互換性があります。Compatible with all Visual Studio 2017 versions. デバイスのオペレーティング システム (x86、x64、または ARM64) に一致するバージョンをダウンロードします。Download the version matching your device operating system (x86, x64, or ARM64). Windows Server の場合、リモート ツールのダウンロードについては、ファイルのダウンロードのブロック解除に関するページを参照してください。On Windows Server, see Unblock the file download for help downloading the remote tools.
Visual Studio 2015Visual Studio 2015 リモート ツールRemote tools Visual Studio 2015 用のリモート ツールは My.VisualStudio.com で入手できます。Remote tools for Visual Studio 2015 are available from My.VisualStudio.com. メッセージが表示されたら、無料の Visual Studio Dev Essentials プログラムに参加するか、または Visual Studio サブスクリプション ID でサインインします。If prompted, join the free Visual Studio Dev Essentials program, or sign in with your Visual Studio subscription ID. Windows Server の場合、リモート ツールのダウンロードについては、ファイルのダウンロードのブロック解除に関するページを参照してください。On Windows Server, see Unblock the file download for help downloading the remote tools.
Visual Studio 2013Visual Studio 2013 リモート ツールRemote tools Visual Studio 2013 ドキュメントのダウンロード ページDownload page in Visual Studio 2013 documentation
Visual Studio 2012Visual Studio 2012 リモート ツールRemote tools Visual Studio 2012 ドキュメントのダウンロード ページDownload page in Visual Studio 2012 documentation
バージョンVersion LinkLink メモNotes
Visual Studio 2017Visual Studio 2017 リモート ツールRemote tools すべてのバージョンの Visual Studio 2017 と互換性があります。Compatible with all Visual Studio 2017 versions. デバイスのオペレーティング システム (x86、x64、または ARM64) に一致するバージョンをダウンロードします。Download the version matching your device operating system (x86, x64, or ARM64). Windows Server の場合、リモート ツールのダウンロードについては、ファイルのダウンロードのブロック解除に関するページを参照してください。On Windows Server, see Unblock the file download for help downloading the remote tools. 最新バージョンのリモート ツールについては、Visual Studio 2019 ドキュメントを開きます。For the most recent version of the remote tools, open the Visual Studio 2019 doc.
Visual Studio 2015Visual Studio 2015 リモート ツールRemote tools Visual Studio 2015 用のリモート ツールは My.VisualStudio.com で入手できます。Remote tools for Visual Studio 2015 are available from My.VisualStudio.com. メッセージが表示されたら、無料の Visual Studio Dev Essentials プログラムに参加するか、または Visual Studio サブスクリプション ID でサインインします。If prompted, join the free Visual Studio Dev Essentials program, or sign in with your Visual Studio subscription ID. Windows Server の場合、リモート ツールのダウンロードについては、ファイルのダウンロードのブロック解除に関するページを参照してください。On Windows Server, see Unblock the file download for help downloading the remote tools.
Visual Studio 2013Visual Studio 2013 リモート ツールRemote tools Visual Studio 2013 ドキュメントのダウンロード ページDownload page in Visual Studio 2013 documentation
Visual Studio 2012Visual Studio 2012 リモート ツールRemote tools Visual Studio 2012 ドキュメントのダウンロード ページDownload page in Visual Studio 2012 documentation

リモート デバッガーを実行するには、リモート ツールをインストールするのではなく、msvsmon.exe をリモート コンピューターにコピーします。You can run the remote debugger by copying msvsmon.exe to the remote computer, rather than installing the remote tools. ただし、リモート デバッガー構成ウィザード (rdbgwiz.exe) は、リモート ツールをインストールした場合にのみ使用できます。However, the Remote Debugger Configuration Wizard (rdbgwiz.exe) is available only when you install the remote tools. リモート デバッガーをサービスとして実行する場合は、構成にウィザードの使用が必要になることがあります。You may need to use the wizard for configuration if you want to run the remote debugger as a service. 詳細については、「(オプション) リモート デバッガーをサービスとして構成する」を参照してください。For more information, see (Optional) Configure the remote debugger as a service.

注意

  • ARM デバイスで Windows 10 アプリをデバッグするには、最新バージョンのリモート ツールで使用できる ARM64 を使用します。To debug Windows 10 apps on ARM devices, use ARM64, which is available with the latest version of the remote tools.
  • Windows RT デバイスで Windows 10 アプリをデバッグするには、ARM を使用します。これは、Visual Studio 2015 リモート ツールのダウンロードでのみ使用できます。To debug Windows 10 apps on Windows RT devices, use ARM, which is available only in the Visual Studio 2015 remote tools download.

リモート ツールを構成するConfigure the remote tools

  1. リモート コンピューター上の [スタート] メニューで、 [リモート デバッガー] を見つけて起動します。On the remote computer, find and start the Remote Debugger from the Start menu.

    リモート コンピューターに対する管理アクセス許可がない場合は、 [リモート デバッガー] アプリを右クリックし、 [管理者として実行] を選択します。If you don't have administrative permissions on the remote computer, right-click the Remote Debugger app and select Run as administrator. それ以外の場合は、通常どおり開始します。Otherwise, just start it normally.

    管理者として実行されているプロセス、または別のユーザー アカウント (IIS など) で実行されているプロセスにアタッチする場合は、 [リモート デバッガー] アプリを右クリックし、 [管理者として実行] を選択します。If you are planning to attach to a process which is running as an administrator, or is running under a different user account (such as IIS), right-click the Remote Debugger app and select Run as administrator. 詳細については、「管理者としてリモート デバッガーを実行する」を参照してください。For more information, see Run the remote debugger as an administrator.

  2. リモート デバッガーを初めて (またはその構成を完了する前に) 開始すると、 [リモート デバッグの構成] ダイアログ ボックスが表示されます。The first time you start the remote debugger (or before you have configured it), the Remote Debugging Configuration dialog box appears.

    リモート デバッガーの構成Remote Debugger configuration

  3. Windows Web Services API がインストールされていない場合 (これは、Windows Server 2008 R2 でのみ発生します) は、 [インストール] ボタンを選択します。If the Windows Web Services API is not installed, which happens only on Windows Server 2008 R2, select the Install button.

  4. リモート ツールを使用するネットワークの種類を少なくとも 1 つ選択します。Select at least one network type you want to use the remote tools on. コンピューターがドメインを介して接続されている場合は、最初の項目を選択する必要があります。If the computers are connected through a domain, you must choose the first item. コンピューターがワークグループまたはホーム グループを介して接続されている場合は、必要に応じて、2 番目または 3 番目の項目を選択します。If the computers are connected through a workgroup or homegroup, choose the second or third item as appropriate.

  5. [リモート デバッグの構成] を選択してファイアウォールを構成し、リモート デバッガーを起動します。Select Configure remote debugging to configure the firewall and start the remote debugger.

  6. 構成が完了すると、 [リモート デバッガー] ウィンドウが表示されます。When configuration is complete, the Remote Debugger window appears.

    [リモート デバッガー] ウィンドウRemote Debugger window

    リモート デバッガーは接続を待機しています。The remote debugger is now waiting for a connection. 表示されているサーバー名とポート番号を使用して、Visual Studio でリモート接続構成を設定します。Use the server name and port number shown to set the remote connection configuration in Visual Studio.

リモート デバッガーを停止するには、 [ファイル] > [終了] を選択します。To stop the remote debugger, select File > Exit. リモート デバッガーを再起動するには、 [スタート] メニューを使用するか、またはコマンド ラインから次のコマンドを実行します。You can restart it from the Start menu, or from the command line:

<Remote debugger installation directory>\msvsmon.exe

UWP アプリをリモートでデバッグするDebug UWP apps remotely

リモート デバッグはローカル デバッグと同じように動作します。Remote debugging works the same as local debugging.

  1. Windows 10 の Creators Update より前のバージョンでは、リモート デバッグ モニター (msvsmon.ex) がリモート デバイスで実行されていることを確認してください。On pre-Creator's Update versions of Windows 10, make sure the Remote Debugging Monitor (msvsmon.exe) is running on the remote device.

  2. Visual Studio コンピューターで、ツールバーの緑色の矢印の横に適切なデバッグ ターゲット ( [リモート コンピューター] または [デバイス] ) が表示されていることを確認します。On the Visual Studio computer, make sure the correct debugging target (Remote Machine or Device) appears next to the green arrow on the toolbar.

  3. デバッグを開始するには、 [デバッグ] > [デバッグの開始] を選択する、F5 を押す、またはツールバーの緑色の矢印を選択します。Start debugging by selecting Debug > Start Debugging, pressing F5, or selecting the green arrow on the toolbar.

    プロジェクトが再コンパイルされ、リモート デバイスに展開され起動されます。The project recompiles, then deploys and starts on the remote device. デバッガーにより、ブレークポイントで実行が中断され、コードをステップ イン、ステップ オーバー、ステップ アウトできます。The debugger suspends execution at breakpoints, and you can step into, over, and out of code.

  4. 必要に応じて、 [デバッグ] > [デバッグの停止] を選択するか、Shift+F5 を押してデバッグを停止し、リモート アプリを閉じます。If necessary, select Debug > Stop Debugging or press Shift+F5 to stop debugging and close the remote app.

関連項目See also