Freigeben über


netsh winhttp

Mit dem netsh winhttp Befehl werden die WinHTTP-Einstellungen (Windows HTTP Services) konfiguriert und verwaltet. WinHTTP ist eine Microsoft-API, die von Anwendungen zum Senden von HTTP-Anforderungen verwendet wird und es Administratoren ermöglicht, die Netzwerkkommunikation für Anwendungen zu verwalten, die WinHTTP verwenden.

Syntax

netsh winhttp [dump | help | import | reset | set| show | ?]
netsh winhttp dump
netsh winhttp import proxy [source=]ie
netsh winhttp reset <autoproxy> <proxy> <tracing>
netsh winhttp set advproxy <settings-scope> <settings-file> <settings>
netsh winhttp set proxy [proxy-server=]<server name> [bypass-list=]<hosts list>
netsh winhttp set tracing
netsh winhttp show <advproxy> <proxy> <tracing>

Parameters

Command Description
http (Englisch) dump Erstellt ein Skript, das die aktuelle Kontextkonfiguration enthält. Das Skript kann in einer Datei gespeichert und zum Wiederherstellen von Einstellungen verwendet werden, wenn sie geändert werden oder auf einem anderen System repliziert werden müssen.
winhttp import proxy source=ie Importieren Sie Proxy-Einstellungen in die WinHTTP-Konfiguration aus den Einstellungen von Internet Explorer (IE). Es gibt keine direkte integrierte Unterstützung für das Importieren von Einstellungen aus anderen Browsern mit diesem Befehl.
winhttp reset<autoproxy> | <proxy> | <tracing> Bietet Optionen zum Zurücksetzen verschiedener Komponenten der WinHTTP-Konfiguration, z. B.:

  • autoproxy - Setzt den WinHTTP-Proxy-Autodiscovery-Dienst zurück. Dies wird verwendet, um alle Einstellungen oder den Cache im Zusammenhang mit der automatischen Erkennung von Proxyservern zu löschen.
  • proxy - Setzt die WinHTTP-Proxyeinstellung auf DIRECTzurück, wodurch alle konfigurierten Proxyserver effektiv entfernt und direkter Internetzugriff ohne Proxy zugelassen wird.
  • tracing - Für diesen Vorgang empfiehlt das System die Verwendung des Befehls, mit dem netsh trace stop alle Ablaufverfolgungsaktivitäten gestoppt und zurückgesetzt werden sollen.
  • winhttp set advproxy Konfiguriert erweiterte Proxy-Einstellungen für WinHTTP und bietet detaillierte Konfigurationen wie Umgehungslisten oder mehrere Proxy-Einstellungen.

    setting-scope - Gibt den Umfang der Einstellungen an. Zulässige Werte sind:
  • user - Wendet die Einstellungen auf den aktuellen Benutzer an.
  • machine - Wendet die Einstellungen systemweit an.

    settings-file - Gibt einen Pfad zu einer JSON-Datei an, die die Proxy-Konfigurationseinstellungen enthält. Diese Datei sollte ein JSON-Objekt mit den entsprechenden Eigenschaften enthalten.

    settings - Gibt die Proxy-Einstellungen direkt im JSON-Format an. Das JSON-Objekt muss die folgenden Eigenschaften enthalten:
  • Proxy - Ein Zeichenfolgenwert, der den Proxyserver darstellt.
  • ProxyBypass - Ein Zeichenfolgenwert, der Hosts auflistet, die den Proxy umgehen sollen.
  • AutoconfigUrl - Ein Zeichenfolgenwert für die URL eines automatischen Konfigurationsskripts.
  • AutoDetect - Ein boolescher Wert, der angibt, ob Proxy-Einstellungen automatisch erkannt werden sollen (true oder false).
  • winhttp set proxy Konfiguriert die grundlegenden Proxyeinstellungen für WinHTTP, indem ein Proxyserver und eine optionale Liste von Hosts angegeben werden, die den Proxy umgehen sollen.

  • proxy-server= - Gibt den Proxyserver an, der sowohl für HTTP- als auch für HTTPS-Protokolle verwendet werden soll. Sie können einen einzelnen Server und optional eine Portnummer (z. B. ) angeben. proxy.example.com:8080
  • bypass-list= - Stellt eine Liste von Hostnamen oder IP-Adressen bereit, die nicht über den Proxyserver verwendet werden sollen und auf die direkt zugegriffen werden soll. Die Liste sollte durch Semikolons getrennt werden. Verwenden Sie eine leere Zeichenfolge (""), um den Proxy für alle Kurznamen-Hosts (nicht vollqualifizierte Domänennamen) zu umgehen.
  • winhttp set tracing Bezieht sich auf das Starten von Netzwerkablaufverfolgungsaktivitäten zur Problembehandlung oder Überwachung. Es wird empfohlen, die folgende Methode zum Initiieren der Ablaufverfolgung zu verwenden, netsh trace start scenario=InternetClientwodurch die Ablaufverfolgung von Netzwerkdatenverkehrsaktivitäten speziell für Internetclientszenarien gestartet wird.
    winhttp show<advproxy> | <proxy> | <tracing> Bietet Optionen zum Anzeigen verschiedener WinHTTP-Konfigurationen, z. B.:

  • advproxy - Zeigt die aktuellen erweiterten Proxy-Einstellungen für WinHTTP an. Dies schließt alle detaillierten Proxy-Konfigurationen ein, die festgelegt wurden.
  • proxy - Zeigt die aktuellen Proxy-Grundeinstellungen für WinHTTP an. Dadurch werden der verwendete Proxyserver und alle konfigurierten Umgehungslisten angezeigt.
  • tracing - Zeigt Ablaufverfolgungsinformationen an. Es wird empfohlen, den netsh trace show Befehl zu verwenden.
  • help oder? Zeigt eine Liste der Befehle und deren Beschreibungen im aktuellen Kontext an.

    Examples

    Führen Sie den folgenden Befehl aus, um Proxyeinstellungen aus Internet Explorer in WinHTTP zu importieren:

    netsh winhttp import proxy source=ie
    

    Führen Sie den folgenden Befehl aus, um die WinHTTP-Proxyeinstellungen auf den Standardzustand zurückzusetzen:

    netsh winhttp reset proxy
    

    Führen Sie den folgenden Befehl aus, um erweiterte Proxyeinstellungen für WinHTTP auf Computerebene mithilfe einer JSON-Konfigurationszeichenfolge festzulegen:

    netsh winhttp set advproxy setting-scope=machine settings="{\"Proxy\":\"proxy.example.com:8080\",\"ProxyBypass\":\"*.example.com\",\"AutoconfigUrl\":\"http://config.example.com/proxy.pac\",\"AutoDetect\":true}"
    

    Führen Sie den folgenden Befehl aus, um die aktuellen WinHTTP-Proxyeinstellungen anzuzeigen:

    netsh winhttp show proxy
    

    See also