Comandos do Netsh.exe

Dica

Use Netsh.exe em qualquer lugar que você teria usado anteriormente a ferramenta preterida ProxyCfg.exe.

Você pode usar comandos no contexto netsh winhttp para definir configurações de proxy e rastreamento para HTTP do Windows. Os comandos netsh para WinHTTP podem ser executados manualmente no prompt netsh ou em scripts e arquivos em lote.

Para executar esses comandos a partir do prompt de comando, você deve inserir o contexto ou preceder o contexto netsh winhttp ao comando. Por exemplo, se você estiver no prompt de comando, mas ainda não tiver digitado netsh seguido por winhttp para inserir o contexto, será necessário digitar um comando com o formato netsh winhttp:

comandonetsh winhttp

Nesse formato, command é o comando que você deseja executar. E isso deve incluir todos os parâmetros necessários para esse comando.

Comandos winhttp do Netsh

As entradas a seguir fornecem detalhes para cada comando.

flush logbuffer

Libera os buffers internos para os arquivos de log.

Sintaxe

flush logbuffer

import proxy

Importa as configurações de proxy nas Opções da Internet do navegador Internet Explorer (IE). Importar configurações do IE é a única opção disponível.

Sintaxe

import proxy source =ie

reset proxy

Redefine a configuração de proxy WinHTTP para DIRECT.

Sintaxe

reset proxy

reset tracing

Redefine os parâmetros de rastreamento WinHTTP para as configurações padrão.

Sintaxe

reset tracing

Comentários

Aqui estão os parâmetros de rastreamento WinHTTP padrão:

Parâmetro	Valor
Tracing state	Desabilitadas
trace-file-prefix	Nenhum
output	Arquivo
level	Padrão
format	Ansi
max-trace-file-size	65535

set advproxy

Define a configuração de proxy avançado WinHTTP. Observe que SOCKS5 não é aceito. Consulte também show advproxy.

Sintaxe

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

Parâmetros

setting-scope. Usuário ou máquina.

settings. Configurações de proxy no formato JSON. O objeto JSON deve conter as propriedades "Proxy" (valor de cadeia de caracteres), "ProxyBypass" (valor de cadeia de caracteres), "AutoconfigUrl" (valor de cadeia de caracteres) e "AutoDetect" (valor booleano). O formato da estrutura de cadeias de caracteres é ([<scheme>=][<scheme>"://"]<server>[":"<port>]). Para obter mais informações, consulte Comentários na estrutura WINHTTP_PROXY_INFO.

setting-file. Um arquivo, no formato JSON, que contém as configurações.

Exemplos

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}

Aqui está um exemplo de configuração avançada de proxy do WinHTTP que define proxies diferentes para os protocolos HTTP, HTTPS, FTP e SOCKS:

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

Importante

set proxy foi preterido. Em vez disso, use set advproxy.

Definir as configurações de proxy WinHTTP

Sintaxe

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

Parâmetros

proxy-server. Obrigatório. Especifica o servidor proxy a ser usado para http, http seguro (https) ou protocolos http e https.

bypass-list. Opcional. Especifica uma lista de sites que devem ser visitados sem usar o servidor proxy. Use "<local>" para ignorar todos os hosts de nome curto.

Exemplos

A seguir, estão três exemplos de como usar o comando set proxy.

set proxy myproxy

set proxy myproxy:80 "<local>bar"

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

set tracing

Configura os parâmetros de rastreamento WinHTTP.

Sintaxe

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

Parâmetros

output. Opcional. Especifica se os dados de rastreamento são exportados para um arquivo, para um depurador ou para ambos.

trace-file-prefix. Opcional. Especifica um valor de cadeia de caracteres que é um prefixo para o arquivo de log. O prefixo do arquivo pode incluir um local/caminho de pasta. Digite "*" para excluir um prefixo existente.

level. Opcional. Especifica a quantidade de informações a serem registradas em log.

format. Opcional. Especifica o formato de exibição do tráfego de rede (hexadecimal ou ansi).

max-trace-file-size. Opcional. Especifica um valor numérico que é o tamanho máximo do arquivo de rastreamento em bytes.

state. Obrigatório. Especifica se os mapeadores do DS estão habilitados ou desabilitados.

Exemplos

A seguir estão dois exemplos de como usar o comando set tracing.

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

Exibe a configuração atual de proxy avançado WinHTTP. Observe que SOCKS5 não é aceito. Consulte também set advproxy.

Sintaxe

show advproxy

show proxy

Importante

show proxy foi preterido. Em vez disso, use show advproxy.

Exibe a configuração atual de proxy avançado WinHTTP.

Sintaxe

show proxy

show tracing

Exibe os parâmetros de rastreamento WinHTTP atuais.

Sintaxe

show tracing