Sintaxe do comando netsh, contextos e formataçãoNetsh Command Syntax, Contexts, and Formatting

Aplica-se a: Windows Server (canal semestral), Windows Server 2016Applies to: Windows Server (Semi-Annual Channel), Windows Server 2016

Você pode usar este tópico para saber como inserir subcontextos e contextos de netsh, compreender a sintaxe de netsh e formatação de comando e como executar comandos do netsh em computadores locais e remotos.You can use this topic to learn how to enter netsh contexts and subcontexts, understand netsh syntax and command formatting, and how to run netsh commands on local and remote computers.

O Netsh é um utilitário de linha de comando de script que lhe permite exibir ou modificar a configuração de rede de um computador que está sendo executado.Netsh is a command-line scripting utility that allows you to display or modify the network configuration of a computer that is currently running. Comandos do Netsh podem ser executados ao digitar comandos no prompt do netsh e eles podem ser usados em arquivos em lotes ou scripts.Netsh commands can be run by typing commands at the netsh prompt and they can be used in batch files or scripts. Computadores remotos e o computador local podem ser configurados usando comandos netsh.Remote computers and the local computer can be configured by using netsh commands.

O Netsh também fornece um recurso de script com o qual você pode executar um grupo de comandos no modo em lote para um computador especificado.Netsh also provides a scripting feature that allows you to run a group of commands in batch mode against a specified computer. Com o Netsh, você pode salvar um script de configuração em um arquivo de texto para fins de arquivamento ou para ajudar você a configurar outros computadores.With netsh, you can save a configuration script in a text file for archival purposes or to help you configure other computers.

Contextos de netshNetsh contexts

Netsh interage com outros componentes do sistema operacional usando dynamic-biblioteca de vínculo (DLL) arquivos.Netsh interacts with other operating system components by using dynamic-link library (DLL) files.

Cada DLL auxiliar do netsh fornece um amplo conjunto de recursos chamado um contexto, que é um grupo de comandos específicos para uma função de servidor de rede ou um recurso.Each netsh helper DLL provides an extensive set of features called a context, which is a group of commands specific to a networking server role or feature. Esses contextos estendem a funcionalidade do netsh, fornecendo a configuração e monitoramento suporte para um ou mais serviços, utilitários ou protocolos.These contexts extend the functionality of netsh by providing configuration and monitoring support for one or more services, utilities, or protocols. Por exemplo, Dhcpmon fornece netsh com o contexto e o conjunto de comandos necessários para configurar e gerenciar servidores DHCP.For example, Dhcpmon.dll provides netsh with the context and set of commands necessary to configure and manage DHCP servers.

Obter uma lista de contextosObtain a list of contexts

Você pode obter uma lista de contextos de netsh, abrindo o prompt de comando ou do Windows PowerShell em um computador executando o Windows Server 2016 ou Windows 10.You can obtain a list of netsh contexts by opening either command prompt or Windows PowerShell on a computer running Windows Server 2016 or Windows 10. Digite o comando netsh e pressione ENTER.Type the command netsh and press ENTER. Tipo de /?, e pressione ENTER.Type /?, and then press ENTER.

A seguir está um exemplo de saída para que esses comandos em um computador executando o Windows Server 2016 Datacenter.Following is example output for these commands on a computer running Windows Server 2016 Datacenter.

PS C:\Windows\system32> netsh
netsh>/?

The following commands are available:

Commands in this context:
..            - Goes up one context level.
?             - Displays a list of commands.
abort         - Discards changes made while in offline mode.
add           - Adds a configuration entry to a list of entries.
advfirewall   - Changes to the `netsh advfirewall' context.
alias         - Adds an alias.
branchcache   - Changes to the `netsh branchcache' context.
bridge        - Changes to the `netsh bridge' context.
bye           - Exits the program.
commit        - Commits changes made while in offline mode.
delete        - Deletes a configuration entry from a list of entries.
dhcpclient    - Changes to the `netsh dhcpclient' context.
dnsclient     - Changes to the `netsh dnsclient' context.
dump          - Displays a configuration script.
exec          - Runs a script file.
exit          - Exits the program.
firewall      - Changes to the `netsh firewall' context.
help          - Displays a list of commands.
http          - Changes to the `netsh http' context.
interface     - Changes to the `netsh interface' context.
ipsec         - Changes to the `netsh ipsec' context.
ipsecdosprotection - Changes to the `netsh ipsecdosprotection' context.
lan           - Changes to the `netsh lan' context.
namespace     - Changes to the `netsh namespace' context.
netio         - Changes to the `netsh netio' context.
offline       - Sets the current mode to offline.
online        - Sets the current mode to online.
popd          - Pops a context from the stack.
pushd         - Pushes current context on stack.
quit          - Exits the program.
ras           - Changes to the `netsh ras' context.
rpc           - Changes to the `netsh rpc' context.
set           - Updates configuration settings.
show          - Displays information.
trace         - Changes to the `netsh trace' context.
unalias       - Deletes an alias.
wfp           - Changes to the `netsh wfp' context.
winhttp       - Changes to the `netsh winhttp' context.
winsock       - Changes to the `netsh winsock' context.

The following sub-contexts are available:
 advfirewall branchcache bridge dhcpclient dnsclient firewall http interface ipsec ipsecdosprotection lan namespace netio ras rpc trace wfp winhttp winsock

To view help for a command, type the command, followed by a space, and then
 type ?.

SubcontextosSubcontexts

Contextos de Netsh podem conter comandos e contextos adicionais, chamados subcontextos.Netsh contexts can contain both commands and additional contexts, called subcontexts. Por exemplo, dentro do contexto de roteamento, você pode alterar os subcontextos IP e IPv6.For example, within the Routing context, you can change to the IP and IPv6 subcontexts.

Para exibir uma lista de comandos e subcontextos que podem ser usados dentro de um contexto, no prompt do netsh, digite o nome do contexto e, em seguida, digite um /?To display a list of commands and subcontexts that you can use within a context, at the netsh prompt, type the context name, and then type either /? ou ajudar.or help. Por exemplo, para exibir uma lista de subcontextos e comandos que você pode usar o contexto de roteamento, no prompt do netsh (ou seja, netsh>), digite o seguinte:For example, to display a list of subcontexts and commands that you can use in the Routing context, at the netsh prompt (that is, netsh>), type one of the following:

roteamento /?routing /?

Ajuda de roteamentorouting help

Para executar tarefas em outro contexto sem alterar o seu contexto atual, digite o caminho de contexto do comando que você deseja usar no prompt do netsh.To perform tasks in another context without changing from your current context, type the context path of the command you want to use at the netsh prompt. Por exemplo, para adicionar uma interface chamada "Conexão de área Local" no contexto IGMP sem alterar o primeiro para o contexto IGMP, no prompt do netsh, digite:For example, to add an interface named "Local Area Connection" in the IGMP context without first changing to the IGMP context, at the netsh prompt, type:

roteamento ip igmp adicionar a interface "Conexão de área Local" startupqueryinterval = 21routing ip igmp add interface "Local Area Connection" startupqueryinterval=21

Executando comandos netshRunning netsh commands

Para executar um comando netsh, você deve iniciar o netsh do prompt de comando, digitando netsh e, em seguida, pressionando ENTER.To run a netsh command, you must start netsh from the command prompt by typing netsh and then pressing ENTER. Em seguida, você pode alterar o contexto que contém o comando que você deseja usar.Next, you can change to the context that contains the command you want to use. Os contextos disponíveis dependem dos componentes de rede que você instalou.The contexts that are available depend on the networking components that you have installed. Por exemplo, se você digitar dhcp no prompt do netsh e pressione ENTER, netsh altera para o contexto do servidor DHCP.For example, if you type dhcp at the netsh prompt and press ENTER, netsh changes to the DHCP server context. Se você não tiver o DHCP foi instalado, no entanto, a seguinte mensagem será exibida:If you do not have DHCP installed, however, the following message appears:

O comando a seguir não foi encontrado: dhcp.The following command was not found: dhcp.

Formatando a legendaFormatting Legend

Você pode usar a seguinte legenda de formatação para interpretar e usar a sintaxe do comando netsh correta quando você executa o comando no prompt do netsh ou em um arquivo em lotes ou script.You can use the following formatting legend to interpret and use correct netsh command syntax when you run the command at the netsh prompt or in a batch file or script.

  • Texto em itálico são informações que você deve fornecer enquanto você digita o comando.Text in Italic is information that you must supply while you type the command. Por exemplo, se um comando tem um parâmetro chamado -nome de usuário, você deve digitar o nome de usuário real.For example, if a command has a parameter named -UserName, you must type the actual user name.
  • Texto em negrito são informações que você deve digitar exatamente como mostrados enquanto você digita o comando.Text in Bold is information that you must type exactly as shown while you type the command.
  • Texto seguido por reticências (... ) é um parâmetro que pode ser repetido várias vezes em uma linha de comando.Text followed by an ellipsis (...) is a parameter that can be repeated several times in a command line.
  • Texto entre colchetes [ ] é um item opcional.Text that is between brackets [ ] is an optional item.
  • Texto que está entre chaves { } com opções separadas por uma barra vertical fornece um conjunto de opções, na qual você deve selecionar apenas um, tais como {enable|disable}.Text that is between braces { } with choices separated by a pipe provides a set of choices from which you must select only one, such as {enable|disable}.
  • Texto formatado com a fonte de correio é a saída de programa ou código.Text that is formatted with the Courier font is code or program output.

Executando comandos Netsh do prompt de comando ou do Windows PowerShellRunning Netsh commands from the command prompt or Windows PowerShell

Para iniciar o Shell de rede e digite netsh no prompt de comando ou no Windows PowerShell, você pode usar o comando a seguir.To start Network Shell and enter netsh at the command prompt or in Windows PowerShell, you can use the following command.

netshnetsh

O Netsh é um utilitário de linha de comando de script que permite que você, localmente ou remotamente, exibir ou modificar a configuração de rede de um computador em execução no momento.Netsh is a command-line scripting utility that allows you to, either locally or remotely, display or modify the network configuration of a currently running computer. Usado sem parâmetros, netsh é aberto o prompt de comando Netsh.exe (, ou seja, netsh>).Used without parameters, netsh opens the Netsh.exe command prompt (that is, netsh>).

SintaxeSyntax

Netsh [ - um Arquivo_de_alias ] [ - c   Contexto ] [ - r RemoteComputer ] [ - u [ DomainName\ ] nome de usuário ] [ -p   Senha | * ] [{ComandoNetsh | -f   ScriptFile}]netsh[ -a AliasFile] [ -c Context ] [-r RemoteComputer] [ -u [ DomainName\ ] UserName ] [ -p Password | *] [{NetshCommand | -f ScriptFile}]

ParâmetrosParameters

-a

Opcional.Optional. Especifica que você retorna para o netsh prompt após a execução Arquivo_de_alias.Specifies that you are returned to the netsh prompt after running AliasFile.

AliasFile

Opcional.Optional. Especifica o nome do arquivo de texto que contém um ou mais netsh comandos.Specifies the name of the text file that contains one or more netsh commands.

-c

Opcional.Optional. Especifica que netsh insere especificado netsh contexto.Specifies that netsh enters the specified netsh context.

Context

Opcional.Optional. Especifica o netsh contexto que você deseja inserir.Specifies the netsh context that you want to enter.

-r

Opcional.Optional. Especifica que você deseja que o comando a ser executado em um computador remoto.Specifies that you want the command to run on a remote computer.

Importante

Quando você usa alguns comandos do netsh remotamente em outro computador com o netsh – r parâmetro, o serviço Registro remoto deve estar em execução no computador remoto.When you use some netsh commands remotely on another computer with the netsh –r parameter, the Remote Registry service must be running on the remote computer. Se não estiver em execução, o Windows exibe uma mensagem de erro "Caminho de rede não encontrado".If it is not running, Windows displays a “Network Path Not Found” error message.

RemoteComputer

Opcional.Optional. Especifica o computador remoto que você deseja configurar.Specifies the remote computer that you want to configure.

-u

Opcional.Optional. Especifica que você deseja executar o comando netsh sob uma conta de usuário.Specifies that you want to run the netsh command under a user account.

DomainName\\

Opcional.Optional. Especifica o domínio onde se encontra a conta de usuário.Specifies the domain where the user account is located. O padrão é o domínio local, se nome_do_domínio\ não for especificado.The default is the local domain if DomainName\ is not specified.

UserName

Opcional.Optional. Especifica o nome da conta de usuário.Specifies the user account name.

-p

Opcional.Optional. Especifica que você deseja fornecer uma senha para a conta de usuário.Specifies that you want to provide a password for the user account.

Password

Opcional.Optional. Especifica a senha da conta de usuário que você especificou com -u nome de usuário.Specifies the password for the user account that you specified with -u UserName.

NetshCommand

Opcional.Optional. Especifica o netsh comando que você deseja executar.Specifies the netsh command that you want to run.

-f

Opcional.Optional. Sai netsh depois de executar o script que você designe com ScriptFile.Exits netsh after running the script that you designate with ScriptFile.

ScriptFile

Opcional.Optional. Especifica o script que você deseja executar.Specifies the script that you want to run.

/?

Opcional.Optional. Exibe a Ajuda no prompt do netsh.Displays help at the netsh prompt.

Observação

Se você especificar -r seguido de outro comando, netsh executa o comando no computador remoto e, em seguida, retorna ao prompt de comando Cmd.exe.If you specify -r followed by another command, netsh runs the command on the remote computer and then returns to the Cmd.exe command prompt. Se você especificar -r sem outro comando, netsh é aberto no modo remoto.If you specify -r without another command, netsh opens in remote mode. O processo é semelhante a usar machine conjunto no prompt de comando Netsh.The process is similar to using set machine at the Netsh command prompt. Quando você usa -r, defina o computador de destino para a instância atual do netsh apenas.When you use -r, you set the target computer for the current instance of netsh only. Depois de sair e retornar netsh, o computador de destino será redefinido como o computador local.After you exit and reenter netsh, the target computer is reset as the local computer. Você pode executar netsh comandos em um computador remoto, especificando um computador nome armazenado no WINS, um nome UNC, um nome a ser resolvido pelo servidor DNS ou um endereço IP da Internet.You can run netsh commands on a remote computer by specifying a computer name stored in WINS, a UNC name, an Internet name to be resolved by the DNS server, or an IP address.

Digitando os valores de cadeia de caracteres de parâmetros para os comandos netshTyping parameter string values for netsh commands

Em toda a referência de comandos do Netsh, há comandos que contêm parâmetros para os quais é necessário um valor de cadeia de caracteres.Throughout the Netsh command reference there are commands that contain parameters for which a string value is required.

No caso em que um valor de cadeia de caracteres contém espaços entre os caracteres, como valores de cadeia de caracteres que consistem em mais de uma palavra, é necessário que você coloque o valor de cadeia de caracteres entre aspas.In the case where a string value contains spaces between characters, such as string values that consist of more than one word, it is required that you enclose the string value in quotation marks. Por exemplo, para um parâmetro denominado interface com um valor de cadeia de caracteres de Conexão de rede sem fio, use aspas ao redor do valor de cadeia de caracteres:For example, for a parameter named interface with a string value of Wireless Network Connection, use quotation marks around the string value:

interface="Wireless Network Connection"