.server (создание сервера отладки)
Команда .server запускает сервер отладки, позволяя удаленному подключению к текущему сеансу отладки.
Важный
При использовании удаленной отладки необходимо учитывать важные аспекты безопасности. Дополнительные сведения о включении безопасного режима см. в статье Вопросы безопасности для средств отладки Windows.
Рекомендуемые методы подключения с некоторыми дополнительными безопасности
.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]
небезопасные методы подключения
.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]
Параметры
PipeName
Если используется протокол NPIPE или SPIPE, PipeName — это строка, которая будет служить именем канала. Каждое имя канала должно определять уникальный сервер отладки. При попытке повторного использования имени канала появится сообщение об ошибке.
PipeName не должны содержать пробелы или кавычки.
PipeName может включать числовый код printf-style format, например %x или %d. Отладчик заменит его идентификатором процесса отладчика. Второй такой код будет заменен идентификатором потока отладчика.
Сокет
Если используется протокол TCP или SSL, сокетом
Также можно указать диапазон портов, разделенных двоеточием. Отладчик проверяет каждый порт в этом диапазоне, чтобы узнать, является ли он бесплатным. Если он находит бесплатный порт и не возникает ошибок, будет создан сервер отладки. Клиент отладки должен указать фактический порт, используемый для подключения к серверу. Чтобы определить фактический порт, используйте любой из методов, описанных в поиск серверов отладки; При отображении этого сервера отладки за портом будут следовать два числа, разделенные двоеточием. Первое число будет фактическим используемым портом; Второй можно игнорировать. Например, если порт был указан как порт=51:60, а порт 53 фактически использовался, результаты поиска будут отображать "port=53:60". (Если для установки обратного подключения используется параметр clicon
clicon=клиента
Если используется протокол TCP или SSL и указан параметр clicon clicon, откроется обратное подключение. Это означает, что сервер отладки попытается подключиться к клиенту отладки, а не позволить клиенту инициировать контакт. Это может быть полезно, если у вас есть брандмауэр, который предотвращает подключение в обычном направлении.
клиент указывает сетевое имя компьютера, на котором существует клиент отладки или будет создан. Два начальных обратных косых шеи (\\) являются необязательными.
При использовании clicon лучше всего запустить клиент отладки перед созданием сервера отладки, хотя обычный порядок (сервер перед клиентом) также разрешен. Сервер обратного подключения не будет отображаться, когда другой отладчик отображает все активные серверы.
COMPort
При использовании com-протокола COMPort указывает используемый com-порт. Префикс COM является необязательным (например, "com2" и "2" допустимы).
BaudRate
Если используется протокол COM, BaudRate указывает скорость выполнения соединения. Разрешена любая скорость baud, поддерживаемая оборудованием.
COMChannel
Если используется протокол COM, COMChannel указывает com-канал, который будет использоваться при взаимодействии с клиентом отладки. Это может быть любое значение от 0 до 254 включительно.
протокола
Если используется протокол SSL или SPIPE,
сертификат
Если используется протокол SSL или SPIPE, сертификат указывает сертификат. Это может быть имя сертификата или отпечаток сертификата (строка шестнадцатеричных цифр, заданных оснастки сертификата). Если используется синтаксис certuser=сертификат Cert, отладчик будет искать сертификат в системном хранилище (хранилище по умолчанию). Если используется синтаксис machuser=сертификатов, отладчик будет искать сертификат в хранилище компьютеров. Указанный сертификат должен поддерживать проверку подлинности сервера.
скрытые
Предотвращает отображение сервера, когда другой отладчик отображает все активные серверы.
password=Password
Требуется, чтобы клиент отладки предоставлял указанный пароль для подключения к сеансу отладки.
пароль может быть любой буквенно-цифровой строкой, длиной до двенадцати символов.
ipversion=6
(Только средства отладки для Windows 6.6.07 и более ранних версий) Принудительно отладчик использовать IP-адрес версии 6, а не версию 4 при использовании TCP для подключения к Интернету. В Windows Vista и более поздних версиях отладчик пытается автоматически использовать IP-версию 6, что делает этот параметр ненужным.
IcfEnable
Вызывает отладчик включить необходимые подключения портов для tcp или именованного канала связи, если брандмауэр подключения к Интернету активен. По умолчанию брандмауэр подключения к Интернету отключает порты, используемые этими протоколами. Если IcfEnable используется с TCP-подключением, отладчик заставляет Windows открыть порт, указанный параметром Socket. Если IcfEnable используется с именованным подключением к каналу, отладчик заставляет Windows открывать порты, используемые для именованных каналов (порты 139 и 445). Отладчик не закрывает эти порты после завершения подключения.
Окружающая среда
| Пункт | Описание |
|---|---|
| Режимы | Режим пользователя, режим ядра |
| Цели | Динамический, аварийный дампа |
| Платформ | Все |
Дополнительные сведения
Полные сведения о запуске сервера отладки см. в активации сервера отладки. Примеры см. в примерахклиента и сервера.
Замечания
Эта команда преобразует текущий отладчик в сервер отладки. Это позволяет запускать сервер после запуска отладчика, в то время как -server параметр командной строки может быть выдан только при запуске отладчика.
Это позволяет клиенту отладки подключаться к текущему сеансу отладки. Обратите внимание, что можно запустить несколько серверов с помощью различных параметров, что позволяет различным типам отладчика клиентов присоединяться к сеансу.
Важный
Использование пароля с протоколом TCP, NPIPE или COM обеспечивает только небольшое количество защиты, так как пароль не шифруется. При использовании пароля вместе с протоколом SSL или SPIPE пароль шифруется. Если вы хотите установить безопасный удаленный сеанс, необходимо использовать протокол SSL или SPIPE.