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