.server (Créer un serveur de débogage)

La commande .server démarre un serveur de débogage, ce qui permet une connexion à distance à la session de débogage actuelle.

Important

Il existe des considérations importantes en matière de sécurité lors de l’utilisation du débogage à distance. Pour plus d’informations, notamment sur l’activation du mode sécurisé, consultez Considérations relatives à la sécurité pour les outils de débogage Windows.

méthodes de connexion recommandées, avec des de sécurité supplémentaires

.server spipe:proto=Protocol,{certuser=Cert|machuser=Cert},pipe=PipeName[,hidden][,password=Password] 
.server ssl:proto=Protocol,{certuser=Cert|machuser=Cert},port=Socket[,hidden][,password=Password] 
.server ssl:proto=Protocol,{certuser=Cert|machuser=Cert},port=Socket,clicon=Client[,password=Password] 

méthodes de connexion non sécurisées

.server npipe:pipe=PipeName[,hidden][,password=Password][,IcfEnable] 
.server tcp:port=Socket[,hidden][,password=Password][,ipversion=6][,IcfEnable] 
.server tcp:port=Socket,clicon=Client[,password=Password][,ipversion=6] 
.server com:port=COMPort,baud=BaudRate,channel=COMChannel[,hidden][,password=Password] 

Paramètres

PipeName
Lorsque le protocole NPIPE ou SPIPE est utilisé, PipeName est une chaîne qui servira de nom au canal. Chaque nom de canal doit identifier un serveur de débogage unique. Si vous tentez de réutiliser un nom de canal, vous recevrez un message d’erreur. PipeName ne doit pas contenir d’espaces ou de guillemets. PipeName peut inclure un code de format de format de stylenumérique, tel que %x ou %d. Le débogueur le remplace par l’ID de processus du débogueur. Un deuxième code de ce type sera remplacé par l’ID de thread du débogueur.

socket
Lorsque le protocole TCP ou SSL est utilisé, socket est le numéro de port du socket.

Il est également possible de spécifier une plage de ports séparés par un signe deux-points. Le débogueur vérifie chaque port de cette plage pour voir s’il est gratuit. S’il trouve un port gratuit et qu’aucune erreur ne se produit, le serveur de débogage est créé. Le client de débogage doit spécifier le port réel utilisé pour se connecter au serveur. Pour déterminer le port réel, utilisez l’une des méthodes décrites dans Recherche de serveurs de débogage; lorsque ce serveur de débogage est affiché, le port est suivi de deux nombres séparés par un signe deux-points. Le premier nombre sera le port réel utilisé ; la seconde peut être ignorée. Par exemple, si le port a été spécifié en tant que port=51:60 et que le port 53 a été réellement utilisé, les résultats de la recherche affichent « port=53:60 ». (Si vous utilisez le paramètre clicon pour établir une connexion inversée, le client de débogage peut spécifier une plage de ports de cette façon, tandis que le serveur doit spécifier le port réel utilisé.)

clicon=client
Lorsque le protocole TCP ou SSL est utilisé et que le paramètre clicon est spécifié, une connexion inversée est ouverte. Cela signifie que le serveur de débogage tente de se connecter au client de débogage au lieu de laisser le client lancer le contact. Cela peut être utile si vous avez un pare-feu qui empêche une connexion dans la direction habituelle. client spécifie le nom réseau de l’ordinateur sur lequel le client de débogage existe ou sera créé. Les deux barres obliques inverses initiales (\\) sont facultatives.

Lorsque clicon est utilisé, il est préférable de démarrer le client de débogage avant la création du serveur de débogage, bien que l’ordre habituel (serveur avant le client) soit également autorisé. Un serveur de connexion inverse n’apparaît pas quand un autre débogueur affiche tous les serveurs actifs.

COMPort
Lorsque le protocole COM est utilisé, COMPort spécifie le port COM à utiliser. Le préfixe COM est facultatif (par exemple, « com2 » et « 2 » sont acceptables).

BaudRate
Lorsque le protocole COM est utilisé, BaudRate spécifie la vitesse de baud à laquelle la connexion s’exécute. Tout taux de baud pris en charge par le matériel est autorisé.

comChannel
Si le protocole COM est utilisé, COMChannel spécifie le canal COM à utiliser pour communiquer avec le client de débogage. Il peut s’agir de n’importe quelle valeur comprise entre 0 et 254, inclus.

protocole
Si le protocole SSL ou SPIPE est utilisé, protocole spécifie le protocole S-Channel (Secure Channel). Il peut s’agir de l’une des chaînes tls1, pct1, ssl2 ou ssl3.

certificat
Si le protocole SSL ou SPIPE est utilisé, certificat spécifie le certificat. Il peut s’agir du nom du certificat ou de l’empreinte numérique du certificat (chaîne de chiffres hexadécimaux donnés par le composant logiciel enfichable du certificat). Si la syntaxe certuser=Cert est utilisée, le débogueur recherche le certificat dans le magasin système (magasin par défaut). Si la syntaxe Cert est utilisée, le débogueur recherche le certificat dans le magasin d’ordinateurs. Le certificat spécifié doit prendre en charge l’authentification du serveur.

masqué
Empêche le serveur d’apparaître lorsqu’un autre débogueur affiche tous les serveurs actifs.

password=Mot de passe
Nécessite un client de débogage pour fournir le mot de passe spécifié afin de se connecter à la session de débogage. mot de passe peut être n’importe quelle chaîne alphanumérique, jusqu’à douze caractères de longueur.

ipversion=6
(Outils de débogage pour Windows 6.6.07 et versions antérieures uniquement) Force le débogueur à utiliser l’adresse IP version 6 plutôt que la version 4 lors de l’utilisation de TCP pour se connecter à Internet. Dans Windows Vista et versions ultérieures, le débogueur tente d’effectuer la version IP par défaut automatiquement vers la version 6, ce qui rend cette option inutile.

IcfEnable
Provoque le débogueur pour activer les connexions de port nécessaires pour la communication tcp ou canal nommé lorsque le pare-feu de connexion Internet est actif. Par défaut, le pare-feu de connexion Internet désactive les ports utilisés par ces protocoles. Lorsque IcfEnable est utilisé avec une connexion TCP, le débogueur entraîne l’ouverture de Windows par le port spécifié par le paramètre Socket. Lorsque IcfEnable est utilisé avec une connexion de canal nommé, le débogueur amène Windows à ouvrir les ports utilisés pour les canaux nommés (ports 139 et 445). Le débogueur ne ferme pas ces ports une fois la connexion terminée.

Environnement

Article	Description
Modes	Mode utilisateur, mode noyau
Cibles	Vidage en direct et incident
Plates-formes	Tout

Informations supplémentaires

Pour plus d’informations sur le démarrage d’un serveur de débogage, consultez Activation d’un serveur de débogage. Pour obtenir des exemples, consultez Exemples client et serveur.

Remarques

Cette commande transforme le débogueur actuel en serveur de débogage. Cela vous permet de démarrer le serveur une fois que le débogueur est déjà en cours d’exécution, tandis que l’option de ligne de commande -server ne peut être émise que lorsque le débogueur est démarré.

Cela permet à un client de débogage de se connecter à la session de débogage actuelle. Notez qu’il est possible de démarrer plusieurs serveurs à l’aide de différentes options, ce qui permet aux différents types de clients de débogage de rejoindre la session.

Important

L’utilisation d’un mot de passe avec le protocole TCP, NPIPE ou COM offre uniquement une petite quantité de protection, car le mot de passe n’est pas chiffré. Lorsque vous utilisez un mot de passe avec un protocole SSL ou SPIPE, le mot de passe est chiffré. Si vous souhaitez établir une session à distance sécurisée, vous devez utiliser le protocole SSL ou SPIPE.