Visão geral sobre os comandos Netsh

Visão geral sobre os comandos Netsh


Usando o NetshNetsh é um utilitário para elaborar scripts de linha de comando que permite, local e remotamente, exibir ou modificar a configuração de rede de um computador em execução no momento. Fornece também um recurso de script que permite executar um grupo de comandos no modo de lotes em um computador especificado. O Netsh também pode salvar um script de configuração em um arquivo de texto para fins de arquivamento ou para ajudá-lo a configurar outros servidores.

Contextos do Netsh
O Netsh interage com outros componentes do sistema operacional usando arquivos de biblioteca de vínculo dinâmico (DLL). Cada DLL auxiliar do Netsh fornece um conjunto de recursos chamado contexto, que é um grupo de comandos específicos a um componente de rede. Esses contextos estendem a funcionalidade do netsh fornecendo suporte de configuração e monitoramento a um ou mais serviços, utilitários ou protocolos. Por exemplo, Dhcpmon.dll fornece ao netsh o contexto e o conjunto de comandos necessários para configurar e gerenciar servidores DHCP.

Para executar um comando netsh, você deve iniciar o netsh no prompt do Cmd.exe e alterar o contexto que contém o comando desejado. Os contextos disponíveis dependem dos componentes de rede instalados. Por exemplo, se você digitar dhcp no prompt do comando Netsh, o contexto DHCP será alterado, mas, se você não tiver o DHCP instalado, será exibida a seguinte mensagem:

O seguinte comando não foi encontrado: dhcp.

Para obter mais informações sobre os contextos Netsh, consulte os seguintes tópicos:

Comandos Netsh para AAAA
Comandos Netsh para DHCP
Comandos Netsh para diagnóstico (diag)
Comandos Netsh para interface IP
Comandos Netsh para RAS
Comandos Netsh para roteamento
Comandos Netsh para WINS
Usando vários contextos
Um contexto pode existir dentro de outro contexto. Por exemplo, dentro do contexto Routing, é possível mudar para os subcontextos IP e IPX.

Para exibir uma lista de comandos e subcontextos que podem ser usados em um contexto, no prompt do netsh, digite o nome do contexto e, em seguida, digite ? ou help. Por exemplo, para exibir uma lista de subcontextos e comandos que podem ser usados no contexto routing, no prompt do netsh (isto é, netsh>), digite o seguinte:

routing /?

routing help

Para realizar tarefas em outro contexto sem sair do atual, digite o caminho do contexto do comando desejado no prompt do netsh. Por exemplo, para adicionar a interface Conexão de rede local ao contexto IGMP sem mudar para o contexto IGMP, no prompt do netsh, digite:

routing ip igmp add interface "Conexão de rede local" startupqueryinterval=21

Executando comandos Netsh no prompt do comando Cmd.exe
Quando o netsh é executado no prompt do comando Cmd.exe, netsh usa a seguinte sintaxe. Para executar esses comandos netsh em um Windows 2000 Server remoto, primeiro você deve usar Conexão de área de trabalho remota para se conectar a um Windows 2000 Server que esteja executando o Terminal Server. Pode haver diferenças funcionais entre os comandos de contexto netsh no Windows 2000 e no Windows XP.

Para exibir a sintaxe do comando, clique no comando a seguir:

netsh

O netsh é um utilitário para elaborar scripts de linha de comando que permite, local e remotamente, exibir ou modificar a configuração de rede de um computador em execução no momento. Usado sem parâmetros, netsh abre o prompt de comando Netsh.exe (isto é, netsh>).

Sintaxe
netsh [-a arquivo_de_alias] [-c contexto] [-r computador_remoto] [{comando_Netsh|-f arquivo_de_script}]

Parâmetros
-a
Retorna ao prompt do netsh depois de executar arquivo_de_alias.
arquivo_de_alias
Especifica o nome do arquivo de texto contendo um ou mais comandos netsh.
-c
Altera o contexto netsh especificado.
contexto
Especifica o contexto netsh. A tabela a seguir lista os contextos netsh disponíveis. Contexto Descrição
AAAA Mostra e define a configuração do banco de dados de autenticação, autorização, contas e auditoria (AAAA) usado pelo serviço de autenticação Internet (IAS) e pelo serviço de roteamento e acesso remoto.
DHCP Administra servidores DHCP e fornece uma alternativa equivalente para gerenciamento no console.
Diag Administra e soluciona problemas nos parâmetros do sistema de rede e do sistema operacional.
Interface Configura o protocolo TCP/IP (incluindo endereços, gateways padrão, servidores DNS e servidores WINS) e exibe informações de configuração e estatísticas.
RAS Administra servidores de acesso remoto.
Routing Administra servidores de roteamento.
WINS Administra servidores WINS

-r
Configura um computador remoto.
computador_remoto
Especifica o computador remoto a ser configurado.
comando_Netsh
Especifica o comando netsh que você deseja executar.
-f
Sai do Netsh.exe após executar o script.
arquivo_de_script
Especifica o script que deseja executar.
/?
Exibe ajuda no prompt de comando.
Comentários
Usando -r
Se você especificar -r seguido de outro comando, netsh executará o comando no computador remoto, depois retornará ao prompt do comando Cmd.exe. Se você especificar -r sem outro comando, netsh abrirá no modo remoto. O processo é semelhante a usar set machine no prompt do comando netsh. Ao usar -r, você define o computador de destino apenas para a instância atual do netsh. Após sair e retornar ao netsh, o computador de destino será redefinido como o computador local. Os comandos netsh podem ser executados em um computador remoto especificando-se um nome de computador armazenado no WINS, um nome UNC, um nome de Internet a ser resolvido pelo servidor DNS ou um endereço IP numérico.

Executado comandos Netsh no prompt do comando Netsh.exe
O netsh usa os seguintes comandos padrão em todos os contextos que podem ser executados de um prompt do comando Netsh.exe (isto é, netsh>). Para executar esses comandos netsh em um Windows 2000 Server remoto, primeiro você deve usar Conexão de área de trabalho remota para se conectar a um Windows 2000 Server que esteja executando o Terminal Server. Pode haver diferenças funcionais entre os comandos de contexto netsh no Windows 2000 e no Windows XP.

Para exibir a sintaxe do comando, clique em um comando:

..

Move para o contexto que está um nível acima.

Sintaxe
..

Parâmetros
/?
Exibe ajuda no prompt de comando.
abort

Descarta qualquer alteração feita no modo off-line. Abort não tem efeito no modo on-line.

Sintaxe
abort

Parâmetros
/?
Exibe ajuda no prompt de comando.
add helper

Instala a DLL auxiliar no netsh.

Sintaxe
add helper nome_da_DLL

Parâmetros
nome_da_DLL
Obrigatório. Especifica o nome da DLL auxiliar que você deseja instalar.
/?
Exibe ajuda no prompt de comando.
alias

Adiciona um alias que consiste em uma seqüência de caracteres definida pelo usuário, que o netsh trata como equivalente a outra seqüência de caracteres. Quando usado sem parâmetros, alias exibe todos os aliases disponíveis.

Sintaxe
alias [nome_do_alias] [seqüência1 [seqüência2 ...]]

Parâmetros
alias [nome_do_alias]
Exibe o alias especificado.
alias [nome_do_alias][seqüência1[seqüência2 ...]]
Define nome_do_alias para as seqüências de caracteres especificadas.
/?
Exibe ajuda no prompt de comando.
Exemplos
O script de exemplo netsh a seguir define dois aliases netsh, Shaddr e Shp; depois, deixa o prompt do comando netsh no contexto Interface IP:

alias shaddr show interface ip addr
alias shp show helpers
interface ip

Se você digitar shaddr no prompt do comando netsh, o Netsh.exe interpretará isso como o comando show interface ip addr. Se você digitar shp no prompt do comando netsh, o Netsh.exe interpretará isso como o comando show helpers.

bye

Sai do Netsh.exe.

Sintaxe
bye

Parâmetros
/?
Exibe ajuda no prompt de comando.
commit

Confirma quaisquer alterações feitas no modo off-line para o roteador. Commit não tem efeito no modo on-line.

Sintaxe
commit

Parâmetros
/?
Exibe ajuda no prompt de comando.
delete helper

Remove a DLL auxiliar do netsh.

Sintaxe
delete helper nome_da_DLL

Parâmetros
nome_da_DLL
Obrigatório. Especifica o nome da DLL auxiliar que você deseja desinstalar.
/?
Exibe ajuda no prompt de comando.
dump

Cria uma script contendo a configuração atual. Se você salvar esse script em um arquivo, poderá usar o arquivo para restaurar as configurações que tiverem sido alteradas. Quando usado sem parâmetros, dump exibe todas as configurações de contexto netsh.

Sintaxe
dump [nome_do_arquivo]

Parâmetros
[nome_do_arquivo]
Especifica o nome do arquivo para o qual você deseja redirecionar a saída.
/?
Exibe ajuda no prompt de comando.
exec

Carrega um arquivo de script e executa comandos a partir dele.

Sintaxe
exec arquivo_de_script

Parâmetros
arquivo_de_script
Obrigatório. Especifica o nome do script que você deseja carregar e executar.
Comentários
O arquivo_de_script pode ser executado em um ou mais computadores.
exit

Sai do Netsh.exe.

Sintaxe
exit

Parâmetros
/?
Exibe ajuda no prompt de comando.
help

Exibe ajuda.

Sintaxe
{/?|?|help|h}

Parâmetros
nenhum
offline

Define o modo atual como off-line.

Sintaxe
offline

Parâmetros
/?
Exibe ajuda no prompt de comando.
Comentários
As alterações feitas nesse modo são salvas, mas é necessário executar o comando commit ou online para definir as alterações no roteador.
Quando você alterna do modo off-line para on-line, as alterações feitas no modo off-line são exibidas na configuração atualmente em execução.
As alterações feitas no modo on-line são exibidas imediatamente na configuração atualmente em execução.
online

Define o modo atual como on-line.

Sintaxe
online

Parâmetros
/?
Exibe ajuda no prompt de comando.
Comentários
As alterações feitas no modo on-line são exibidas imediatamente na configuração atualmente em execução.
Quando você alterna do modo off-line para on-line, as alterações feitas no modo off-line são exibidas na configuração atualmente em execução.
popd

Restaura um contexto da pilha.

Sintaxe
popd

Parâmetros
/?
Exibe ajuda no prompt de comando.
Comentários
Usado juntamente com pushd, popd permite alterar o contexto, executar o comando no novo contexto e retornar ao contexto anterior.
Exemplos
O script de exemplo a seguir altera um contexto do contexto raiz para o contexto interface ip, adiciona um roteamento IP estático e retorna ao contexto raiz:

netsh>pushd
netsh>interface ip
netsh interface ip>set address local static 10.0.0.9 255.0.0.0 10.0.0.1 1
netsh interface ip>popd netsh>

pushd

Salva o contexto atual em uma pilha primeiro-na-última-saída (FILO).

Sintaxe
pushd

Parâmetros
/?
Exibe ajuda no prompt de comando.
Comentários
Quando usado juntamente com popd, pushd permite alterar o contexto, executar o comando no novo contexto e retornar ao contexto anterior.
quit

Sai do Netsh.exe.

Sintaxe
quit

Parâmetros
/?
Exibe ajuda no prompt de comando.
set file

Copia a saída da janela Prompt de comando para um arquivo.

Sintaxe
set file {open nome_do_arquivo|append nome_do_arquivo|close}

Parâmetros
open nome_do_arquivo
Envia a saída da janela Prompt de comando para o arquivo especificado.
append nome_do_arquivo
Anexa a saída da janela Prompt de comando ao arquivo existente especificado.
close
Pára o envio de saída e fecha um arquivo.
/?
Exibe ajuda no prompt de comando.
Comentários
Usando nome_do_arquivo
Se o nome_do_arquivo especificado não existir no momento, netsh criará um novo arquivo com esse nome. Se o nome_do_arquivo especificado existir no momento, netsh substituirá os dados existentes.

Exemplos
Para criar um novo arquivo de log chamado Sessão.log e copiar nele todas as entradas e saídas subseqüentes do netsh, digite:

set file open c:\sessão.log

set machine

Define o computador atual para realizar tarefas de configuração. Quando usado sem parâmetros, set machine define o computador local.

Sintaxe
set machine [[nome_do_computador=]seqüência]

Parâmetros
nome_do_computador
Especifica o nome do computador em serão realizadas tarefas de configuração.
seqüência
Especifica a localização do computador remoto.
/?
Exibe ajuda no prompt de comando.
Comentários
Realizando tarefas de configuração em vários computadores
É possível executar comandos em vários computadores a partir de um único script. Você pode usar set machine em um script para especificar o computador de destino (por exemplo, ComputadorA) e executar os comandos seguintes a set machine nesse computador (isto é, ComputadorA). Você pode, então, usar set machine para especificar outro computador de destino (por exemplo, ComputadorB) e executar comandos nesse computador (isto é, ComputadorB).

set mode

Define o modo atual para on-line ou off-line.

Sintaxe
set mode {online|offline}

Parâmetros
online
Define o modo atual para on-line.
offline
Define o modo atual para off-line.
/?
Exibe ajuda no prompt de comando.
show

Exibe informações sobre alias, auxiliar e modo.

Sintaxe
show {alias|helper|mode}

Parâmetros
alias
Lista todos os aliases definidos.
helper
Lista todos os auxiliares de primeiro nível.
modo
Exibe o modo atual.
/?
Exibe ajuda no prompt de comando.
unalias

Exclui o alias especificado.

Sintaxe
unalias nome_do_alias

Parâmetros
nome_do_alias
Obrigatório. Especifica o nome do alias.
/?
Exibe ajuda no prompt de comando.