Een foutopsporingsclient activeren

Zodra de foutopsporingsserver is geactiveerd, kunt u een foutopsporingsclient op een andere computer starten en verbinding maken met de foutopsporingssessie.

Er zijn twee manieren om een foutopsporingsclient te starten: met behulp van de -remote opdrachtregeloptieof met behulp van de grafische WinDbg-interface.

Het protocol van de client moet overeenkomen met het protocol van de server. De algemene syntaxis voor het starten van een foutopsporingsclient is afhankelijk van het gebruikte protocol. De volgende opties zijn beschikbaar:

Aanbevolen verbindingsmethoden, met extra beveiliging

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] 

niet-beveiligde verbindingsmethoden

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] 

Als u de grafische interface wilt gebruiken om verbinding te maken met een sessie voor externe foutopsporing, moet WinDbg zich in de slaapstand bevinden. Deze moet zijn gestart zonder opdrachtregelparameters of de vorige foutopsporingssessie zijn beëindigd. Selecteer het -bestand | Maak verbinding met externe sessie menuopdracht of druk op de sneltoets Ctrl+R. Wanneer het dialoogvenster Verbinding maken met externe foutopsporingsprogrammasessie wordt weergegeven, voert u een van de volgende tekenreeksen in het tekstvak verbindingsreeks in:

Aanbevolen verbindingsmethoden, met extra beveiliging

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] 

niet-beveiligde verbindingsmethoden

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] 

U kunt ook de knop Bladeren gebruiken om actieve foutopsporingsservers te vinden.

Belangrijk

Er zijn belangrijke beveiligingsoverwegingen bij het gebruik van externe foutopsporing. Zie Security During Remote Debugging and Security Considerations for Windows Debugging Toolsvoor meer informatie, waaronder informatie over het inschakelen van de beveiligde modus.

Parameters

De parameters in de voorgaande opdrachten hebben de volgende mogelijke waarden:

foutopsporingsprogramma
Dit hoeft niet hetzelfde foutopsporingsprogramma te zijn als het foutopsporingsprogramma dat wordt gebruikt door de foutopsporingsclient. WinDbg, KD en CDB zijn allemaal uitwisselbaar voor externe foutopsporing via het foutopsporingsprogramma.

Server
Dit is de netwerknaam of het IP-adres van de computer waarop de foutopsporingsserver is gemaakt. De twee eerste backslashes (\) zijn optioneel op de opdrachtregel, maar zijn niet toegestaan in het dialoogvenster WinDbg.

pipe=PipeName
Als het NPIPE- of SPIPE-protocol wordt gebruikt, is PipeName de naam die aan de pijp is gegeven toen de server werd gemaakt.

Als u niet bent aangemeld bij de clientcomputer met een account dat toegang heeft tot de servercomputer, moet u een gebruikersnaam en wachtwoord opgeven. Voer op de clientcomputer in een opdrachtpromptvenster de volgende opdracht in.

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

waarbij Server de naam van de servercomputer is en Gebruikersnaam de naam is van een account dat toegang heeft tot de servercomputer.

Wanneer u hierom wordt gevraagd, voert u het wachtwoord in voor gebruikersnaam.

Nadat deze opdracht is geslaagd, kunt u een foutopsporingsclient activeren met behulp van de -remote opdrachtregeloptie of met behulp van de grafische WinDbg-interface.

Opmerking Mogelijk moet u het delen van bestanden en printers op de servercomputer inschakelen. Navigeer in het Configuratiescherm naar Netwerk- en Internet > Network and Sharing Center> Geavanceerde instellingen voor delen. Selecteer Bestands- en printerdeling inschakelen.

poort=Socket-
Als TCP- of SSL-protocol wordt gebruikt, is Socket hetzelfde poortnummer dat is gebruikt toen de server werd gemaakt.

clicon
Hiermee geeft u op dat de foutopsporingsserver probeert verbinding te maken met de client via een omgekeerde verbinding. De client moet clicon gebruiken als en alleen als de server clicongebruikt. In de meeste gevallen wordt de foutopsporingsclient gestart vóór de foutopsporingsserver wanneer een omgekeerde verbinding wordt gebruikt.

-poort=COMPort-
Als het COM-protocol wordt gebruikt, geeft COMPort- de COM-poort op die moet worden gebruikt. Het voorvoegsel 'COM' is optioneel, bijvoorbeeld zowel 'com2' als '2'.

baud=BaudRate
Als het COM-protocol wordt gebruikt, moet BaudRate- overeenkomen met de baudrate die is gekozen toen de server werd gemaakt.

channel=COMChannel-
Als het COM-protocol wordt gebruikt, moet COMChannel- overeenkomen met het kanaalnummer dat is gekozen toen de server werd gemaakt.

proto=Protocol
Als het SSL- of SPIPE-protocol wordt gebruikt, moet Protocol overeenkomen met het beveiligde protocol dat wordt gebruikt toen de server werd gemaakt.

certificaat
Als het SSL- of SPIPE-protocol wordt gebruikt, moet u de identieke certuser=certificaatcertificaat of Cert parameter gebruiken die is gebruikt toen de server werd gemaakt.

wachtwoord=Wachtwoord
Als er een wachtwoord is gebruikt toen de server werd gemaakt, moet Wachtwoord worden opgegeven om de foutopsporingsclient te maken. Deze moet overeenkomen met het oorspronkelijke wachtwoord. Wachtwoorden zijn hoofdlettergevoelig. Als het verkeerde wachtwoord is opgegeven, geeft het foutbericht 'Fout 0x80004005' op. Wachtwoorden moeten twaalf tekens of minder lang zijn.

ipversion=6
(Alleen hulpprogramma's voor foutopsporing voor Windows 6.6.07 en eerder) Dwingt het foutopsporingsprogramma om IP-versie 6 te gebruiken in plaats van versie 4 wanneer u TCP gebruikt om verbinding te maken met internet. In Windows Vista en latere versies probeert het foutopsporingsprogramma automatisch standaard ip-versie 6 te gebruiken, waardoor deze optie niet nodig is.

Opdrachtregelopties voor het starten van nieuwe foutopsporingssessies (zoals -p) kunnen niet worden gebruikt door de foutopsporingsclient, maar alleen door de server. Configuratieopties (zoals -n) werken vanaf de client of de server.