Solução de erros relacionados à rede ao instalar, atualizar ou usar o Visual Studio

Aplica-se a: Visual Studio

Você pode encontrar erros relacionados à rede ou ao proxy ao instalar, atualizar ou usar o Visual Studio atrás de um firewall, um servidor proxy ou em um computador cliente que não tem acesso à Internet. Este artigo fornece resoluções para alguns cenários comuns desses problemas.

Erro "Autorização de proxy necessária"

Esse erro geralmente ocorre quando os usuários se conectam à internet por meio de um servidor proxy. Em seguida, o servidor proxy bloqueia as chamadas feitas pelo Visual Studio para alguns recursos de rede.

Solução

Para resolver esse problema, tente estas etapas:

1. Reinicie o Visual Studio. Uma caixa de diálogo de autenticação de proxy deverá aparecer. Insira suas credenciais na caixa de diálogo quando solicitado.

2. Se reiniciar o Visual Studio não resolver o problema, pode ser porque o servidor proxy não solicita credenciais para http://go.microsoft.com endereços, mas o faz para *.visualStudio.microsoft.com endereços. Para esses servidores, adicione as seguintes URLs a uma lista de permissões para desbloquear todos os cenários de conexão no Visual Studio:

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

3. Recomendamos que você remova o endereço http://go.microsoft.com da lista de permissões. A remoção do endereço permite que a caixa de diálogo de autenticação de proxy apareça para o endereço http://go.microsoft.com e os pontos de extremidade do servidor quando o Visual Studio for reiniciado.

Configurar servidor proxy

O Visual Studio deve selecionar a configuração de proxy do Windows. No entanto, você pode definir um servidor proxy específico da seguinte maneira.

1. Encontre devenv.exe.config (o arquivo de configuração do devenv.exe) em:

   • Visual Studio 2019: %ProgramFiles%\Microsoft Visual Studio\2019\Enterprise\Common7\IDE ou %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\Common7\IDE.
   • Visual Studio 2022: %ProgramFiles%\Microsoft Visual Studio\2022\Enterprise\Common7\IDE ou %ProgramFiles(x86)%\Microsoft Visual Studio\2022\Enterprise\Common7\IDE.

2. No arquivo de configuração, localize o bloco <system.net> e adicione esse código:

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

   Você deve inserir o endereço de proxy correto para sua rede na proxyaddress="<http://<yourproxy:port#>.

   Observação

   Para obter mais informações, confira as páginas Elemento <defaultProxy> (configurações de rede) e Elemento <proxy> (configurações de rede).

3. Para o Visual Studio 2022, defina as variáveis de ambiente de proxy:

   • http_proxy: Esta variável é usada em solicitações HTTP. Observação Essa variável é minúscula porque algumas ferramentas esperam que a variável seja minúscula.
   • HTTPS_PROXY: Esta variável é usada em solicitações HTTPS.
   • ALL_PROXY: essa variável é usada para especificar um servidor proxy para solicitações HTTP ou HTTPS se a HTTP_PROXY variável or HTTPS_PROXY não estiver definida.

   Observação

   Para obter mais informações, consulte HttpClient.DefaultProxy.

Credenciais de usuário padrão

Se você quiser usar as credenciais padrão para a conta de usuário que está executando o Visual Studio com seu proxy, siga estas etapas:

1. Encontre devenv.exe.config (o arquivo de configuração do devenv.exe) em:

   • Visual Studio 2019: %ProgramFiles%\Microsoft Visual Studio\2019\Enterprise\Common7\IDE ou %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\Common7\IDE.
   • Visual Studio 2022: %ProgramFiles%\Microsoft Visual Studio\2022\Enterprise\Common7\IDE ou %ProgramFiles(x86)%\Microsoft Visual Studio\2022\Enterprise\Common7\IDE.

2. No arquivo de configuração, localize o bloco <system.net> e adicione esse código:

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

   Você deve inserir o endereço de proxy correto para sua rede na proxyaddress="<http://<yourproxy:port#>.

   Observação

   Para obter mais informações, confira as páginas Elemento <defaultProxy> (configurações de rede) e Elemento <proxy> (configurações de rede).

3. Com o Visual Studio 17.8 em diante, atualizamos o processo de configuração para credenciais de proxy padrão em solicitações da Web. Para habilitar as credenciais de proxy padrão após essa atualização, crie uma nova variável de ambiente chamada VS_USE_DEFAULTPROXY, defina seu valor como truee reinicie o Visual Studio. Essa variável informa ao Visual Studio e aos processos associados para anexar as credenciais padrão do usuário que executa o processo às solicitações de proxy. É semelhante ao que useDefaultCredentials acontece no arquivo de configuração exe na etapa 2.

Depurando erros de proxy

Ao tentar fazer conexões de rede atrás de um servidor proxy, você pode encontrar muitos tipos diferentes de falhas. Algumas das falhas incluem "erro ao enviar", "conexão recusada" e "não foi possível resolver o endereço". Pode haver outros tipos de falhas, mas o que elas têm em comum é que alguma configuração está incorreta na máquina ou rede local. Para ajudar a diagnosticar o que bloqueia a conexão, usar uma ferramenta fora do Visual Studio pode ser útil.

• Se você encontrar um erro como conexão recusada ou erro ao enviar, tente a seguinte linha de comando:

  curl "https://resource" -v
  

  A execução desse comando faz uma conexão de rede com o recurso e pode falhar de forma semelhante ao que é visto no Visual Studio. Nesse ponto, o diagnóstico dessa falha é necessário antes de tentar fazer a conexão usando o Visual Studio. Uma falha aqui indica um problema de configuração de computador ou rede em vez de um problema de produto com o Visual Studio.

• Se você sabe que está atrás de um servidor proxy que tem um endereço específico, é necessário definir as http_proxy variáveis de ambiente e https_proxy antes de executar o curl comando, pois ele usa essas variáveis de ambiente para configurações de proxy.

  Você também pode usar o help interruptor em curl para outras opções. Esse comando curl --help proxy exibe uma lista de opções e opções que você pode usar para instalar e configurar um proxy com curlo .

• Se você tiver um problema de entrada com o Visual Studio para depurar, execute os seguintes comandos:

  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
  

  Para obter as URLs exigidas pela entrada, consulte Instalar e usar o Visual Studio por trás de um firewall ou servidor proxy.

Erro "Desconectado do Visual Studio" ao tentar relatar um problema

Esse erro geralmente ocorre quando um usuário se conecta à internet por meio de um servidor proxy. Em seguida, o servidor proxy bloqueia as chamadas feitas pelo Visual Studio para alguns recursos de rede.

Solução

Para resolver esse problema, siga estas etapas:

1. Localize feedback.exe.config (o arquivo de configuração do feedback.exe) em: %ProgramFiles(x86)%\Microsoft Visual Studio\Installer ou %ProgramFiles%\Microsoft Visual Studio\Installer.

2. No arquivo de configuração, verifique se o código a seguir está presente. Se o código não estiver presente, adicione-o antes da última </configuration> linha.

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

Erro "A conexão subjacente foi fechada"

Se você estiver usando o Visual Studio em uma rede privada que tem um firewall, o Visual Studio poderá não ser capaz de se conectar a alguns recursos da rede. Esses recursos podem incluir o Azure DevOps Services para conexão e licenciamento, o NuGet e os serviços do Azure. Se o Visual Studio falhar ao se conectar a um desses recursos, você deverá ver a seguinte mensagem de erro:

A conexão subjacente foi fechada: Ocorreu um erro inesperado no envio.

O Visual Studio usa o TLS (protocolo TLS) 1.2 para se conectar aos recursos de rede. Os dispositivos de segurança de algumas redes privadas bloqueiam determinadas conexões de servidor quando o Visual Studio usa o protocolo TLS 1.2.

Solução

Habilite conexões adicionando essas URLs de domínio a uma lista de permitidos.

Erro "Falha ao analisar a ID do processo pai"

Você pode encontrar essa mensagem de erro ao usar um bootstrapper do Visual Studio e um arquivo response.json em uma unidade de rede. A origem do erro é o UAC (Controle de Conta de Usuário) no Windows.

É por isso que esse erro pode acontecer: uma unidade de rede mapeada ou um compartilhamento UNC está vinculado ao token de acesso de um usuário. Quando o UAC está habilitado, dois tokens de acesso de usuário são criados: um com acesso de administrador e outro sem acesso de administrador. Quando uma unidade de rede ou compartilhamento é criado, o token de acesso atual do usuário é vinculado a ele. Como o bootstrapper deve ser executado como administrador, ele não pode acessar a unidade ou o compartilhamento de rede, a menos que a unidade ou o compartilhamento esteja vinculado a um token de acesso do usuário que tenha acesso de administrador.

Solução

Para resolver esse problema, use o net use comando ou altere a configuração da Diretiva de Grupo do UAC. Para obter mais informações sobre essas soluções alternativas e como implementá-las, consulte:

• As unidades mapeadas não estão disponíveis em um prompt com privilégios elevados quando o UAC está configurado para "Solicitar credenciais" no Windows
• Os programas podem não conseguir acessar alguns locais de rede depois que você ativa o Controle de Conta de Usuário em sistemas operacionais Windows

O produto falha ao instalar ou atualizar porque as permissões de compartilhamento de rede não estão configuradas corretamente

Certifique-se de que a conta que executa a instalação ou atualização tenha acesso suficiente aos compartilhamentos de rede.

Problema	Solução
A conta de usuário não pode acessar arquivos.	Se o usuário tiver permissões de administrador no computador e for instalar ou atualizar a partir de um layout, você precisará verificar se as ACLs (permissões de compartilhamento de rede) estão configuradas para conceder aos usuários acesso de leitura antes que o local de rede seja compartilhado.
A conta do sistema não pode acessar arquivos.	Às vezes, a instalação ou atualização é executada usando a conta do sistema em vez de uma conta de usuário. Essa situação geralmente acontece quando as atualizações do administrador são usadas para manter a máquina atualizada e segura. Você precisa garantir que as contas do sistema das máquinas cliente tenham permissões de leitura para o compartilhamento de arquivos de rede. Você pode fazer isso criando um grupo do Active Directory que contém as contas de computador que precisam de acesso ao compartilhamento e concedendo a esse grupo do AD acesso ao compartilhamento.

Suporte ou solução de problemas

Se a instalação do Visual Studio falhar, confira Solução de problemas de instalação e atualização do Visual Studio para obter diretrizes passo a passo.

Mais opções de suporte:

• Oferecemos uma opção de suporte por meio do chat de instalação (somente em inglês) para problemas relacionados à instalação.
• Relate problemas do produto para nós por meio da ferramenta Relatar um Problema, exibida no Instalador do Visual Studio e no IDE do Visual Studio. Se você for Administrador de TI e não tiver o Visual Studio instalado, envie os comentários de Administrador de TI aqui.
• Sugira um recurso, acompanhe os problemas do produto e encontre respostas na Comunidade de Desenvolvedores do Visual Studio.

Referências

• Solucionar problemas de layout de rede ou instalação offline
• Instalar e usar o Visual Studio por trás de um firewall ou servidor proxy
• Guia do administrador do Visual Studio