Activación de un cliente de depuración

Una vez activado el servidor de depuración, puede iniciar un cliente de depuración en otro equipo y conectarse a la sesión de depuración.

Hay dos maneras de iniciar un cliente de depuración: mediante el uso de la opción de línea de comandos -remote o mediante la interfaz gráfica de WinDbg.

El protocolo del cliente debe coincidir con el protocolo del servidor. La sintaxis general para iniciar un cliente de depuración depende del protocolo usado. Existen las siguientes opciones:

métodos de conexión recomendados, con algunos de seguridad adicionales

Debugger -remote spipe:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,pipe=PipeName[,password=Password] 

Debugger -remote ssl:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,port=Socket[,password=Password] 

Debugger -remote ssl:proto=Protocol,{certuser=Cert|machuser=Cert},clicon=Server,port=Socket[,password=Password] 

métodos de conexión no seguros

Debugger -remote npipe:server=Server,pipe=PipeName[,password=Password] 

Debugger -remote tcp:server=Server,port=Socket[,password=Password][,ipversion=6] 

Debugger -remote tcp:clicon=Server,port=Socket[,password=Password][,ipversion=6] 

Debugger -remote com:port=COMPort,baud=BaudRate,channel=COMChannel[,password=Password] 

Para usar la interfaz gráfica para conectarse a una sesión de depuración remota, WinDbg debe estar en modo inactivo; debe haberse iniciado sin parámetros de línea de comandos o debe haber finalizado la sesión de depuración anterior. Seleccione el archivo | Conéctese a la sesión remota comando de menú o presione la tecla de método abreviado CTRL+R. Cuando aparezca el cuadro de diálogo conectar a la sesión de depurador remoto , escriba una de las siguientes cadenas en el cuadro de texto cadena de conexión :

métodos de conexión recomendados, con algunos de seguridad adicionales

spipe:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,pipe=PipeName[,password=Password] 

ssl:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,port=Socket[,password=Password] 

ssl:proto=Protocol,{certuser=Cert|machuser=Cert},clicon=Server,port=Socket[,password=Password] 

métodos de conexión no seguros

npipe:server=Server,pipe=PipeName[,password=Password] 

tcp:server=Server,port=Socket[,password=Password][,ipversion=6] 

tcp:clicon=Server,port=Socket[,password=Password][,ipversion=6] 

com:port=COMPort,baud=BaudRate,channel=COMChannel[,password=Password] 

Como alternativa, puede usar el botón Examinar para buscar servidores de depuración activos.

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, consulta Security During Remote Debugging and Security Considerations for Windows Debugging Tools.

Parámetros

Los parámetros de los comandos anteriores tienen los siguientes valores posibles:

del depurador de
Esto no tiene que ser el mismo depurador que el que usa el cliente de depuración: WinDbg, KD y CDB son intercambiables para fines de depuración remota a través del depurador.

Server
Este es el nombre de red o la dirección IP del equipo en el que se creó el servidor de depuración. Las dos barras diagonales inversas iniciales (\) son opcionales en la línea de comandos, pero no se permiten en el cuadro de diálogo WinDbg.

pipe=PipeName
Si se usa el protocolo NPIPE o SPIPE, PipeName es el nombre que se dio a la canalización cuando se creó el servidor.

Si no ha iniciado sesión en el equipo cliente con una cuenta que tenga acceso al equipo servidor, debe proporcionar un nombre de usuario y una contraseña. En el equipo cliente, en una ventana del símbolo del sistema, escriba el siguiente comando.

net use \\Server\ipc$ /user:UserName

donde Servidor es el nombre del equipo servidor y NombreDeUsuario es el nombre de una cuenta que tiene acceso al equipo servidor.

Cuando se le solicite, escriba la contraseña de UserName.

Una vez que este comando se realiza correctamente, puede activar un cliente de depuración mediante la opción de línea de comandos -remote -remote o mediante la interfaz gráfica de WinDbg.

Nota Es posible que tenga que habilitar el uso compartido de archivos e impresoras en el equipo servidor. En el Panel de control, vaya a Red e Internet > Centro de red y uso compartido> Configuración de uso compartido avanzado. Seleccione Activar el uso compartido de archivos e impresoras.

puerto de = socket de
Si se usa el protocolo TCP o SSL, socket es el mismo número de puerto de socket que se usó cuando se creó el servidor.

clicon
Especifica que el servidor de depuración intentará conectarse al cliente a través de una conexión inversa. El cliente debe usar clicon si y solo si el servidor usa clicon. En la mayoría de los casos, el cliente de depuración se inicia antes del servidor de depuración cuando se usa una conexión inversa.

port=COMPort
Si 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.

baud=BaudRate
Si se usa el protocolo COM, BaudRate debe coincidir con la velocidad de baudios elegida cuando se creó el servidor.

channel=COMChannel
Si se usa el protocolo COM, COMChannel debe coincidir con el número de canal elegido cuando se creó el servidor.

proto=Protocol
Si se usa el protocolo SSL o SPIPE, Protocol debe coincidir con el protocolo seguro que se usó cuando se creó el servidor.

cert de
Si se usa el protocolo SSL o SPIPE, debe usar el parámetro certuser= idénticoCert o Cert parámetro que se usó cuando se creó el servidor.

password=password
Si se usó una contraseña cuando se creó el servidor, se debe proporcionar contraseña para crear el cliente de depuración. Debe coincidir con la contraseña original. Las contraseñas distinguen mayúsculas de minúsculas. Si se proporciona la contraseña incorrecta, el mensaje de error especificará "Error 0x80004005". Las contraseñas deben tener doce caracteres o menos 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.

Las opciones de línea de comandos usadas para iniciar nuevas sesiones de depuración (como -p) no pueden usarse en el cliente de depuración, sino solo en el servidor. Las opciones de configuración (como -n) funcionarán desde el cliente o el servidor.