.server (Crear servidor de depuración)
El comando .server inicia un servidor de depuración, lo que permite una conexión remota a la sesión de depuración actual.
Importante
Hay consideraciones de seguridad importantes al usar la depuración remota. Para obtener más información, incluida la información sobre cómo habilitar el modo seguro, vea Consideraciones de seguridad para herramientas de depuración de Windows.
métodos de conexión recomendados, con algunos de seguridad adicionales
.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étodos de conexión no seguros
.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]
Parámetros
pipeName de
Cuando se usa el protocolo NPIPE o SPIPE, PipeName es una cadena que servirá como nombre de la canalización. Cada nombre de canalización debe identificar un servidor de depuración único. Si intenta reutilizar un nombre de canalización, recibirá un mensaje de error.
PipeName no debe contener espacios ni comillas.
pipeName puede incluir un código numérico de formato de printf, como %x o %d. El depurador lo reemplazará por el identificador de proceso del depurador. Un segundo código de este tipo se reemplazará por el identificador de subproceso del depurador.
socket
Cuando se usa el protocolo TCP o SSL, socket es el número de puerto de socket.
También es posible especificar un intervalo de puertos separados por dos puntos. El depurador comprobará cada puerto de este intervalo para ver si es gratis. Si encuentra un puerto libre y no se produce ningún error, se creará el servidor de depuración. El cliente de depuración tendrá que especificar el puerto real que se usa para conectarse al servidor. Para determinar el puerto real, use cualquiera de los métodos descritos en Buscar servidores de depuración; cuando se muestra este servidor de depuración, el puerto estará seguido de dos números separados por dos puntos. El primer número será el puerto real utilizado; se puede omitir el segundo. Por ejemplo, si el puerto se especificó como puerto=51:60 y el puerto 53 se usó realmente, los resultados de la búsqueda mostrarán "port=53:60". (Si usa el clicon parámetro para establecer una conexión inversa, el cliente de depuración puede especificar un intervalo de puertos de esta manera, mientras que el servidor debe especificar el puerto real usado).
clicon de =cliente
Cuando se usa el protocolo TCP o SSL y se especifica el parámetro clicon \\) son opcionales.
Cuando se usa clicon, es mejor iniciar el cliente de depuración antes de crear el servidor de depuración, aunque también se permite el orden habitual (servidor antes del cliente). Un servidor de conexión inversa no aparecerá cuando otro depurador muestre todos los servidores activos.
COMPort
Cuando se usa el protocolo COM, COMPort especifica el puerto COM que se va a usar. El prefijo COM es opcional (por ejemplo, tanto "com2" como "2" son aceptables).
BaudRate
Cuando se usa el protocolo COM, BaudRate especifica la velocidad de baudios a la que se ejecutará la conexión. Se permite cualquier velocidad de baudios compatible con el hardware.
COMChannel
Si se usa el protocolo COM, COMChannel especifica el canal COM que se usará para comunicarse con el cliente de depuración. Puede ser cualquier valor entre 0 y 254, ambos incluidos.
protocolo de
Si se usa el protocolo SSL o SPIPE, Protocol especifica el protocolo de canal seguro (canal S). Puede ser cualquiera de las cadenas tls1, pct1, ssl2 o ssl3.
cert de
Si se usa el protocolo SSL o SPIPE, cert especifica el certificado. Puede ser el nombre del certificado o la huella digital del certificado (la cadena de dígitos hexadecimales proporcionado por el complemento del certificado). Si se usa la sintaxis certuser=Cert, el depurador buscará el certificado en el almacén del sistema (el almacén predeterminado). Si se usa la sintaxis Cert, el depurador buscará el certificado en el almacén de máquinas. El certificado especificado debe admitir la autenticación del servidor.
ocultas
Impide que el servidor aparezca cuando otro depurador muestre todos los servidores activos.
password=password
Requiere un cliente de depuración para proporcionar la contraseña especificada para conectarse a la sesión de depuración.
contraseña puede ser cualquier cadena alfanumérica, hasta doce caracteres de longitud.
ipversion=6
(Herramientas de depuración para Windows 6.6.07 y versiones anteriores) Obliga al depurador a usar la versión 6 de IP en lugar de la versión 4 cuando se usa TCP para conectarse a Internet. En Windows Vista y versiones posteriores, el depurador intenta establecer el valor predeterminado automático en la versión 6 de IP, lo que hace que esta opción sea innecesaria.
IcfEnable
Hace que el depurador habilite las conexiones de puerto necesarias para la comunicación tcp o canalización con nombre cuando el firewall de conexión a Internet está activo. De forma predeterminada, el Firewall de conexión a Internet deshabilita los puertos usados por estos protocolos. Cuando Enable se usa con una conexión TCP, el depurador hace que Windows abra el puerto especificado por el parámetro Socket. Cuando IcfEnable se usa con una conexión de canalización con nombre, el depurador hace que Windows abra los puertos usados para canalizaciones con nombre (puertos 139 y 445). El depurador no cierra estos puertos una vez finalizada la conexión.
Medio ambiente
| Artículo | Descripción |
|---|---|
| Modos | Modo de usuario, modo kernel |
| Objetivos | Live, crash dump |
| Plataformas | Todo |
Información adicional
Para obtener información completa sobre cómo iniciar un servidor de depuración, consulte Activar un servidor de depuración. Para obtener ejemplos, consulte Ejemplos de cliente y servidor.
Observaciones
Este comando convierte el depurador actual en un servidor de depuración. Esto le permite iniciar el servidor después de que el depurador ya se esté ejecutando, mientras que la opción de línea de comandos -server solo se puede emitir cuando se inicia el depurador.
Esto permite que un cliente de depuración se conecte a la sesión de depuración actual. Tenga en cuenta que es posible iniciar varios servidores mediante diferentes opciones, lo que permite que diferentes tipos de clientes de depuración se unan a la sesión.
Importante
El uso de una contraseña con el protocolo TCP, NPIPE o COM solo ofrece una pequeña cantidad de protección, ya que la contraseña no está cifrada. Cuando se usa una contraseña junto con un protocolo SSL o SPIPE, la contraseña se cifra. Si desea establecer una sesión remota segura, debe usar el protocolo SSL o SPIPE.