Visual Studio からリモート コンピューター上の UWP アプリをデバッグします。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. Visual Studio コンピューターがタッチ、位置情報、または物理的な方向など、UWP 固有の機能をサポートしていない場合は、リモート コンピューターで 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

Visual Studio からリモート デバイスで UWP アプリをデバッグします。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.
  • リモート コンピューターには、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.

Caution

既定では、プロパティ ページ設定ユニバーサル (暗号化されていないプロトコル) として、認証の種類は 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. リモート デバッガーを実行する必要がありますもWindows 認証モードは、Visual Studio コンピューターと同じユーザー アカウントとします。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. 選択、C#または Visual Studio で Visual Basic プロジェクトソリューション エクスプ ローラーを選択し、プロパティアイコン、キーを押してAlt + 入力、または右クリックし、選択プロパティします。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. ターゲット デバイスを選択しますリモート マシンリモート コンピューターの場合、またはデバイスの直接接続されている 10 の Windows Mobile デバイス。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. 選択、 C++ Visual Studio でプロジェクトソリューション エクスプ ローラーを選択し、プロパティアイコン、キーを押してAlt+」と入力、または右クリックし、選択プロパティします。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. 起動するデバッガーを選択しますリモート マシンリモート コンピューターの場合、またはデバイスの直接接続されている 10 の Windows Mobile デバイス。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

Tip

名前でリモート デバイスに接続できない場合は、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.

  • 10 の Windows Mobile デバイスは必要があります。 またはリモート ツールをサポートしていないしないでください。Windows Mobile 10 devices do not require or support the remote tools.
  • 作成者を実行している Windows 10 Pc が (バージョン 1703) を更新し、後で、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.
  • 前の作成者の更新プログラムの 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.

  • 最新 remote tools for 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 を使用している場合ダウンロード for Visual Studio 2017 remote tools の最新の更新。(For example, if you are using Visual Studio 2017, download the latest update of the remote tools for Visual Studio 2017. このシナリオでダウンロードしない remote tools for 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.
VersionVersion リンクLink メモNotes
Visual Studio 2019Visual Studio 2019 リモート ツールRemote tools すべての Visual Studio 2019 バージョンと互換性があります。Compatible with all Visual Studio 2019 versions. (X 86、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. (X 86、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
VersionVersion リンクLink メモNotes
Visual Studio 2017Visual Studio 2017 リモート ツールRemote tools すべての Visual Studio 2017 バージョンと互換性があります。Compatible with all Visual Studio 2017 versions. (X 86、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 docします。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.

Note

  • 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 アプリをデバッグするには、リモート ツールのダウンロード、Visual Studio 2015 でのみ使用できる ARM を使用します。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 サービスの 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 の以前の作成者の更新プログラムのバージョンでは、必ず、リモート デバッグ モニター (msvsmon.exe) がリモート デバイスで実行されています。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