.server (vytvoření serveru ladění)

Příkaz .server spustí ladicí server, který umožňuje vzdálené připojení k aktuální ladicí relaci.

Důležitý

Při použití vzdáleného ladění existují důležité aspekty zabezpečení. Další informace, včetně informací o povolení zabezpečeného režimu, naleznete v tématu aspekty zabezpečení pro nástroje ladění systému Windows.

doporučené metody připojení s některými dalšími bezpečnostními

.server spipe:proto=Protocol,{certuser=Cert|machuser=Cert},pipe=PipeName[,hidden][,password=Password] 
.server ssl:proto=Protocol,{certuser=Cert|machuser=Cert},port=Socket[,hidden][,password=Password] 
.server ssl:proto=Protocol,{certuser=Cert|machuser=Cert},port=Socket,clicon=Client[,password=Password] 

nezabezpečené metody připojení

.server npipe:pipe=PipeName[,hidden][,password=Password][,IcfEnable] 
.server tcp:port=Socket[,hidden][,password=Password][,ipversion=6][,IcfEnable] 
.server tcp:port=Socket,clicon=Client[,password=Password][,ipversion=6] 
.server com:port=COMPort,baud=BaudRate,channel=COMChannel[,hidden][,password=Password] 

Parametry

PipeName
Při použití protokolu NPIPE nebo SPIPE je PipeName řetězec, který bude sloužit jako název kanálu. Každý název kanálu by měl identifikovat jedinečný ladicí server. Pokud se pokusíte znovu použít název kanálu, zobrazí se chybová zpráva. Pipe Name nesmí obsahovat mezery ani uvozovky. PipeName může obsahovat číselný formátovací kód formátu, například %x nebo %d. Ladicí program ho nahradí ID procesu ladicího programu. Druhý takový kód bude nahrazen ID vlákna ladicího programu.

soketů
Při použití protokolu TCP nebo SSL socket je číslo portu soketu.

Je také možné zadat rozsah portů oddělených dvojtečkam. Ladicí program zkontroluje každý port v tomto rozsahu a zjistí, jestli je bezplatný. Pokud najde bezplatný port a nedojde k žádné chybě, vytvoří se ladicí server. Klient ladění bude muset zadat skutečný port, který se používá pro připojení k serveru. Chcete-li zjistit skutečný port, použijte některou z metod popsaných v Vyhledávání ladicí servery; když se zobrazí tento ladicí server, port bude následovat za dvěma čísly oddělenými dvojtečku. První číslo bude skutečným použitým portem; druhý lze ignorovat. Pokud byl například port zadán jako port=51:60 a ve skutečnosti se použil port 53, zobrazí se ve výsledcích hledání "port=53:60". (Pokud k navázání zpětného připojení používáte parametr clicon, může klient ladění tímto způsobem určit rozsah portů, zatímco server musí zadat skutečný použitý port.)

clicon=client
Pokud se použije protokol TCP nebo SSL a zadá se parametr clicon , otevře se zpětné připojení. To znamená, že se ladicí server pokusí připojit k ladicímu klientovi místo toho, aby klient zahájil kontakt. To může být užitečné, pokud máte bránu firewall, která brání připojení obvyklým směrem. Klient určuje název sítě počítače, na kterém existuje klient ladění, nebo se vytvoří. Dvě počáteční zpětná lomítka (\\) jsou volitelná.

Při použití clicon je nejlepší spustit klienta ladění před vytvořením ladicího serveru, i když je povoleno obvyklé pořadí (server před klientem). Server zpětného připojení se nezobrazí, když jiný ladicí program zobrazí všechny aktivní servery.

COMPort
Při použití protokolu COM COMPort určuje port COM, který se má použít. Předpona COM je volitelná (například "com2" a "2" jsou přijatelné).

BaudRate
Při použití protokolu COM BaudRate určuje přenosovou rychlost, s jakou se připojení spustí. Veškerá přenosová rychlost podporovaná hardwarem je povolená.

COMChannel
Pokud se používá protokol COM, COMChannel určuje kanál COM, který se má použít při komunikaci s klientem ladění. Může se jednat o libovolnou hodnotu od 0 do 254 (včetně).

protokolu
Pokud se používá protokol SSL nebo SPIPE, Protocol určuje protokol S-Channel (Secure Channel). Může to být libovolný řetězec tls1, pct1, ssl2 nebo ssl3.

certifikátu
Pokud se používá protokol SSL nebo SPIPE, certifikát určuje certifikát. Může to být buď název certifikátu, nebo kryptografický otisk certifikátu (řetězec šestnáctkových číslic zadaných přichycením certifikátu). Pokud se použije syntaxe certuser=Cert, ladicí program vyhledá certifikát v systémovém úložišti (výchozí úložiště). Pokud se použije syntaxe machuser=Cert, ladicí program vyhledá certifikát v úložišti počítačů. Zadaný certifikát musí podporovat ověřování serveru.

skrytých
Zabrání zobrazení serveru, když jiný ladicí program zobrazí všechny aktivní servery.

password=Password
Vyžaduje, aby klient ladění zadal zadané heslo, aby se mohl připojit k ladicí relaci. heslo může být libovolný alfanumerický řetězec, o délce až dvanáct znaků.

ipversion=6
(Nástroje ladění pouze pro Windows 6.6.07 a starší) Vynutí ladicí program, aby při připojení k internetu používal IP verzi 6 místo verze 4. V systému Windows Vista a novějších verzích se ladicí program pokusí automaticky nastavit výchozí IP verzi 6, takže tato možnost není nutná.

IcfEnable
Způsobí, že ladicí program povolí potřebná připojení portu pro komunikaci tcp nebo pojmenovaného kanálu, když je aktivní brána firewall připojení k internetu. Brána firewall připojení k internetu ve výchozím nastavení zakáže porty používané těmito protokoly. Pokud IcfEnable se používá s připojením TCP, ladicí program způsobí, že systém Windows otevře port určený parametrem Socket. Pokud IcfEnable se používá s pojmenovaným připojením kanálu, ladicí program způsobí, že systém Windows otevře porty používané pro pojmenované kanály (porty 139 a 445). Ladicí program tyto porty po ukončení připojení nezavře.

Životní prostředí

Položka	Popis
Režimy	Uživatelský režim, režim jádra
Cíle	Živé, výpis stavu systému
Platformy	Všichni

Další informace

Úplné podrobnosti o tom, jak spustit ladicí server, naleznete v tématu Aktivace ladění serveru. Příklady najdete v tématu Příklady klienta a serveru.

Poznámky

Tento příkaz změní aktuální ladicí program na ladicí server. To umožňuje spustit server po spuštění ladicího programu, zatímco -server možnost příkazového řádku může být vydána pouze při spuštění ladicího programu.

To umožňuje, aby se klient ladění připojil k aktuální ladicí relaci. Všimněte si, že je možné spustit více serverů pomocí různých možností, což umožňuje různým druhům ladění klientů připojit se k relaci.

Důležitý

Použití hesla s protokolem TCP, NPIPE nebo COM nabízí pouze malou ochranu, protože heslo není šifrované. Když použijete heslo společně s protokolem SSL nebo SPIPE, heslo se zašifruje. Pokud chcete vytvořit zabezpečenou vzdálenou relaci, musíte použít protokol SSL nebo SPIPE.