Een slimme client activeren (kernelmodus)
Zodra de KD-verbindingsserver is geactiveerd, kunt u een slimme client op een andere computer maken en een foutopsporingssessie starten.
Er zijn twee manieren om een slimme client te starten: door KD of WinDbg te starten met het kernelprotocol kdsrv, of met behulp van de grafische WinDbg-interface.
U moet het protocol voor externe overdracht opgeven dat wordt gebruikt door de KD-verbindingsserver. U kunt ook het protocol opgeven voor de daadwerkelijke kernelverbinding tussen de KD-verbindingsserver en de doelcomputer, of u kunt de standaardinstelling gebruiken.
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.
De algemene syntaxis voor het starten van een slimme client is afhankelijk van het gebruikte protocol. De volgende opties zijn beschikbaar:
Aanbevolen verbindingsmethoden, met extra beveiliging
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]
niet-beveiligde verbindingsmethoden
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]
Als u de grafische interface wilt gebruiken om verbinding te maken met een KD-verbindingsserver, moet WinDbg zich in de slaapstand bevinden. Deze moet zijn gestart zonder opdrachtregelparameters of de vorige foutopsporingssessie zijn beëindigd. Selecteer het -bestand | Verbinding maken met remote Stub menuopdracht. Wanneer het dialoogvenster Verbinding maken met externe Stub-server 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]
com:port=COMPort,baud=BaudRate,channel=COMChannel[,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]
U kunt ook de knop Bladeren gebruiken om actieve KD-verbindingsservers te zoeken.
De parameters in de voorgaande opdrachten hebben de volgende mogelijke waarden:
foutopsporingsprogramma
Dit kan KD of WinDbg zijn.
Server
Dit is de netwerknaam of het IP-adres van de computer waarop de KD-verbindingsserver 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 KD-verbindingsserver 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 slimme client activeren met behulp van -k kdsrv of met behulp van de grafische WinDbg-interface.
poort=Socket-
Als TCP- of SSL-protocol wordt gebruikt, is Socket hetzelfde poortnummer dat is gebruikt toen de KD-verbindingsserver werd gemaakt.
clicon
Hiermee geeft u op dat de KD-verbindingsserver probeert verbinding te maken met de slimme client via een omgekeerde verbinding. De client moet clicon gebruiken als en alleen als de server clicongebruikt. In de meeste gevallen wordt de slimme client gestart vóór de KD-verbindingsserver 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 KD-verbindingsserver werd gemaakt.
channel=COMChannel-
Als het COM-protocol wordt gebruikt, moet COMChannel- overeenkomen met het kanaalnummer dat is gekozen toen de KD-verbindingsserver werd gemaakt.
proto=Protocol
Als het SSL- of SPIPE-protocol wordt gebruikt, moet Protocol overeenkomen met het beveiligde protocol dat wordt gebruikt toen de KD-verbindingsserver werd gemaakt.
certificaat
Als HET SSL- of SPIPE-protocol wordt gebruikt, moet u de identieke
wachtwoord=Wachtwoord
Als er een wachtwoord is gebruikt toen de KD-verbindingsserver werd gemaakt, moet Wachtwoord worden opgegeven om de slimme client te kunnen maken. Deze moet overeenkomen met het oorspronkelijke wachtwoord. Wachtwoorden zijn hoofdlettergevoelig. Als het verkeerde wachtwoord is opgegeven, geeft het foutbericht 'Fout 0x80004005' op.
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.
trans=@{ConnectType}
Geeft aan hoe het foutopsporingsprogramma verbinding maakt met het doel. De volgende kernelverbindingsprotocollen zijn toegestaan:
com:port=ComPort,baud=BaudRate
usb2:targetname=String
com:pipe,port=\\VMHost\pipe\PipeName[,resets=0][,reconnect]
com:modem
Zie Instellen voor foutopsporingvoor meer informatie over deze protocollen. U kunt een van de parameters voor deze protocollen weglaten, bijvoorbeeld trans=@{com:}. Het foutopsporingsprogramma wordt standaard ingesteld op de waarden die zijn opgegeven door de omgevingsvariabelen op de computer waarop KdSrv wordt uitgevoerd.
Opties
Eventuele extra opdrachtregelparameters kunnen hier worden geplaatst. Zie Command-Line Opties voor een volledige lijst.
Omdat de KD-verbindingsserver gewoon fungeert als een gateway voor de slimme client, zijn de extra Opties hetzelfde zijn als die u zou gebruiken als u een kernelfoutopsporingsprogramma start op de computer waarop KdSrv wordt uitgevoerd. De uitzondering hierop is een optie waarmee een pad of bestandsnaam wordt opgegeven als pad op de computer waarop de slimme client wordt uitgevoerd.