Sintaxis, contextos y formatos de comandos NetshNetsh Command Syntax, Contexts, and Formatting

Se aplica a: Windows Server (canal semianual), Windows Server 2016Applies to: Windows Server (Semi-Annual Channel), Windows Server 2016

Puede usar este tema para obtener información sobre cómo especificar contextos y subcontextos de Netsh, comprender la sintaxis de Netsh y el formato de los comandos, y cómo ejecutar comandos Netsh en equipos locales y 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.

Netsh es una utilidad de scripting de línea de comandos que permite mostrar o modificar la configuración de red de un equipo que se está ejecutando actualmente.Netsh is a command-line scripting utility that allows you to display or modify the network configuration of a computer that is currently running. Los comandos Netsh se pueden ejecutar escribiendo comandos en el símbolo del sistema de Netsh y se pueden usar en archivos por lotes o scripts.Netsh commands can be run by typing commands at the netsh prompt and they can be used in batch files or scripts. Los equipos remotos y el equipo local se pueden configurar mediante los comandos Netsh.Remote computers and the local computer can be configured by using netsh commands.

Netsh también proporciona una característica de scripting que permite ejecutar un grupo de comandos en modo de lotes con un equipo especificado.Netsh also provides a scripting feature that allows you to run a group of commands in batch mode against a specified computer. Con netsh se puede guardar un script de configuración en un archivo de texto para archivarlo y así configurar otros equipos.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 interactúa con otros componentes del sistema operativo mediante el uso de la biblioteca dinámica @ no__t-0link (DLL @ no__t-2.Netsh interacts with other operating system components by using dynamic-link library (DLL) files.

Cada archivo DLL de la aplicación auxiliar netsh proporciona un amplio conjunto de características denominado contexto, que es un grupo de comandos específicos de un rol o característica del servidor de red.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. Estos contextos amplían la funcionalidad de Netsh al proporcionar compatibilidad con la configuración y la supervisión de uno o varios servicios, utilidades o protocolos.These contexts extend the functionality of netsh by providing configuration and monitoring support for one or more services, utilities, or protocols. Por ejemplo, Dhcpmon. dll proporciona netsh con el contexto y el conjunto de comandos necesarios para configurar y administrar los servidores DHCP.For example, Dhcpmon.dll provides netsh with the context and set of commands necessary to configure and manage DHCP servers.

Obtener una lista de contextosObtain a list of contexts

Para obtener una lista de contextos de Netsh, abra el símbolo del sistema o Windows PowerShell en un equipo que ejecute Windows Server 2016 o 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. Escriba el comando netsh y presione Entrar.Type the command netsh and press ENTER. Escriba /? y, a continuación, presione Entrar.Type /?, and then press ENTER.

A continuación se muestra una salida de ejemplo para estos comandos en un equipo que ejecuta 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

Los contextos netsh pueden contener comandos y contextos adicionales, denominados subcontextos.Netsh contexts can contain both commands and additional contexts, called subcontexts. Por ejemplo, en el contexto de enrutamiento, puede cambiar a los subcontextos IP e IPv6.For example, within the Routing context, you can change to the IP and IPv6 subcontexts.

Para mostrar una lista de comandos y subcontextos que puede usar en un contexto, en el símbolo del sistema de Netsh, escriba el nombre del contexto y, a continuación, escriba /?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 /? o la ayudade.or help. Por ejemplo, para mostrar una lista de subcontextos y comandos que puede usar en el contexto de enrutamiento, en el símbolo del sistema de Netsh (that es, netsh @ no__t-2), escriba uno de los siguientes: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:

¿enrutamiento/?routing /?

ayuda de enrutamientorouting help

Para realizar tareas en otro contexto sin cambiar el contexto actual, escriba la ruta de acceso de contexto del comando que desea utilizar en el símbolo del sistema de 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 ejemplo, para agregar una interfaz denominada "conexión de área local" en el contexto de IGMP sin cambiar primero al contexto de IGMP, en el símbolo del sistema de Netsh, escriba: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:

IP de enrutamiento IGMP agregar interfaz "conexión de área local" startupqueryinterval = 21routing ip igmp add interface "Local Area Connection" startupqueryinterval=21

Ejecutar comandos NetshRunning netsh commands

Para ejecutar un comando netsh, debe iniciar Netsh desde el símbolo del sistema; para ello, escriba netsh y presione Entrar.To run a netsh command, you must start netsh from the command prompt by typing netsh and then pressing ENTER. A continuación, puede cambiar al contexto que contiene el comando que quiere usar.Next, you can change to the context that contains the command you want to use. Los contextos que están disponibles dependen de los componentes de red que haya instalado.The contexts that are available depend on the networking components that you have installed. Por ejemplo, si escribe DHCP en el símbolo del sistema de Netsh y presiona entrar, netsh cambia al contexto del servidor DHCP.For example, if you type dhcp at the netsh prompt and press ENTER, netsh changes to the DHCP server context. Sin embargo, si no tiene DHCP instalado, aparece el siguiente mensaje:If you do not have DHCP installed, however, the following message appears:

No se encontró el comando siguiente: DHCP.The following command was not found: dhcp.

Aplicar formato a la leyendaFormatting Legend

Puede usar la siguiente leyenda de formato para interpretar y utilizar la sintaxis del comando netsh correcta al ejecutar el comando en el símbolo del sistema de Netsh o en un archivo o script por lotes.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.

  • El texto en cursiva es información que debe proporcionar mientras escribe el comando.Text in Italic is information that you must supply while you type the command. Por ejemplo, si un comando tiene un parámetro denominado-username, debe escribir el nombre de usuario real.For example, if a command has a parameter named -UserName, you must type the actual user name.
  • El texto en negrita es información que debe escribir exactamente como se muestra mientras escribe el comando.Text in Bold is information that you must type exactly as shown while you type the command.
  • El texto seguido de un botón de puntos suspensivos (... ) es un parámetro que se puede repetir varias veces en una línea de comandos.Text followed by an ellipsis (...) is a parameter that can be repeated several times in a command line.
  • El texto entre corchetes [ ] es un elemento opcional.Text that is between brackets [ ] is an optional item.
  • El texto entre llaves { } con opciones separadas por una canalización proporciona un conjunto de opciones de las que debe seleccionar solo una, 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}.
  • El texto al que se da formato con la fuente Courier es código o resultado del programa.Text that is formatted with the Courier font is code or program output.

Ejecutar comandos Netsh desde el símbolo del sistema o Windows PowerShellRunning Netsh commands from the command prompt or Windows PowerShell

Para iniciar el shell de red y escribir Netsh en el símbolo del sistema o en Windows PowerShell, puede usar el siguiente comando.To start Network Shell and enter netsh at the command prompt or in Windows PowerShell, you can use the following command.

netshnetsh

Netsh es una utilidad de scripting de línea de comandos que permite mostrar o modificar la configuración de red de un equipo que se está ejecutando actualmente, ya sea de forma local o remota.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. Si se usa sin parámetros, netsh abre el símbolo del sistema netsh. exe @no__t-clientes 1 es, netsh @ no__t-3).Used without parameters, netsh opens the Netsh.exe command prompt (that is, netsh>).

SintaxisSyntax

netsh[ -a AliasFile] [ -c Context 0 1 -r3equiporemoto5 6 -u 8 DomainName @ no__t-20 1 nombreDeUsuario 3 4 -p6contraseña8 @ no__t-29 @ No__t-30 1 {NetshCommand3 -f5ScriptFile} 7netsh[ -a AliasFile] [ -c Context ] [-r RemoteComputer] [ -u [ DomainName\ ] UserName ] [ -p Password | *] [{NetshCommand | -f ScriptFile}]

ParámetrosParameters

-a

Opcional.Optional. Especifica que se devuelve al símbolo del sistema de netsh después de ejecutar AliasFile.Specifies that you are returned to the netsh prompt after running AliasFile.

AliasFile

Opcional.Optional. Especifica el nombre del archivo de texto que contiene uno o más comandos netsh .Specifies the name of the text file that contains one or more netsh commands.

-c

Opcional.Optional. Especifica que netsh entra en el contexto de netsh especificado.Specifies that netsh enters the specified netsh context.

Context

Opcional.Optional. Especifica el contexto de netsh que se desea escribir.Specifies the netsh context that you want to enter.

-r

Opcional.Optional. Especifica que desea que el comando se ejecute en un equipo remoto.Specifies that you want the command to run on a remote computer.

Importante

Si usa algunos comandos Netsh de forma remota en otro equipo con el parámetro netsh – r , el servicio de registro remoto debe estar en ejecución en el equipo 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. Si no se está ejecutando, Windows muestra un mensaje de error "ruta de acceso de red no encontrada".If it is not running, Windows displays a “Network Path Not Found” error message.

RemoteComputer

Opcional.Optional. Especifica el equipo remoto que desea configurar.Specifies the remote computer that you want to configure.

-u

Opcional.Optional. Especifica que desea ejecutar el comando netsh en una cuenta de usuario.Specifies that you want to run the netsh command under a user account.

DomainName\\

Opcional.Optional. Especifica el dominio en el que se encuentra la cuenta de usuario.Specifies the domain where the user account is located. El valor predeterminado es el dominio local si no se especifica domainname @ no__t-1 .The default is the local domain if DomainName\ is not specified.

UserName

Opcional.Optional. Especifica el nombre de la cuenta de usuario.Specifies the user account name.

-p

Opcional.Optional. Especifica que desea proporcionar una contraseña para la cuenta de usuario.Specifies that you want to provide a password for the user account.

Password

Opcional.Optional. Especifica la contraseña de la cuenta de usuario que especificó con -u nombreDeUsuario.Specifies the password for the user account that you specified with -u UserName.

NetshCommand

Opcional.Optional. Especifica el comando netsh que desea ejecutar.Specifies the netsh command that you want to run.

-f

Opcional.Optional. Sale de netsh después de ejecutar el script que se designa con ScriptFile.Exits netsh after running the script that you designate with ScriptFile.

ScriptFile

Opcional.Optional. Especifica el script que desea ejecutar.Specifies the script that you want to run.

/?

Opcional.Optional. Muestra la ayuda en el símbolo del sistema de Netsh.Displays help at the netsh prompt.

Nota

Si especifica -r seguido de otro comando, netsh ejecuta el comando en el equipo remoto y, a continuación, vuelve al símbolo del sistema 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. Si especifica -r sin otro comando, netsh se abre en modo remoto.If you specify -r without another command, netsh opens in remote mode. El proceso es similar al uso de set Machine en el símbolo del sistema de Netsh.The process is similar to using set machine at the Netsh command prompt. Cuando se usa -r , el equipo de destino solo se establece para la instancia actual de netsh .When you use -r, you set the target computer for the current instance of netsh only. Después de salir y volver a escribir netsh, el equipo de destino se restablece como el equipo local.After you exit and reenter netsh, the target computer is reset as the local computer. Los comandos netsh se pueden ejecutar en un equipo remoto mediante la especificación de un nombre de equipo almacenado en WINS, un nombre UNC, un nombre de Internet que debe resolver el servidor DNS o una dirección IP.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.

Escribir valores de cadena de parámetros para comandos NetshTyping parameter string values for netsh commands

En la referencia del comando netsh hay comandos que contienen parámetros para los que se requiere un valor de cadena.Throughout the Netsh command reference there are commands that contain parameters for which a string value is required.

En el caso de que un valor de cadena contenga espacios entre caracteres, como los valores de cadena que se componen de más de una palabra, es necesario incluir el valor de cadena entre comillas.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 ejemplo, para un parámetro denominado interface con un valor de cadena de conexión de red inalámbrica, utilice comillas alrededor del valor de cadena: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"