Exemplos de ferramentas remotas

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

Comando 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 a sessão test1.

remote /s cmd test1

Em resposta, a ferramenta Remote 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 de cliente básico

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 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 servidor. A mensagem exibe o nome do computador 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 digitados no prompt de comando nos computadores cliente e servidor aparecem em ambos os monitores.

Por exemplo, se você digitar dir no prompt de comando do computador cliente, a exibição do diretório aparecerá na janela do prompt de comando nos computadores cliente e servidor.

Usando opções do servidor

O seguinte comando do lado do servidor 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 do console que inicia o depurador, juntamente com as opções do depurador. Como o comando console inclui espaços, ele é colocado 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 em Domain01, se conectem à sessão. Ele usa as opções /f e /b para especificar texto preto (primeiro plano) em um fundo branco.

Finalmente, o comando usa o parâmetro /-v para tornar a sessão invisível para as consultas do 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 apenas 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 as Opções do Cliente

O comando seguinte conecta-se à sessão remota com o depurador NTSD que foi iniciada no exemplo anterior.

O comando usa o parâmetro /c para indicar um comando do lado do cliente. Ele especifica o nome do computador 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 Remote a exibir linhas de saída com a palavra "registro" (não diferencia maiúsculas de minúsculas) em texto branco em um fundo azul e a exibir linhas de saída com a palavra "token" em texto vermelho em um fundo branco.

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

**************************************
***********     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 servidor. A saída do comando aparece nos computadores cliente e servidor.

Linhas de saída com a palavra "registro" são exibidas no computador cliente em texto branco sobre fundo azul, e linhas de saída com a palavra "kernel" em texto vermelho sobre 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 sem depurador iniciadas com o parâmetro /v ).

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

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

remote /q Server04

Em resposta, a ferramenta Remote 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, 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 a janela do prompt de comando) e o comando que se conecta à sessão. O nome da sessão aparece na sintaxe do 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 participar.

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 para 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 hora da mensagem.

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

Quando a mensagem é enviada do computador 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 servidor. Em todos os computadores clientes da sessão, ele grava uma mensagem na janela do 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 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 servidor que iniciou a sessão remota pode terminá-la.

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

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

*** SESSION OVER ***

Em todos os outros computadores da sessão, a ferramenta Remoto publica uma mensagem com o nome do computador e do utilizador que se desligou, bem como o dia e a hora da desligação.

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

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