Exemplos de ferramentas remotas

Os exemplos nesta seção demonstram o uso da ferramenta Remote e mostram entrada e saída de exemplo.

Comando do Servidor Básico

O comando a seguir inicia uma sessão remota no computador.

O comando usa o parâmetro /s para indicar um comando do lado do servidor. Ele usa o comando, cmd, para iniciar o shell de comando do Windows (Cmd.exe) e nomeia o teste de sessão1.

remote /s cmd test1

Em resposta, a ferramenta Remota inicia a sessão e exibe o comando que os clientes usariam para se conectar à sessão.

**************************************
***********     REMOTE    ************
***********     SERVER    ************
**************************************
To Connect: Remote /C SERVER06 "test1"

Microsoft Windows XP [Version 5.1.2600]
(C) Copyright 1985-2001 Microsoft Corp.

Comando básico do cliente

O comando a seguir se conecta a uma sessão remota no computador Server01. O comando usa o parâmetro /c para indicar um comando do lado do cliente. Ele especifica o nome do computador do servidor, Server01, e o nome da sessão nesse computador, test1.

remote /c server01 test1

Em resposta, a ferramenta Remote exibe uma mensagem informando que o computador cliente está conectado à sessão no computador do servidor. A mensagem exibe o nome do computador do servidor e do usuário local (Server04 user1).

**************************************
***********     REMOTE    ************
***********     CLIENT    ************
**************************************
Connected...

Microsoft Windows XP [Version 5.1.2600]
(C) Copyright 1985-2001 Microsoft Corp.

C:\Program Files\Debugging Tools for Windows>
**Remote: Connected to SERVER04 user1 [Tue 9:39 AM]

Depois que o cliente se conecta ao servidor, os comandos digitado no prompt de comando nos computadores cliente e servidor aparecem em ambas as exibições.

Por exemplo, se você digitar dir no Prompt de Comando do computador cliente, o diretório aparecerá na janela Prompt de Comando em ambos os computadores, cliente e servidor.

Usando opções de servidor

O comando do servidor a seguir inicia uma sessão remota com o depurador NTSD.

O comando usa o parâmetro /s para indicar um comando do lado do servidor. O próximo parâmetro, "ntsd -d -v", é o comando de console que inicia o depurador, juntamente com as opções do depurador. Como o comando do console inclui espaços, ele está entre aspas. O comando inclui um nome para a sessão, debugit.

O comando usa o parâmetro /u para permitir que apenas administradores do computador e um usuário específico, User03 no Domain01, se conectem à sessão. Ele usa as opções /f e /b para especificar texto preto (primeiro plano) em uma tela de fundo branca.

Por fim, o comando usa o parâmetro /-v para tornar a sessão invisível para consultas de usuário. As sessões do depurador são visíveis por padrão.

remote /s "ntsd -d -v" DebugIt /u Administrators /u Domain01\User03 
/f black /b white /-v

Em resposta, a ferramenta Remote cria uma sessão chamada DebugIt e inicia o NTSD com os parâmetros especificados. A mensagem indica que somente os usuários especificados têm permissão para se conectar. Ele também altera a janela de comando para as cores especificadas.

**************************************
***********     REMOTE    ************
***********     SERVER    ************
**************************************

Protected Server!  Only the following users or groups can connect:
    Administrators
    Domain01\User03
To Connect: Remote /C SERVER06 "debugit"

Microsoft Windows XP [Version 5.1.2600]
(C) Copyright 1985-2001 Microsoft Corp.

Usando opções de cliente

O comando a seguir conecta-se à sessão remota com o depurador NTSD iniciado no exemplo anterior.

O comando usa o parâmetro /c para indicar um comando do lado do cliente. Ele especifica o nome do computador do servidor, server06, e o nome da sessão remota, debugit.

O comando também inclui o parâmetro /k para especificar o local de um arquivo de cor de palavra-chave.

remote /c server06 debugit /k c:\remote_client.txt

O arquivo de cores inclui o seguinte texto:

Registry
white, blue
Token
red, white

Este texto instrui a ferramenta Remota a exibir linhas de saída com a palavra "registro" (não diferencia maiúsculas de minúsculas) em texto branco sobre um plano de fundo azul e a exibir linhas de saída com a palavra "token" em texto vermelho sobre um plano de fundo branco.

Em resposta, a ferramenta Remota conecta o cliente à sessão do servidor e exibe a mensagem a seguir.

**************************************
***********     REMOTE    ************
***********     CLIENT    ************
**************************************
Connected...

Microsoft Windows XP [Version 5.1.2600]
(C) Copyright 1985-2001 Microsoft Corp.

O cliente agora pode enviar comandos para o depurador NTSD no computador do servidor. A saída do comando é exibida nos computadores cliente e servidor.

Linhas de saída com a palavra "registro de sistema" são exibidas no computador cliente em texto branco sobre um fundo azul, enquanto linhas de saída com a palavra "kernel" aparecem em texto vermelho sobre um fundo branco.

Consultando uma sessão

A ferramenta Remote inclui um parâmetro de consulta (/q) que exibe uma lista de sessões remotas em um computador específico. A exibição inclui apenas sessões visíveis (sessões de depurador iniciadas sem o parâmetro /-v e sessões não depurador iniciadas com o parâmetro /v ).

Você pode consultar sessões do servidor ou dos computadores cliente. Você deve especificar o nome do computador, mesmo ao consultar sessões no computador local.

O comando a seguir consulta as sessões no computador local, Server04.

remote /q Server04

Em resposta, a ferramenta Remota informa que não há sessões remotas em execução no computador local.

Querying server \\Server04
No Remote servers running on \\Server04

Por outro lado, em resposta a uma consulta sobre sessões em um computador diferente, o Server06, a ferramenta Remote lista as sessões em execução nesse computador.

Querying server \\Server06

Visible sessions on server Server06:

ntsd                            [Remote /C SERVER06 "debug"] visible
cmd                             [Remote /C SERVER06 "test"] visible

A exibição lista as sessões visíveis, os programas de console em execução nessas sessões (NTSD e na janela prompt de comando) e o comando que se conecta à sessão. O nome da sessão aparece na sintaxe de comando entre aspas.

A exibição não mostra as permissões estabelecidas para essas sessões, se houver. Portanto, a exibição pode incluir sessões que você não tem permissão para ingressar.

Usando os comandos de sessão

Você pode usar os comandos de sessão remota a qualquer momento durante uma sessão remota.

O comando a seguir envia uma mensagem a todos os computadores conectados à sessão.

@M I think I found the problem.

Como resultado, a mensagem aparece nas janelas do Prompt de Comando de todos os computadores na sessão. A mensagem inclui o nome do computador e o dia e a hora da mensagem.

@m I think I found the problem.     [SERVER01       Wed 11:53 AM]

Quando a mensagem é enviada do computador do servidor, "Local" aparece no rótulo em vez do nome do computador.

@m I think I found the problem.     [Local       Wed 11:52 AM]

O comando a seguir gera uma mensagem pop-up que aparece no computador do servidor. Em todos os computadores cliente na sessão, ele grava uma mensagem na janela prompt de comando.

@P Did you see that?

Em computadores cliente, a mensagem pop-up aparece na janela de comando.

From SERVER02  [Wed 11:58 AM]

 Did you see that?

A hora que aparece no rótulo da mensagem é sempre a hora no computador do servidor, mesmo que o computador cliente que enviou a mensagem esteja em um fuso horário diferente.

Encerrando uma sessão remota

Os exemplos a seguir demonstram como usar os comandos de sessão remota para desconectar um computador cliente de uma sessão e encerrar uma sessão remota. Somente o computador do servidor que iniciou a sessão remota pode encerrá-lo.

Para desconectar um computador cliente de uma sessão remota, no computador cliente, digite @q.

Em resposta, a mensagem a seguir aparece no computador cliente que se desconectou.

*** SESSION OVER ***

Em todos os outros computadores da sessão, a ferramenta Remota posta uma mensagem com o nome do computador e do usuário que se desconectou e o dia e a hora da desconexão.

**Remote:  Disconnected from SERVER04 User01  [Wed 12:01 PM]

Para encerrar uma sessão remota, no computador do servidor, digite @k. Esse comando desconecta automaticamente os clientes e, em seguida, encerra a sessão.