Partager via


netsh winhttp

La netsh winhttp commande configure et gère les paramètres WinHTTP (Windows HTTP Services). WinHTTP est une API Microsoft utilisée par les applications pour effectuer des requêtes HTTP qui permet aux administrateurs de gérer les communications réseau pour les applications qui utilisent 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 Crée un script contenant la configuration de contexte actuelle. Le script peut être enregistré dans un fichier et utilisé pour restaurer les paramètres s’ils sont modifiés ou doivent être répliqués sur un autre système.
winhttp import proxy source=ie Importez les paramètres de proxy dans la configuration WinHTTP à partir des paramètres d’Internet Explorer (IE). Il n’existe pas de prise en charge intégrée directe de l’importation de paramètres à partir d’autres navigateurs à l’aide de cette commande.
winhttp reset<autoproxy> | <proxy> | <tracing> Fournit des options pour réinitialiser divers composants de la configuration WinHTTP, tels que :

  • autoproxy - Réinitialise le service de découverte automatique du proxy WinHTTP. Ceci est utilisé pour effacer tous les paramètres ou le cache liés à la détection automatique des serveurs proxy.
  • proxy - Réinitialise le paramètre de proxy WinHTTP sur DIRECT, ce qui supprime effectivement tout serveur proxy configuré et autorise un accès direct à Internet sans proxy.
  • tracing - Pour cette opération, le système conseille d’utiliser la netsh trace stop commande, qui est destinée à arrêter et à réinitialiser toutes les activités de suivi.
  • winhttp set advproxy Configure les paramètres de proxy avancés pour WinHTTP, en fournissant des configurations détaillées telles que des listes de contournement ou plusieurs paramètres de proxy.

    setting-scope - Spécifie l’étendue des paramètres. Les valeurs acceptables sont les suivantes :
  • user - Applique les paramètres à l’utilisateur actuel.
  • machine - Applique les paramètres à l’ensemble du système.

    settings-file - Spécifie un chemin d’accès à un fichier JSON contenant les paramètres de configuration du proxy. Ce fichier doit contenir un objet JSON avec les propriétés appropriées.

    settings - Spécifie les paramètres de proxy directement au format JSON. L’objet JSON doit inclure les propriétés suivantes :
  • Proxy - Une valeur de chaîne représentant le serveur proxy.
  • ProxyBypass - Une valeur de chaîne répertoriant les hôtes qui doivent contourner le proxy.
  • AutoconfigUrl - Une valeur de chaîne pour l’URL d’un script de configuration automatique.
  • AutoDetect - Une valeur booléenne indiquant s’il faut détecter automatiquement les paramètres de proxy (true ou false).
  • winhttp set proxy Configure les paramètres de proxy de base pour WinHTTP en spécifiant un serveur proxy et une liste facultative d’hôtes qui doivent contourner le proxy.

  • proxy-server= - Spécifie le serveur proxy à utiliser pour les protocoles HTTP et HTTPS. Vous pouvez désigner un seul serveur et, éventuellement, un numéro de port (par exemple, proxy.example.com:8080).
  • bypass-list= - Fournit une liste de noms d’hôtes ou d’adresses IP qui ne doivent pas utiliser le serveur proxy et qui doivent être accessibles directement. La liste doit être séparée par des points-virgules. Utilisez une chaîne vide ("") pour contourner le proxy pour tous les hôtes à noms courts (noms de domaine non complets).
  • winhttp set tracing Lié au démarrage des activités de traçage du réseau à des fins de dépannage ou de surveillance. Il suggère d’utiliser ce qui suit pour lancer le suivi, netsh trace start scenario=InternetClientqui commence à suivre les activités de trafic réseau spécifiquement pour les scénarios de client Internet.
    winhttp show<advproxy> | <proxy> | <tracing> Fournit des options permettant d’afficher diverses configurations WinHTTP, telles que :

  • advproxy - Affiche les paramètres de proxy avancés actuels pour WinHTTP. Cela inclut toutes les configurations de proxy détaillées qui ont été définies.
  • proxy - Affiche les paramètres de proxy de base actuels pour WinHTTP. Cela révèle le serveur proxy utilisé et toutes les listes de contournement qui ont été configurées.
  • tracing - Affiche les informations de traçage. Il est conseillé d’utiliser la netsh trace show commande.
  • help ou? Affiche une liste de commandes et leurs descriptions dans le contexte actuel.

    Examples

    Pour importer les paramètres de proxy d’Internet Explorer dans WinHTTP, exécutez la commande suivante :

    netsh winhttp import proxy source=ie
    

    Pour réinitialiser les paramètres de proxy WinHTTP à leur état par défaut, exécutez la commande suivante :

    netsh winhttp reset proxy
    

    Pour définir les paramètres de proxy avancés pour WinHTTP au niveau de l’ordinateur à l’aide d’une chaîne de configuration JSON, exécutez la commande suivante :

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

    Pour afficher les paramètres de proxy WinHTTP actuels, exécutez la commande suivante :

    netsh winhttp show proxy
    

    See also