BypassProxyOnLocal has been configured

The information in this article applies to:

  • Visual Studio 2005 Team Foundation Server

  • Visual Studio Team System 2008 Team Foundation Server

  • Team Foundation client

  • Health check

The Best Practices Analyzer tool for Team Foundation Server queries the registry to determine whether URL requests for local resources are routed through the proxy server. The tool queries the BypassProxyOnLocal entries for HKEY_CURRENT_USER and HKEY_LOCAL_MACHINE. An information message appears if either of the keys is configured and set to true.

By default, these entries are not configured, and all URL requests are routed through a proxy server. If the entries are configured and set to true, a URL request is routed through the proxy server only if the requested resource is outside the organization's intranet. If the resource is inside the organization's intranet, the request is not routed through the proxy server. In these local requests, the URI does not contain a period (.). For example, a browser entry of http://webserver/ would not be routed through the proxy server. However, a browser entry of https://www.microsoft.com would.

If either of these keys is configured and set to true, you should try to determine the reason before you decide whether to restore the default behavior. In some cases, organizations configure these entries to avoid a particular problem.

For example, some organizations configure Internet Explorer to use an automatic configuration script. However, this configuration can cause Visual Studio to stop responding when you run a query in Team Explorer. You could solve the problem by disabling the use of the script, but organizations often rely on such scripts for other reasons. Instead of disabling the script, you can solve the problem by configuring BypassProxyOnLocal entries and setting them to true.

Important noteImportant Note:

If you incorrectly edit the registry, you might severely damage your system. Before you make changes to the registry, you should back up any valued data on the computer.

Required Permissions

To perform these procedures, you must be a member of the Administrators security group on the client computer for Team Foundation.

To disable the use of an automatic configuration script

  1. Open Internet Explorer.

  2. Click Tools, and then click Internet Options.

  3. On the Connections tab, click LAN settings.

  4. In the Local Area Network (LAN) Settings dialog box, clear the Use automatic configuration script check box, and then click OK.

  5. Click OK to close the dialog box.

To change the BypassProxyOnLocal registry entry

  1. Click Start, and then click Run.

  2. Type Regedit, and then click OK.

  3. Under HKEY_CURRENT_USER, locate or create the BypassProxyOnLocal registry entry in the following path: Software\Microsoft\VisualStudio\8.0\TeamFoundation\RequestSettings\BypassProxyOnLocal.

  4. Set the value of the entry to true or false, depending on your server requirements.

  5. Under HKEY_LOCAL_MACHINE, locate or create the BypassProxyOnLocal registry value in the following path: Software\Microsoft\VisualStudio\8.0\TeamFoundation\RequestSettings\BypassProxyOnLocal.

  6. Set the value of the entry to true or false, depending on your server requirements.

  7. Click File, and then Exit to save the changes.

See Also

Other Resources

Team Foundation Client Issues