Usando o Netsh

Netsh é um utilitário para elaborar scripts de linha de comando que permite, local e remotamente, mostrar 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á mostrada 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 mostrar 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 mostrar 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 utiliza a seguinte sintaxe. Para executar esses comandos netsh em um Microsoft Windows remoto, primeiro você deve usar Conexão de área de trabalho remota para se conectar a um Microsoft Windows que esteja executando o Terminal Server. Pode haver diferenças funcionais entre os comandos de contexto netsh no Microsoft Windows.

Para mostrar 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, mostrar 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 utiliza 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 Microsoft Windows remoto, primeiro você deve usar Conexão de área de trabalho remota para se conectar a um Microsoft Windows que esteja executando o Terminal Server. Pode haver diferenças funcionais entre os comandos de contexto netsh no Microsoft Windows.

Para mostrar 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 sequência de caracteres definida pelo usuário, que o netsh trata como equivalente a outra sequência de caracteres. Quando usado sem parâmetros, alias exibe todos os aliases disponíveis.

Sintaxe

alias [nome_do_alias] [sequência1 [sequência2 ...]]

Parâmetros

alias [nome_do_alias]

Exibe o alias especificado.

alias [nome_do_alias][sequência1[sequência2 ...]]

Define nome_do_alias para as sequê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 mostradas na configuração atualmente em execução.
• As alterações feitas no modo on-line são mostradas 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 mostradas 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 mostradas 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 subsequentes 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=]sequência]

Parâmetros

nome_do_computador

Especifica o nome do computador em serão realizadas tarefas de configuração.

sequê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.