Netsh.exe-Befehle

Tipp

Verwenden Sie Netsh.exe überall, wo Sie zuvor das veraltete Tool ProxyCfg.exe verwendet haben.

Sie können Befehle im netsh winhttp-Kontext verwenden, um Proxy- und Ablaufverfolgungseinstellungen für Windows-HTTP zu konfigurieren. Die netsh-Befehle für WinHTTP können manuell an der Eingabeaufforderung netsh oder in Skripts und Batchdateien ausgeführt werden.

Um diese Befehle über die Eingabeaufforderung auszuführen, müssen Sie entweder den netsh winhttp-Kontext eingeben oder dem Befehl den Kontext vorangestellt haben. Wenn Sie sich beispielsweise bei der Eingabeaufforderung befinden, sie aber noch nicht netsh gefolgt von winhttp eingegeben haben, um den netsh winhttp-Kontext einzugeben, müssen Sie einen Befehl mit dem Format eingeben:

command netsh winhttp

In diesem Format ist der Befehl der Befehl, den Sie ausführen sollten. Und er sollte alle erforderlichen Parameter für diesen Befehl enthalten.

Netsh winhttp-Befehle

Die folgenden Einträge enthalten Angaben für jeden Befehl.

flush logbuffer

Leert die internen Puffer für die Protokolldateien.

Syntax

flush logbuffer

Importproxy

Importiert die Proxyeinstellungen in den Internetoptionen des Internetbrowsers Internet Explorer (IE). Das Importieren von Einstellungen aus IE ist die einzige verfügbare Option.

Syntax

import proxy source =ie

Proxy zurücksetzen

Setzt die WinHTTP-Proxyeinstellung auf DIRECT zurück.

Syntax

reset proxy

Zurücksetzen der Ablaufverfolgung

Setzt die WinHTTP-Ablaufverfolgungsparameter auf die Standardeinstellungen zurück.

Syntax

reset tracing

Hinweise

Hier sind die standardmäßigen WinHTTP-Ablaufverfolgungsparameter:

Parameter	Wert
Ablaufverfolgungsstatus	Disabled
trace-file-prefix	Keine
output	Datei
level	Standard
format	Ansi
max-trace-file-size	65.535

advproxy festlegen

Konfiguriert die erweiterte WinHTTP-Proxyeinstellung. Beachten Sie, dass SOCKS5 nicht unterstützt wird. Siehe auch show advproxy.

Syntax

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

Parameter

setting-scope. Benutzer oder Computer.

settings. Proxyeinstellungen im JSON-Format. Das JSON-Objekt muss die Eigenschaften „Proxy“ (Zeichenfolgenwert), „ProxyBypass“ (Zeichenfolgenwert), „AutoconfigUrl“ (Zeichenfolgenwert) und „AutoDetect“ (boolescher Wert) enthalten. Das Format der Zeichenfolgenstruktur lautet ([<scheme>=][<scheme>"://"]<server>[":"<port>]). Weitere Informationen finden Sie in den Hinweisen in der WINHTTP_PROXY_INFO Struktur.

setting-file. Eine Datei im JSON-Format, welche die Einstellungen enthält.

Beispiele

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}

Hier sehen Sie ein Beispiel für die erweiterte Proxy-Einstellung von WinHTTP, die verschiedene Proxys für die Protokolle HTTP, HTTPS, FTP und SOCKS einrichtet:

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
}

Proxy festlegen

Wichtig

set proxy ist veraltet. Verwenden Sie stattdessen set advproxy.

Konfigurieren der WinHTTP-Proxyeinstellung.

Syntax

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

Parameter

proxy-server. Erforderlich. Gibt den Proxyserver an, der für http-, sichere HTTP-Protokolle (https) oder sowohl http- als auch https-Protokolle verwendet werden soll.

bypass-list. Optional. Gibt eine Liste von Websites an, die ohne Verwendung des Proxyservers besucht werden sollen. Verwenden Sie „<lokal>“, um alle Kurznamenhosts zu umgehen.

Beispiele

Im Folgenden sind drei Beispiele für die Verwendung des set proxy-Befehls aufgeführt.

set proxy myproxy

set proxy myproxy:80 "<local>bar"

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

Ablaufverfolgung festlegen

Konfiguriert die WinHTTP-Ablaufverfolgungsparameter.

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

Parameter

output. Optional. Gibt an, ob Ablaufverfolgungsdaten in eine Datei, in einen Debugger oder in beide exportiert werden.

trace-file-prefix. Optional. Gibt einen Zeichenfolgenwert an, der ein Präfix für die Protokolldatei ist. Das Dateipräfix kann einen Ordnerspeicherort/Pfad enthalten. Geben Sie „*“ ein, um ein vorhandenes Präfix zu löschen.

level. Optional. Gibt die Menge der zu protokollierenden Informationen an.

format. Optional. Gibt das Anzeigeformat des Netzwerkdatenverkehrs an (hexadezimal oder ansi).

max-trace-file-size. Optional. Gibt einen numerischen Wert an, der die maximale Größe der Ablaufverfolgungsdatei in Bytes angibt.

state. Erforderlich. Gibt an, ob die Ablaufverfolgung aktiviert oder deaktiviert ist.

Beispiele

Im Folgenden sind zwei Beispiele für die Verwendung des Befehls „Ablaufverfolgung festlegen“ aufgeführt.

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

Zeigt die aktuelle erweiterte WinHTTP-Proxyeinstellung an. Beachten Sie, dass SOCKS5 nicht unterstützt wird. Siehe auch set advproxy.

Syntax

show advproxy

Proxy anzeigen

Wichtig

show proxy ist veraltet. Verwenden Sie stattdessen show advproxy.

Zeigt die aktuelle WinHTTP-Proxyeinstellung an.

Syntax

show proxy

Ablaufverfolgung anzeigen

Zeigt die aktuellen WinHTTP-Ablaufverfolgungsparameter an.

Syntax

show tracing