Visual Studio をインストール、更新、または使用するときのネットワーク関連のエラーのトラブルシューティング

適用対象: Visual Studio

ファイアウォール、プロキシ サーバー、またはインターネットにアクセスできないクライアント コンピューターに Visual Studio をインストール、更新、または使用すると、ネットワークまたはプロキシ関連のエラーが発生する可能性があります。 この記事では、これらの問題の一般的なシナリオの解決策について説明します。

エラー "プロキシの承認が必要です"

このエラーは、通常、ユーザーがプロキシ サーバーを介してインターネットに接続するときに発生します。 その場合、Visual Studio で行われる一部のネットワーク リソースへの呼び出しが、プロキシ サーバーによってブロックされます。

解決方法

この問題を解決するには、次の手順を試してください。

1. Visual Studio を再起動します。 プロキシ認証のダイアログが表示されます。 ダイアログ ボックスに入力を求めるメッセージが表示されたら、資格情報を入力します。

2. Visual Studio を再起動しても問題が解決しない場合は、プロキシ サーバーが http://go.microsoft.com アドレスの資格情報の入力を求めず、 *.visualStudio.microsoft.com アドレスに対してはそうすることが原因である可能性があります。 このようなサーバーの場合は、次の URL を許可リストに追加して、Visual Studio でのすべてのサインイン シナリオのブロックを解除します。

   • *.windows.net
   • *.microsoftonline.com
   • *.visualstudio.microsoft.com
   • *.microsoft.com
   • *.live.com

3. 許可リストからアドレス http://go.microsoft.com を削除することをお勧めします。 このアドレスを削除すると、Visual Studio の再起動時に、アドレス http://go.microsoft.com とサーバー エンドポイントの両方に対してプロキシ認証ダイアログが表示されます。

プロキシ サーバーを構成する

Visual Studio は、Windows からプロキシ設定を選択する必要があります。 ただし、次のように特定のプロキシ サーバーを設定できます。

1. devenv.exe.config (devenv.exeの構成ファイル) を検索します。

   • Visual Studio 2019: %ProgramFiles%\Microsoft Visual Studio\2019\Enterprise\Common7\IDE または %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\Common7\IDE。
   • Visual Studio 2022: %ProgramFiles%\Microsoft Visual Studio\2022\Enterprise\Common7\IDE または %ProgramFiles(x86)%\Microsoft Visual Studio\2022\Enterprise\Common7\IDE。

2. 構成ファイル内で、<system.net> ブロックを探し、次のコードを追加します。

   <defaultProxy enabled="true">
       <proxy bypassonlocal="True" proxyaddress="http://<yourproxy:port#>"/>
   </defaultProxy>
   

   proxyaddress="<http://<yourproxy:port#>には、使用しているネットワークの正しいプロキシ アドレスを挿入する必要があります。

   Note

   詳細については、「<defaultProxy> 要素 (ネットワーク設定)」ページおよび「<proxy> 要素 (ネットワーク設定)」ページを参照してください。

3. Visual Studio 2022 の場合は、プロキシ環境変数を設定します。

   • http_proxy: この変数は HTTP 要求で使用されます。 注 この変数は小文字です。一部のツールでは、変数が小文字であることが想定されているためです。
   • HTTPS_PROXY: この変数は HTTPS 要求で使用されます。
   • ALL_PROXY: この変数は、 HTTP_PROXY または HTTPS_PROXY 変数が定義されていない場合に、HTTP または HTTPS 要求のプロキシ サーバーを指定するために使用されます。

   Note

   詳細については、「 HttpClient.DefaultProxy」を参照してください。

既定のユーザー資格情報

プロキシで Visual Studio を実行しているユーザー アカウントの既定の資格情報を使用する場合は、次の手順に従います。

1. devenv.exe.config (devenv.exeの構成ファイル) を検索します。

   • Visual Studio 2019: %ProgramFiles%\Microsoft Visual Studio\2019\Enterprise\Common7\IDE または %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\Common7\IDE。
   • Visual Studio 2022: %ProgramFiles%\Microsoft Visual Studio\2022\Enterprise\Common7\IDE または %ProgramFiles(x86)%\Microsoft Visual Studio\2022\Enterprise\Common7\IDE。

2. 構成ファイル内で、<system.net> ブロックを探し、次のコードを追加します。

   <defaultProxy enabled="true" useDefaultCredentials="true">
      <proxy bypassonlocal="True" proxyaddress="http://<yourproxy:port#>"/>
   </defaultProxy>
   

   proxyaddress="<http://<yourproxy:port#>には、使用しているネットワークの正しいプロキシ アドレスを挿入する必要があります。

   Note

   詳細については、「<defaultProxy> 要素 (ネットワーク設定)」ページおよび「<proxy> 要素 (ネットワーク設定)」ページを参照してください。

3. Visual Studio 17.8 以降では、Web 要求の既定のプロキシ資格情報の構成プロセスが更新されました。 この更新後に既定のプロキシ資格情報を有効にするには、 VS_USE_DEFAULTPROXYという名前の新しい環境変数を作成し、その値を true に設定してから、Visual Studio を再起動します。 この変数は、プロセスを実行しているユーザーの既定の資格情報をプロキシ要求にアタッチするように Visual Studio と関連付けられたプロセスに指示します。 これは、手順 2 の exe 構成ファイルの useDefaultCredentials と似ています。

プロキシ エラーのデバッグ

プロキシ サーバーの背後でネットワーク接続を行おうとすると、さまざまな種類のエラーが発生する可能性があります。 エラーの一部には、"送信時エラー"、"接続が拒否されました"、"アドレスを解決できませんでした" などがあります。 他の種類のエラーが発生する可能性がありますが、共通しているのは、ローカル コンピューターまたはネットワーク上の一部の構成が正しくないということです。 接続のブロックを診断するために、Visual Studio の外部でツールを使用すると役立ちます。

• 接続拒否や送信時のエラーなどのエラーが発生した場合は、次のコマンド ラインを試してください。

  curl "https://resource" -v
  

  このコマンドを実行すると、リソースへのネットワーク接続が確立され、Visual Studio と同様に失敗する可能性があります。 その時点で、Visual Studio を使用して接続を試行する前に、このエラーを診断する必要があります。 ここでのエラーは、Visual Studio での製品の問題ではなく、コンピューターまたはネットワーク構成の問題を示しています。

• 特定のアドレスを持つプロキシ サーバーの背後にいることがわかっている場合は、curl コマンドを実行する前に、http_proxyとhttps_proxy環境変数を設定する必要があります。これは、プロキシ設定にこれらの環境変数を使用するためです。

  他のオプションでは、curl で help スイッチを使用することもできます。 このコマンド curl --help proxy 、 curlを使用してプロキシを設定および構成するために使用できるオプションとスイッチの一覧が表示されます。

• デバッグする Visual Studio でサインインの問題が発生した場合は、次のコマンドを実行します。

  curl "https://login.microsoftonline.com/common/discovery/instance?api-version=1.1&authorization_endpoint=https://login.microsoftonline.com/organizations/oauth2/v2.0/authorize" -v
  
  curl "https://management.azure.com" -v
  
  curl "https://graph.microsoft.com" -v
  

  サインインに必要な URL については、「 ファイアウォールまたはプロキシ サーバーの背後にある Visual Studio をインストールして使用するを参照してください。

問題を報告しようとしたときにエラー "Visual Studio から切断されました"

このエラーは、通常、ユーザーがプロキシ サーバーを介してインターネットに接続するときに発生します。 その場合、Visual Studio で行われる一部のネットワーク リソースへの呼び出しが、プロキシ サーバーによってブロックされます。

解決方法

この問題を解決するには、次の手順に従ってください。

1. feedback.exe.config (feedback.exe の構成ファイル) は、%ProgramFiles(x86)%\Microsoft Visual Studio\Installer または %ProgramFiles%\Microsoft Visual Studio\Installer で検索します。

2. 構成ファイルで、次のコードが存在するかどうかを確認します。 コードが存在しない場合は、最後の </configuration> 行の前に追加します。

   <system.net>
       <defaultProxy useDefaultCredentials="true" />
   </system.net>
   

エラー "基になる接続が閉じられました"

ファイアウォールのあるプライベート ネットワークで Visual Studio を使っている場合、Visual Studio が一部のネットワーク リソースに接続できない可能性があります。 これらのリソースには、サインインとライセンス取得のための Azure DevOps Services、NuGet、および Azure サービスが含まれます。 Visual Studio でこれらのリソースのいずれかに接続できない場合は、次のエラー メッセージが表示されることがあります。

基になる接続が閉じられました:送信時に予期しないエラーが発生しました。

Visual Studio ではトランスポート層セキュリティ (TLS) 1.2 プロトコルを使用して、ネットワーク リソースに接続します。 Visual Studio で TLS 1.2 を使用している場合、一部のプライベート ネットワーク上のセキュリティ アプライアンスによって特定のサーバー接続がブロックされます。

解決方法

これらのドメイン URL を許可リストに追加して、接続を有効にします。

エラー "親プロセスから ID を解析できませんでした"

このエラー メッセージは、ネットワーク ドライブで Visual Studio ブートストラップと response.json ファイルを使用するときに発生する可能性があります。 エラーの原因は、Windows のユーザー アカウント制御 (UAC) にあります。

このエラーが発生する理由は、次のとおりです。マップされたネットワーク ドライブまたは UNC 共有は、ユーザーのアクセス トークンにリンクされます。 UAC を有効にすると、2 つのユーザー アクセス トークン が作成されます。1 つは管理者アクセス権を持ち、1 つは管理者アクセス権を持たないトークンです。 ネットワーク ドライブまたは共有が作成されると、ユーザーの現在のアクセス トークンがリンクされます。 ブートストラップは管理者として実行する必要があるため、ドライブまたは共有が管理者アクセス権を持つユーザー アクセス トークンにリンクされていない限り、ネットワーク ドライブまたは共有にアクセスできません。

解決方法

この問題を解決するには、 net use コマンドを使用するか、 UAC グループ ポリシー 設定を変更します。 これらの回避策とその実装方法の詳細については、次を参照してください。

• UAC が Windows の [資格情報を要求する] に構成されている場合、マップされたドライブを管理者特権のプロンプトから利用できない
• Programs may be unable to access some network locations after you turn on User Account Control in Windows operating systems (Windows オペレーティング システムでユーザー アカウント制御を有効にした後、プログラムが一部のネットワークの場所にアクセスできない場合がある)

ネットワーク共有のアクセス許可が正しく構成されていないため、製品のインストールまたは更新に失敗する

インストールまたは更新を実行しているアカウントがネットワーク共有に十分なアクセス権を持っていることを確認します。

問題	解決策
ユーザー アカウントはファイルにアクセスできません。	ユーザーがコンピューターに対する管理者権限を持っていて、レイアウトからインストールまたは更新する場合は、ネットワークの場所を共有する前に、ネットワーク共有アクセス許可 (ACL) がユーザーに読み取りアクセスを許可するように構成されていることを確認する必要があります。
システム アカウントはファイルにアクセスできません。	インストールまたは更新プログラムが、ユーザー アカウントではなく、システム アカウントを使用して実行される場合があります。 この状況は通常、管理者の更新プログラムを使用してマシンを更新し、セキュリティで保護する場合に発生します。 クライアント マシンのシステム アカウントに、ネットワーク ファイル共有に対する読み取りアクセス許可があることを確認する必要があります。 これを行うには、共有へのアクセスを必要とするマシン アカウントを含む Active Directory グループを作成し、その AD グループに共有へのアクセス権を付与します。

サポートまたはトラブルシューティング

Visual Studio のインストールが失敗した場合は、「Visual Studio のインストールとアップグレードの問題のトラブルシューティング」に記載されているステップ バイ ステップ ガイドをご覧ください。

その他のサポート オプション:

• インストール関連の問題については、インストール チャット (英語のみ) のサポート オプションを提供しています。
• Visual Studio インストーラーおよび Visual Studio IDE の両方に表示される [問題の報告] ツールから、製品の問題を Microsoft に報告してください。 自分は IT 管理者であるのに、Visual Studio がインストールされていない場合は、こちらで IT 管理者フィードバックを送信できます。
• Visual Studio 開発者コミュニティで機能の提案、製品の問題の追跡、回答の検索を行うことができます。

関連情報

• ネットワーク レイアウトまたはオフライン インストールに関する問題のトラブルシューティング
• ファイアウォールまたはプロキシ サーバーの内側に Visual Studio をインストールして使用する
• Visual Studio 管理者ガイド