Aktivera en smart klient

När DbgSrv-processervern har aktiverats kan du skapa en smart klient på en annan dator och starta en felsökningssession.

Det finns två sätt att starta en smart klient: genom att starta CDB eller WinDbg med -premote kommandoradsalternativeteller med hjälp av det grafiska WinDbg-gränssnittet.

Viktig

Det finns viktiga säkerhetsaspekter när du använder fjärrfelsökning. Mer information, inklusive information om hur du aktiverar säkert läge, finns i Säkerhet vid fjärrfelsökning och säkerhetsöverväganden för Windows Felsökningsverktyg.

Protokollet för den smarta klienten måste matcha protokollet för processervern. Den allmänna syntaxen för att starta en smart klient beror på vilket protokoll som används. Följande alternativ finns:

Rekommenderade anslutningsmetoder, med ytterligare säkerhet

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

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

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

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

Osäkra anslutningsmetoder

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

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

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

Om du vill använda det grafiska gränssnittet för att ansluta till en processserver måste WinDbg vara i vilande läge – antingen måste det ha startats utan kommandoradsparametrar eller så måste den ha avslutat föregående felsökningssession. Välj filen | Anslut till menykommandot Remote Stub. När dialogrutan Anslut till fjärrstubservern visas anger du någon av följande strängar i textrutan Anslutningssträng:

Rekommenderade anslutningsmetoder, med ytterligare säkerhet

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] 

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

Osäkra anslutningsmetoder

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] 

Du kan också använda knappen Bläddra för att hitta aktiva processerver.

Parametrar

Parametrarna i föregående kommandon har följande möjliga värden:

Felsökningsprogram
Detta kan vara CDB eller WinDbg.

Server
Det här är nätverksnamnet eller IP-adressen för den dator där processervern skapades. De två inledande omvänt snedstrecken (\) är valfria på kommandoraden, men tillåts inte i dialogrutan WinDbg.

pipe=PipeName
Om NPIPE- eller SPIPE-protokollet används är PipeName det namn som angavs för röret när processservern skapades.

Om du inte är inloggad på klientdatorn med ett konto som har åtkomst till serverdatorn måste du ange ett användarnamn och lösenord. Ange följande kommando i kommandotolken på klientdatorn.

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

där Server är namnet på serverdatorn och UserName är namnet på ett konto som har åtkomst till serverdatorn.

När du uppmanas att ange lösenordet för UserName.

När det här kommandot har slutförts kan du aktivera en smart klient med hjälp av kommandoradsalternativet -premote eller med hjälp av det grafiska gränssnittet WinDbg.

Obs Du kan behöva aktivera fil- och skrivardelning på serverdatorn. I Kontrollpanelen navigerar du till Nätverk och Internet > Nätverks- och delningscenter> Avancerade delningsinställningar. Välj Aktivera fil- och skrivardelning.

port=Socket
Om TCP- eller SSL-protokoll används är Socket- samma socketportnummer som användes när processervern skapades.

clicon
Anger att processervern ska försöka ansluta till den smarta klienten via en omvänd anslutning. Klienten måste använda clicon om och endast om servern använder clicon. I de flesta fall startas den smarta klienten före processervern när en omvänd anslutning används.

port=COMPort
Om COM-protokollet används anger COMPort com-porten som ska användas. Prefixet "COM" är valfritt – till exempel är både "com2" och "2" acceptabla.

baud=BaudRate
Om COM-protokollet används ska BaudRate- matcha den baud-hastighet som valdes när processervern skapades.

channel=COMChannel
Om COM-protokollet används bör COMChannel- matcha kanalnumret som valdes när processervern skapades.

proto=Protocol
Om SSL- eller SPIPE-protokoll används ska Protocol matcha det säkra protokoll som användes när processervern skapades.

Cert
Om SSL- eller SPIPE-protokollet används bör du använda identiska certuser=Cert eller machuser=Cert parameter som användes när processervern skapades.

password=Password
Om ett lösenord användes när processervern skapades måste Lösenord anges för att kunna skapa den smarta klienten. Det måste matcha det ursprungliga lösenordet. Lösenord är skiftlägeskänsliga. Om fel lösenord anges anger felmeddelandet "Fel 0x80004005".

ipversion=6
(Felsökningsverktyg för Windows 6.6.07 och tidigare endast) Tvingar felsökaren att använda IP-version 6 i stället för version 4 när du använder TCP för att ansluta till Internet. I Windows Vista och senare versioner försöker felsökaren automatiskt att använda IP-version 6 som standard, vilket gör det här alternativet onödigt.

alternativ
Eventuella ytterligare kommandoradsparametrar kan placeras här. En fullständig lista finns i Command-Line Alternativ. Om du använder CDB måste du ange den process som du vill felsöka. Om du använder WinDbg kan du ange processen på kommandoraden eller via det grafiska gränssnittet.

Eftersom processservern helt enkelt fungerar som en gateway för den smarta klienten blir de ytterligare alternativ samma som de du skulle använda om du startade ett felsökningsprogram i användarläge på samma dator som målprogrammet.

Om du använder alternativet -premote med .attach (Attach to Process) eller .create (Create Process)är parametrarna samma som ovan.

Felsökning

Om du ser det här meddelandet: Klienten använder inte samma version av fjärrkommunikationsprotokollet som servern anger detta att den version av DbgSrv som du försöker ansluta till använder en annan protokollversion än windbg-versionen.

Det är ovanligt att protokolländringar görs. När detta inträffar måste du använda matchande versioner av den senaste tillgängliga versionen av DbgSrv och WinDbg (klassisk) eller WinDbg. Information om hur du laddar ned den senaste versionen finns i Felsökningsverktyg för Windows.