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を開始するには、次の方法を使用することをお勧めします。
    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