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
http dump 创建包含当前上下文配置的脚本。 该脚本可以保存到文件中,并在设置被更改或需要在另一个系统上复制时用于恢复设置。
winhttp import proxy source=ie 将代理设置从 Internet Explorer (IE) 设置导入 WinHTTP 配置。 没有任何直接内置支持使用此命令从其他浏览器导入设置。
winhttp reset<autoproxy> | <proxy> | <tracing> 提供重置 WinHTTP 配置的各种组件的选项,例如:

  • autoproxy - 重置 WinHTTP 代理自动发现服务。 这用于清除与自动检测代理服务器相关的任何设置或缓存。
  • proxy - 将 WinHTTP 代理设置重置为 DIRECT,有效地删除任何已配置的代理服务器并允许在没有代理的情况下直接访问互联网。
  • tracing - 对于此作,系统建议使用该 netsh trace stop 命令,该命令旨在停止和重置任何跟踪活动。
  • winhttp set advproxy 为 WinHTTP 配置高级代理设置,提供详细配置,例如绕过列表或多个代理设置。

    setting-scope - 指定设置的范围。 可接受的值为:
  • user - 将设置应用于当前用户。
  • machine - 在系统范围内应用设置。

    settings-file - 指定包含代理配置设置的 JSON 文件的路径。 此文件应包含具有相关属性的 JSON 对象。

    settings - 直接以 JSON 格式指定代理设置。 JSON 对象必须包含以下属性:
  • Proxy - 表示代理服务器的字符串值。
  • ProxyBypass - 列出应绕过代理的主机的字符串值。
  • AutoconfigUrl - 自动配置脚本的 URL 的字符串值。
  • AutoDetect - 一个布尔值,指示是否自动检测代理设置(true 或 false)。
  • winhttp set proxy 通过指定代理服务器和应绕过代理的可选主机列表来配置 WinHTTP 的基本代理设置。

  • proxy-server= - 指定要用于 HTTP 和 HTTPS 协议的代理服务器。 您可以指定单个服务器,也可以指定端口号(例如, proxy.example.com:8080)。
  • bypass-list= - 提供不应使用代理服务器而应直接访问的主机名或 IP 地址列表。 该列表应用分号分隔。 使用空字符串 ("") 绕过所有短名称主机(非完全限定域名)的代理。
  • winhttp set tracing 与启动网络跟踪活动以进行故障排除或监视有关。 它建议使用以下内容来启动跟踪, netsh trace start scenario=InternetClient这会开始专门针对 Internet 客户端方案跟踪网络流量活动。
    winhttp show<advproxy> | <proxy> | <tracing> 提供用于显示各种 WinHTTP 配置的选项,例如:

  • advproxy - 显示 WinHTTP 的当前高级代理设置。 这包括已设置的任何详细代理配置。
  • proxy - 显示 WinHTTP 的当前基本代理设置。 这会显示正在使用的代理服务器以及已配置的任何旁路列表。
  • tracing - 显示跟踪信息。 建议使用该 netsh trace show 命令。
  • help? 显示当前上下文中的命令及其描述的列表。

    Examples

    若要将代理设置从 Internet Explorer 导入 WinHTTP,请运行以下命令:

    netsh winhttp import proxy source=ie
    

    若要将 WinHTTP 代理设置重置为默认状态,请运行以下命令:

    netsh winhttp reset proxy
    

    若要使用 JSON 配置字符串在计算机级别为 WinHTTP 设置高级代理设置,请运行以下命令:

    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 代理设置,请运行以下命令:

    netsh winhttp show proxy
    

    See also