Netsh.exe commands

Tip

Use Netsh.exe anywhere you would previously have used the deprecated tool ProxyCfg.exe.

You can use commands in the netsh winhttp context to configure proxy and tracing settings for Windows HTTP. The netsh commands for WinHTTP can be run manually at the netsh prompt, or in scripts and batch files.

To run these commands from the command prompt, you must either enter the netsh winhttp context, or prepend the context to the command. For example, if you're at the command prompt, but you haven't yet typed netsh followed by winhttp in order to enter the netsh winhttp context, then you need to type a command with the format:

netsh winhttp command

In that format, command is the command that you want to run. And that should include all of the required parameters for that command.

Netsh winhttp commands

The following entries provide details for each command.

flush logbuffer

Flushes the internal buffers for the log files.

Syntax

flush logbuffer

import proxy

Imports the proxy settings in the Internet Explorer (IE) Web browser's Internet Options. Importing settings from IE is the only available option.

Syntax

import proxy source =ie

reset proxy

Resets the WinHTTP proxy setting to DIRECT.

Syntax

reset proxy

reset tracing

Resets the WinHTTP trace parameters to the default settings.

Syntax

reset tracing

Remarks

Here are the default WinHTTP trace parameters:

Parameter	Value
Tracing state	Disabled
trace-file-prefix	None
output	File
level	Default
format	Ansi
max-trace-file-size	65535

set advproxy

Configures the WinHTTP advanced proxy setting. Note that SOCKS5 isn't supported. Also see show advproxy.

Syntax

set advproxy [setting-scope=]<Scope> [settings=]<Settings> set advproxy [setting-scope=]<Scope> [settings-file=]<SettingsFile>

Parameters

setting-scope. User or machine.

settings. Proxy settings in JSON format. The JSON object must contain the properties "Proxy" (string value), "ProxyBypass" (string value), "AutoconfigUrl" (string value), and "AutoDetect" (Boolean value). The format of the strings structure is ([<scheme>=][<scheme>"://"]<server>[":"<port>]). For more info, see Remarks in WINHTTP_PROXY_INFO structure.

setting-file. A file, in JSON format, that contains the settings.

Examples

set advproxy setting-scope=machine settings={<settings>}

set advproxy setting-scope=user settings-file=settings.json

set advproxy setting-scope=machine settings={\"Proxy\":\"contoso-proxy.com:3128\",\"ProxyBypass\":\"\",\"AutoconfigUrl\":\"\",\"AutoDetect\":true}

Here is an example of WinHTTP advanced proxy setting that sets different proxies for HTTP, HTTPS, FTP, and SOCKS protocols:

netsh winhttp set advproxy setting-scope=user settings={\"Proxy\":\"http=http-proxy.com:8080;https=https-proxy.com:8081;ftp=ftp-proxy.com:8082;socks=socks-proxy.com: 8083\",\"ProxyBypass\":\"\",\"AutoconfigUrl\":\"\",\"AutoDetect\":true}"

{
  "ProxyIsEnabled": true,
  "Proxy": "http=http-proxy.com:8080;https=https-proxy.com:8081;ftp=ftp-proxy.com:8082;socks=socks-proxy.com:8083",
  "AutoConfigIsEnabled": false,
  "AutoDetect": true,
  "PerUserProxySettings": true
}

set proxy

Important

set proxy is deprecated. Use set advproxy instead.

Configures the WinHTTP proxy setting.

Syntax

set proxy [proxy-server=]ProxyServerName [bypass-list=]<HostsList>

Parameters

proxy-server. Required. Specifies the proxy server to use for http, secure http (https), or both http and https protocols.

bypass-list. Optional. Specifies a list of web sites that should be visited without using the proxy server. Use "<local>" to bypass all short name hosts.

Examples

Following are three examples of how to use the set proxy command.

set proxy myproxy

set proxy myproxy:80 "<local>bar"

set proxy proxy-server="http=myproxy;https=sproxy:88" bypass-list="*.contoso.com"

set tracing

Configures the WinHTTP tracing parameters.

Syntax

set tracing [output=]file | debugger | both [trace-file-prefix=]FilePrefix [level=]default | verbose [format=]ansi | hex [max-trace-file-size=]FileSize [state=]enabled | disabled

Parameters

output. Optional. Specifies whether tracing data is exported to a file, to a debugger, or to both.

trace-file-prefix. Optional. Specifies a string value that's a prefix for the log file. The file prefix can include a folder location/path. Type "*" to delete an existing prefix.

level. Optional. Specifies the amount of information to log.

format. Optional. Specifies the display format of network traffic (hexadecimal or ansi).

max-trace-file-size. Optional. Specifies a numeric value that's the maximum size of the trace file in bytes.

state. Required. Specifies whether tracing is enabled or disabled.

Examples

Following are two examples of how to use the set tracing command.

set tracing trace-file-prefix="C:\Temp\Test3" level=verbose format=hex

set tracing output=debugger max-trace-file-size=512000 state=enabled

show advproxy

Displays the current WinHTTP advanced proxy setting. Note that SOCKS5 isn't supported. Also see set advproxy.

Syntax

show advproxy

show proxy

Important

show proxy is deprecated. Use show advproxy instead.

Displays the current WinHTTP proxy setting.

Syntax

show proxy

show tracing

Displays the current WinHTTP tracing parameters.

Syntax

show tracing