netsh winhttp

netsh winhttp 命令會設定和管理 WinHTTP (Windows HTTP 服務) 設定。 WinHTTP 是應用程式用來發出 HTTP 要求的 Microsoft API,可讓系統管理員管理使用 WinHTTP 之應用程式的網路通訊。

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
網址 dump 建立包含目前前後關聯組態的指令碼。 腳本可以儲存到檔案中,並在設定被更改或需要在另一個系統上複製時用於還原設定。
winhttp import proxy source=ie 從 Internet Explorer (IE) 設定將 Proxy 設定匯入 WinHTTP 組態。 沒有任何直接內建支援使用此命令從其他瀏覽器匯入設定。
winhttp reset<autoproxy> | <proxy> | <tracing> 提供重設 WinHTTP 設定各種元件的選項,例如:

  • autoproxy - 重設 WinHTTP Proxy 自動探索服務。 這用於清除與自動偵測代理伺服器相關的任何設定或快取。
  • proxy - 將 WinHTTP Proxy 設定重設為 DIRECT,有效移除任何已設定的 Proxy 伺服器,並允許在沒有 Proxy 的情況下直接存取網際網路。
  • tracing - 對於此作業,系統建議使用指令 netsh trace stop ,其目的是停止及重設任何追蹤活動。
  • winhttp set advproxy 配置 WinHTTP 的進階代理設置,提供詳細的配置,例如繞過清單或多個代理設定。

    setting-scope - 指定設定的範圍。 可接受的值為:
  • user - 將設定套用至目前使用者。
  • machine - 在全系統套用設定。

    settings-file - 指定包含 Proxy 配置設定之 JSON 檔案的路徑。 此檔案應包含具有相關屬性的 JSON 物件。

    settings - 直接以 JSON 格式指定 Proxy 設定。 JSON 物件必須包含下列屬性:
  • Proxy - 代表 Proxy 伺服器的字串值。
  • ProxyBypass - 列出應略過 Proxy 的主機的字串值。
  • AutoconfigUrl - 自動配置指令碼 URL 的字串值。
  • AutoDetect - 布林值,指出是否自動偵測 Proxy 設定 (true 或 false)。
  • winhttp set proxy 指定 Proxy 伺服器,以及應該略過 Proxy 的主機選擇性清單,以設定 WinHTTP 的基本 Proxy 設定。

  • proxy-server= - 指定要用於 HTTP 及 HTTPS 通訊協定的 Proxy 伺服器。 您可以指定單一伺服器,並選擇性地指定埠號 (例如 proxy.example.com:8080)。
  • bypass-list= - 提供不應使用 Proxy 伺服器而應直接存取的主機名稱或 IP 位址清單。 該列表應用分號分隔。 使用空字串 ("") 來略過所有短名稱主機 (非完整網域名稱) 的 Proxy。
  • winhttp set tracing 與啟動網路追蹤活動以進行疑難排解或監視有關。 它建議使用下列項目來起始追蹤, netsh trace start scenario=InternetClient這會開始追蹤網路流量活動,特別是針對網際網路用戶端案例。
    winhttp show<advproxy> | <proxy> | <tracing> 提供顯示各種 WinHTTP 設定的選項,例如:

  • advproxy - 顯示 WinHTTP 的目前進階 Proxy 設定。 這包括已設定的任何詳細 Proxy 組態。
  • proxy - 顯示 WinHTTP 的目前基本 Proxy 設定。 這會顯示正在使用的代理伺服器以及已配置的任何略過清單。
  • tracing - 顯示追蹤資訊。 建議使用命令 netsh trace show
  • help ? 在目前內容中顯示命令及其描述的清單。

    Examples

    若要將 Proxy 設定從 Internet Explorer 匯入 WinHTTP,請執行下列命令:

    netsh winhttp import proxy source=ie
    

    若要將 WinHTTP Proxy 設定重設為預設狀態,請執行下列命令:

    netsh winhttp reset proxy
    

    若要使用 JSON 組態字串在機器層級設定 WinHTTP 的進階 Proxy 設定,請執行下列命令:

    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}"
    

    若要顯示目前的 WinHTTP Proxy 設定,請執行下列命令:

    netsh winhttp show proxy
    

    See also