Een processerver activeren

De processerver die is opgenomen in Hulpprogramma's voor foutopsporing voor Windows, heet DbgSrv (dbgsrv.exe). Als u een processerver wilt activeren, opent u een opdrachtpromptvenster met verhoogde bevoegdheid (Als administrator uitvoeren) en voert u de opdracht dbgsrv in.

Opmerking U kunt een processerver activeren zonder verhoogde bevoegdheden en foutopsporingsclients kunnen verbinding maken met de server. Clients kunnen echter geen processerver detecteren, tenzij deze is geactiveerd met verhoogde bevoegdheden. Zie Zoeken naar processerversvoor informatie over het detecteren van foutopsporingsservers.

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.

DbgSrv ondersteunt verschillende transportprotocollen: named pipe (NPIPE), TCP, COM-poort, secure pipe (SPIPE) en secure sockets layer (SSL).

Aanbevolen verbindingsmethoden, met extra beveiliging

dbgsrv -t spipe:proto=Protocol,{certuser=Cert|machuser=Cert},pipe=PipeName[,hidden][,password=Password] [[-sifeo Executable] -c[s] AppCmdLine] [-x | -pc] 

dbgsrv -t ssl:proto=Protocol,{certuser=Cert|machuser=Cert},port=Socket[,hidden][,password=Password] [[-sifeo Executable] -c[s] AppCmdLine] [-x | -pc] 

dbgsrv -t ssl:proto=Protocol,{certuser=Cert|machuser=Cert},port=Socket,clicon=Client[,password=Password] [[-sifeo Executable] -c[s] AppCmdLine] [-x | -pc] 

niet-beveiligde verbindingsmethoden

dbgsrv -t tcp:port=Socket[,hidden][,password=Password][,ipversion=6][,IcfEnable] [[-sifeo Executable] -c[s] AppCmdLine] [-x | -pc] 

dbgsrv -t tcp:port=Socket,clicon=Client[,password=Password][,ipversion=6] [[-sifeo Executable] -c[s] AppCmdLine] [-x | -pc] 

dbgsrv -t npipe:pipe=PipeName[,hidden][,password=Password][,IcfEnable] [[-sifeo Executable] -c[s] AppCmdLine] [-x | -pc] 

dbgsrv -t com:port=COMPort,baud=BaudRate,channel=COMChannel[,hidden][,password=Password] [[-sifeo Executable] -c[s] AppCmdLine] [-x | -pc] 

Parameters

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

pipe=PipeName
Wanneer het NPIPE- of SPIPE-protocol wordt gebruikt, is PipeName een tekenreeks die fungeert als de naam van de pijp. Elke pijpnaam moet een unieke processerver identificeren. Als u een pijpnaam opnieuw probeert te gebruiken, wordt er een foutbericht weergegeven. PipeName- mag geen spaties of aanhalingstekens bevatten. PipeName kan een numerieke printf-style format code bevatten, zoals %x of %d. De processerver vervangt dit door de proces-id van DbgSrv. Een tweede dergelijke code wordt vervangen door de thread-id van DbgSrv.

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

poort=Socket-
Wanneer TCP- of SSL-protocol wordt gebruikt, is Socket het poortnummer van de socket.

Het is ook mogelijk om een bereik van poorten op te geven, gescheiden door een dubbele punt. DbgSrv controleert elke poort in dit bereik om te zien of deze gratis is. Als er een gratis poort wordt gevonden en er geen fout optreedt, wordt de processerver gemaakt. De slimme client moet de werkelijke poort opgeven die wordt gebruikt om verbinding te maken met de server. Als u de werkelijke poort wilt bepalen, gebruikt u een van de methoden die worden beschreven in Zoeken naar processervers; wanneer deze processerver wordt weergegeven, wordt de poort gevolgd door twee getallen gescheiden door een dubbele punt. Het eerste getal is de werkelijke poort die wordt gebruikt; de tweede kan worden genegeerd. Als de poort bijvoorbeeld is opgegeven als poort=51:60en poort 53 daadwerkelijk is gebruikt, worden in de zoekresultaten 'port=53:60' weergegeven. (Als u de clicon parameter gebruikt om een omgekeerde verbinding tot stand te brengen, kan de slimme client op deze manier een bereik van poorten opgeven, terwijl de processerver de werkelijke gebruikte poort moet opgeven.)

clicon=Client-
Wanneer TCP- of SSL-protocol wordt gebruikt en de clicon parameter is opgegeven, wordt er een omgekeerde verbinding geopend. Dit betekent dat de processerver verbinding probeert te maken met de slimme client, in plaats van de client de contactpersoon te laten initiëren. Dit kan handig zijn als u een firewall hebt die een verbinding in de gebruikelijke richting verhindert. Client de netwerknaam of het IP-adres van de computer waarop de slimme client bestaat of wordt gemaakt. De twee eerste backslashes (\) zijn optioneel.

Omdat de processerver op zoek is naar één specifieke client, kunt u niet meerdere clients verbinden met de server als u deze methode gebruikt. Als de verbinding wordt geweigerd of verbroken, moet u de processerver opnieuw opstarten. Een processerver voor omgekeerde verbinding wordt niet weergegeven wanneer iemand de -QR- opdrachtregeloptie gebruikt om alle actieve servers weer te geven.

Opmerking Wanneer clicon wordt gebruikt, kunt u de slimme client het beste starten voordat de processerver wordt gemaakt, hoewel de gebruikelijke volgorde (server vóór client) ook is toegestaan.

-poort=COMPort-
Wanneer 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
Wanneer het COM-protocol wordt gebruikt, geeft BaudRate de baudrate op waarmee de verbinding wordt uitgevoerd. Elke baudrate die wordt ondersteund door de hardware is toegestaan.

channel=COMChannel-
Als het COM-protocol wordt gebruikt, geeft COMChannel- het COM-kanaal op dat moet worden gebruikt bij de communicatie met de foutopsporingsclient. Dit kan elke waarde zijn tussen 0 en 254, inclusief. U kunt één COM-poort gebruiken voor meerdere verbindingen met behulp van verschillende kanaalnummers. (Dit verschilt van het gebruik van com-poorten voor een foutopsporingskabel. In dat geval kunt u geen kanalen binnen een COM-poort gebruiken.)

proto=Protocol
Als het SSL- of SPIPE-protocol wordt gebruikt, geeft Protocol het protocol Secure Channel (S-Channel) op. Dit kan een van de tekenreeksen tls1, pct1, ssl2 of ssl3 zijn.

certificaat
Als het SSL- of SPIPE-protocol wordt gebruikt, geeft certificaat het certificaat op. Dit kan de certificaatnaam of de vingerafdruk van het certificaat zijn (de tekenreeks van hexadecimale cijfers die worden opgegeven door de module van het certificaat). Als de syntaxis certuser=certificaat wordt gebruikt, zoekt het foutopsporingsprogramma het certificaat op in het systeemarchief (het standaardarchief). Als de syntaxis vmser=certificaat wordt gebruikt, zoekt het foutopsporingsprogramma het certificaat op in het computerarchief. Het opgegeven certificaat moet serververificatie ondersteunen.

verborgen
Hiermee voorkomt u dat de processerver wordt weergegeven wanneer iemand de -QR- opdrachtregeloptie gebruikt om alle actieve servers weer te geven.

wachtwoord=Wachtwoord
Vereist een slimme client om het opgegeven wachtwoord op te geven om verbinding te maken met de processerver. Wachtwoord kan elke alfanumerieke tekenreeks zijn, maximaal twaalf tekens lang.

Belangrijk

Het gebruik van een wachtwoord met TCP-, NPIPE- of COM-protocol biedt slechts een kleine hoeveelheid beveiliging, omdat het wachtwoord niet is versleuteld. Wanneer u een wachtwoord samen met een SSL- of SPIPE-protocol gebruikt, wordt het wachtwoord versleuteld. Als u een veiligere externe sessie wilt opzetten, moet u het SSL- of SPIPE-protocol gebruiken.

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.

IcfEnable-
Zorgt ervoor dat het foutopsporingsprogramma de benodigde poortverbindingen voor TCP- of benoemde pijpcommunicatie inschakelt wanneer de firewall voor internetverbinding actief is. De firewall voor internetverbinding schakelt standaard de poorten uit die door deze protocollen worden gebruikt. Wanneer IcfEnable wordt gebruikt met een TCP-verbinding, zorgt het foutopsporingsprogramma ervoor dat Windows de poort opent die is opgegeven door de parameter Socket. Wanneer IcfEnable wordt gebruikt met een benoemde pijpverbinding, zorgt het foutopsporingsprogramma ervoor dat Windows de poorten opent die worden gebruikt voor benoemde pijpen (poorten 139 en 445). Het foutopsporingsprogramma sluit deze poorten niet nadat de verbinding is beëindigd.

-sifeoUitvoerbare
Hiermee wordt de waarde voor het uitvoeren van het afbeeldingsbestand (IFEO) voor de opgegeven afbeelding onderbroken. Uitvoerbare moet de bestandsnaam van de uitvoerbare installatiekopieën bevatten, inclusief de bestandsnaamextensies. Met de optie -sifeo kan DbgSrv worden ingesteld als het IFEO-foutopsporingsprogramma voor een afbeelding die is gemaakt door de optie -c, zonder recursieve aanroep te veroorzaken vanwege de IFEO-instelling. Deze optie kan alleen worden gebruikt als -c wordt gebruikt.

-c
Zorgt ervoor dat DbgSrv een nieuw proces maakt. U kunt dit gebruiken om een proces te maken dat u wilt opsporen. Dit is vergelijkbaar met het maken van een nieuw proces vanuit het foutopsporingsprogramma, behalve dat dit proces niet wordt opgespoord wanneer het wordt gemaakt. Als u fouten in dit proces wilt opsporen, bepaalt u de PID en gebruikt u de optie -p bij het starten van de slimme client om fouten in dit proces op te sporen.

Zorgt ervoor dat het zojuist gemaakte proces onmiddellijk wordt onderbroken. Als u deze optie gebruikt, wordt u aangeraden CDB als uw slimme client te gebruiken en dat u de slimme client start met de -pb opdrachtregeloptie, in combinatie met -p PID-. Als u de optie -pb op de opdrachtregel opneemt, wordt het proces hervat wanneer het foutopsporingsprogramma eraan wordt gekoppeld; anders kunt u het proces hervatten met de opdracht ~*m.

AppCmdLine-
Hiermee geeft u de volledige opdrachtregel van het proces dat moet worden gemaakt. AppCmdLine- kan een Unicode- of ASCII-tekenreeks zijn en kan elk afdrukbaar teken bevatten. Alle tekst die na de parameter -c[s] wordt weergegeven, wordt gebruikt om de tekenreeks te vormen AppCmdLine-.

-x-
Zorgt ervoor dat de rest van de opdrachtregel wordt genegeerd. Deze optie is handig als u DbgSrv start vanuit een toepassing die ongewenste tekst aan de opdrachtregel kan toevoegen.

-pc-
Zorgt ervoor dat de rest van de opdrachtregel wordt genegeerd. Deze optie is handig als u DbgSrv start vanuit een toepassing die ongewenste tekst aan de opdrachtregel kan toevoegen. Er wordt een syntaxisfout weergegeven als -pc- het laatste element is op de Opdrachtregel Van DeKenrv. Afgezien van deze beperking is -pc- identiek aan -x.

U kunt een willekeurig aantal processervers op één computer starten. Dit is echter over het algemeen onnodig, omdat één processerver kan worden gebruikt door een willekeurig aantal slimme clients (elk ingeschakeld in een andere foutopsporingssessie).