.server (Criar servidor de depuração)
O comando .server inicia um servidor de depuração, permitindo uma conexão remota com a sessão de depuração atual.
Importante
Há considerações de segurança importantes ao usar a depuração remota. Para obter mais informações, incluindo informações sobre como habilitar o modo seguro, consulte Considerações de segurança para ferramentas de depuração do Windows.
métodos de conexão recomendados, com alguns de segurança adicionais
.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]
métodos de conexão não seguros
.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]
Parâmetros
PipeName
Quando o protocolo NPIPE ou SPIPE é usado, PipeName é uma cadeia de caracteres que servirá como o nome do pipe. Cada nome de pipe deve identificar um servidor de depuração exclusivo. Se você tentar reutilizar um nome de pipe, receberá uma mensagem de erro.
pipeName não deve conter espaços ou aspas.
de soquete
Quando o protocolo TCP ou SSL é usado, soquete é o número da porta do soquete.
Também é possível especificar um intervalo de portas separadas por dois-pontos. O depurador verificará cada porta nesse intervalo para ver se ela é gratuita. Se encontrar uma porta gratuita e nenhum erro ocorrer, o servidor de depuração será criado. O cliente de depuração precisará especificar a porta real que está sendo usada para se conectar ao servidor. Para determinar a porta real, use qualquer um dos métodos descritos em Pesquisar servidores de depuração; quando esse servidor de depuração for exibido, a porta será seguida por dois números separados por dois-pontos. O primeiro número será a porta real usada; o segundo pode ser ignorado. Por exemplo, se a porta foi especificada como porta=51:60 e a porta 53 foi realmente usada, os resultados da pesquisa mostrarão "port=53:60". (Se você estiver usando o parâmetro clicon para estabelecer uma conexão inversa, o cliente de depuração poderá especificar um intervalo de portas dessa maneira, enquanto o servidor deverá especificar a porta real usada.)
clicon=client
Quando o protocolo TCP ou SSL é usado e o parâmetro clicon é especificado, uma conexão inversa será aberta. Isso significa que o servidor de depuração tentará se conectar ao cliente de depuração, em vez de permitir que o cliente inicie o contato. Isso pode ser útil se você tiver um firewall que esteja impedindo uma conexão na direção usual.
Cliente especifica o nome de rede do computador no qual o cliente de depuração existe ou será criado. As duas barras iniciais (\\) são opcionais.
Quando clicon é usado, é melhor iniciar o cliente de depuração antes que o servidor de depuração seja criado, embora a ordem usual (servidor antes do cliente) também seja permitida. Um servidor de conexão reversa não será exibido quando outro depurador exibir todos os servidores ativos.
COMPort
Quando o protocolo COM é usado, COMPort especifica a porta COM a ser usada. O prefixo COM é opcional (por exemplo, "com2" e "2" são aceitáveis).
Quando o protocolo COM é usado, BaudRate especifica a taxa de baud na qual a conexão será executada. Qualquer taxa de baud compatível com o hardware é permitida.
COMChannel
Se o protocolo COM for usado, comChannel especificar o canal COM a ser usado na comunicação com o cliente de depuração. Isso pode ser qualquer valor entre 0 e 254, inclusive.
de Protocolo
Se o protocolo SSL ou SPIPE for usado, Protocol especificar o protocolo S-Channel (Canal Seguro). Isso pode ser qualquer uma das cadeias de caracteres tls1, pct1, ssl2 ou ssl3.
Cert
Se o protocolo SSL ou SPIPE for usado, Cert especificar o certificado. Isso pode ser o nome do certificado ou a impressão digital do certificado (a cadeia de caracteres de dígitos hexadecimal fornecidos pelo snapin do certificado). Se a sintaxe certuser=Cert for usada, o depurador procurará o certificado no repositório do sistema (o repositório padrão). Se a sintaxe machuser=Cert for usada, o depurador procurará o certificado no repositório de máquinas. O certificado especificado deve dar suporte à autenticação do servidor.
oculto
Impede que o servidor apareça quando outro depurador exibe todos os servidores ativos.
password=Password
Requer que um cliente de depuração forneça a senha especificada para se conectar à sessão de depuração.
de senha pode ser qualquer cadeia de caracteres alfanumérica, com até doze caracteres de comprimento.
ipversion=6
(Ferramentas de depuração para Windows 6.6.07 e somente anteriores) Força o depurador a usar o IP versão 6 em vez da versão 4 ao usar o TCP para se conectar à Internet. No Windows Vista e versões posteriores, o depurador tenta fazer o padrão automático para o IP versão 6, tornando essa opção desnecessária.
IcfEnable
Faz com que o depurador habilite as conexões de porta necessárias para a comunicação de pipe TCP ou nomeada quando o Firewall de Conexão da Internet estiver ativo. Por padrão, o Firewall de Conexão com a Internet desabilita as portas usadas por esses protocolos. Quando IcfEnable é usado com uma conexão TCP, o depurador faz com que o Windows abra a porta especificada pelo parâmetro Socket. Quando IcfEnable é usado com uma conexão de pipe nomeada, o depurador faz com que o Windows abra as portas usadas para pipes nomeados (portas 139 e 445). O depurador não fecha essas portas após o término da conexão.
Ambiente
| Item | Descrição |
|---|---|
| Modos | Modo de usuário, modo kernel |
| Alvos | Ao vivo, despejo de memória |
| Plataformas | Todo |
Informações adicionais
Para obter detalhes completos sobre como iniciar um servidor de depuração, consulte Ativando um servidor de depuração. Para obter exemplos, consulte exemplos de cliente e servidor.
Observações
Esse comando transforma o depurador atual em um servidor de depuração. Isso permite que você inicie o servidor depois que o depurador já estiver em execução, enquanto a opção de linha de comando -server só poderá ser emitida quando o depurador for iniciado.
Isso permite que um cliente de depuração se conecte à sessão de depuração atual. Observe que é possível iniciar vários servidores usando diferentes opções, permitindo que diferentes tipos de clientes de depuração ingressem na sessão.
Importante
Usar uma senha com protocolo TCP, NPIPE ou COM oferece apenas uma pequena quantidade de proteção, pois a senha não está criptografada. Quando você usa uma senha junto com um protocolo SSL ou SPIPE, a senha é criptografada. Se você quiser estabelecer uma sessão remota segura, deverá usar o protocolo SSL ou SPIPE.