Aktivera en smart klient (kernelläge)

När KD-anslutningsservern 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 KD eller WinDbg med kernelprotokollet kdsrveller med hjälp av det grafiska WinDbg-gränssnittet.

Du måste ange det protokoll för fjärröverföring som används av KD-anslutningsservern. Du kan också ange protokollet för den faktiska kernelanslutningen mellan KD-anslutningsservern och måldatorn, eller så kan du använda standardvärdet.

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.

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 -k kdsrv:server=@{spipe:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,pipe=PipeName[,password=Password]},trans=@{ConnectType} [Options]

Debugger -k kdsrv:server=@{ssl:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,port=Socket[,password=Password]},trans=@{ConnectType} [Options]

Debugger -k kdsrv:server=@{ssl:proto=Protocol,{certuser=Cert|machuser=Cert},clicon=Server,port=Socket[,password=Password]},trans=@{ConnectType} [Options]

Debugger -k kdsrv:server=@{com:port=COMPort,baud=BaudRate,channel=COMChannel[,password=Password]},trans=@{ConnectType} [Options]

Osäkra anslutningsmetoder

Debugger -k kdsrv:server=@{npipe:server=Server,pipe=PipeName[,password=Password]},trans=@{ConnectType} [Options]

Debugger -k kdsrv:server=@{tcp:server=Server,port=Socket[,password=Password][,ipversion=6]},trans=@{ConnectType} [Options]

Debugger -k kdsrv:server=@{tcp:clicon=Server,port=Socket[,password=Password][,ipversion=6]},trans=@{ConnectType} [Options]

Om du vill använda det grafiska gränssnittet för att ansluta till en KD-anslutningsserver 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 KD-anslutningsservrar.

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

Felsökningsprogram
Detta kan vara KD eller WinDbg.

Server
Det här är nätverksnamnet eller IP-adressen för den dator där KD-anslutningsservern 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 namnet som angavs för röret när KD-anslutningsservern 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 -kdsrv eller med hjälp av det grafiska WinDbg-gränssnittet.

port=Socket
Om TCP- eller SSL-protokollet används är Socket samma socketportnummer som användes när KD-anslutningsservern skapades.

clicon
Anger att KD-anslutningsservern 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 KD-anslutningsservern 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 KD-anslutningsservern skapades.

channel=COMChannel
Om COM-protokollet används ska COMChannel- matcha kanalnumret som valdes när KD-anslutningsservern skapades.

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

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

password=Password
Om ett lösenord användes när KD-anslutningsservern skapades måste Lösenord anges för att 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.

trans=@{ConnectType}
Anger hur felsökaren ska ansluta till målet. Följande kernelanslutningsprotokoll är tillåtna:

com:port=ComPort,baud=BaudRate 
usb2:targetname=String 
com:pipe,port=\\VMHost\pipe\PipeName[,resets=0][,reconnect]
com:modem 

Information om dessa protokoll finns i Getting Set Up for Debugging. Du kan utelämna någon av parametrarna för dessa protokoll , till exempel kan du säga trans=@{com:} – och felsökningsprogrammet kommer som standard att ange de värden som anges av miljövariablerna på datorn där KdSrv körs.

alternativ
Eventuella ytterligare kommandoradsparametrar kan placeras här. En fullständig lista finns i Command-Line Alternativ.

Eftersom KD-anslutningsservern 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 kernel-felsökningsprogram på en dator där KdSrv körs. Undantaget är alla alternativ som anger att en sökväg eller ett filnamn ska användas som en sökväg på datorn där den smarta klienten körs.