Sintassi, contesti e formattazione dei comandi NetshNetsh Command Syntax, Contexts, and Formatting

Si applica a: Windows Server (Canale semestrale), Windows Server 2016Applies to: Windows Server (Semi-Annual Channel), Windows Server 2016

Puoi usare questo argomento per informazioni su come immettere contesti e sottocontesti Netsh, per acquisire familiarità con la formattazione dei comandi e la sintassi Netsh e per capire come eseguire comandi Netsh in computer locali e remoti.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 è una utilità di scripting da riga di comando che consente di visualizzare o modificare la configurazione di rete di un computer attualmente in esecuzione.Netsh is a command-line scripting utility that allows you to display or modify the network configuration of a computer that is currently running. I comandi Netsh possono essere eseguiti mediante digitazione al prompt netsh e possono essere usati in script o file batch.Netsh commands can be run by typing commands at the netsh prompt and they can be used in batch files or scripts. I computer remoti e il computer locale possono essere configurati usando i comandi Netsh.Remote computers and the local computer can be configured by using netsh commands.

Netsh offre inoltre una funzionalità di scripting che consente di eseguire un gruppo di comandi in modalità batch su un computer specificato.Netsh also provides a scripting feature that allows you to run a group of commands in batch mode against a specified computer. Con Netsh è possibile salvare uno script di configurazione in un file di testo per scopi di archiviazione o per facilitare la configurazione di altri computer.With netsh, you can save a configuration script in a text file for archival purposes or to help you configure other computers.

Contesti NetshNetsh contexts

Netsh interagisce con altri componenti del sistema operativo tramite file -DLL (dynamic link library, libreria di collegamento dinamico).Netsh interacts with other operating system components by using dynamic-link library (DLL) files.

Ogni DLL helper Netsh fornisce un set completo di funzionalità denominato contesto, ovvero un gruppo di comandi specifici per una funzionalità o un ruolo server di rete.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. I contesti estendono le funzionalità di Netsh fornendo supporto per la configurazione e il monitoraggio per uno o più servizi, utilità o protocolli.These contexts extend the functionality of netsh by providing configuration and monitoring support for one or more services, utilities, or protocols. Ad esempio, Dhcpmon.dll fornisce a Netsh il contesto e il set di comandi necessari per configurare e gestire i server DHCP.For example, Dhcpmon.dll provides netsh with the context and set of commands necessary to configure and manage DHCP servers.

Ottenere un elenco di contestiObtain a list of contexts

Puoi ottenere un elenco di contesti Netsh aprendo il prompt dei comandi o Windows PowerShell in un computer che esegue 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. Digita il comando netsh e premi INVIO.Type the command netsh and press ENTER. Digita /? e quindi premi INVIO.Type /?, and then press ENTER.

Di seguito è riportato un output di esempio per questi comandi in un computer che esegue 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 ?.

SottocontestiSubcontexts

I contesti Netsh possono contenere sia comandi che contesti aggiuntivi, denominati sottocontesti.Netsh contexts can contain both commands and additional contexts, called subcontexts. Ad esempio, dal contesto routing puoi passare ai sottocontesti IP e IPv6.For example, within the Routing context, you can change to the IP and IPv6 subcontexts.

Per visualizzare un elenco di comandi e sottocontesti che possono essere usati all'interno di un contesto, al prompt netsh digita il nome del contesto e quindi /?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 help.or help. Per visualizzare ad esempio un elenco di sottocontesti e comandi che possono essere usati nel contesto di routing, al prompt netsh, (ovvero netsh> ), digita uno dei comandi seguenti: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:

routing /?routing /?

routing helprouting help

Per eseguire attività in un altro contesto senza cambiare il contesto corrente, digita il percorso del contesto del comando che vuoi usare al prompt 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. Ad esempio, per aggiungere un'interfaccia denominata "Connessione alla rete locale" nel contesto IGMP senza prima passare al contesto IGMP, al prompt netsh digita: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:

routing ip igmp add interface "Connessione alla rete locale" startupqueryinterval=21routing ip igmp add interface "Local Area Connection" startupqueryinterval=21

Esecuzione dei comandi NetshRunning netsh commands

Per eseguire un comando Netsh, devi avviare Netsh dal prompt dei comandi digitando netsh e quindi premendo INVIO.To run a netsh command, you must start netsh from the command prompt by typing netsh and then pressing ENTER. Puoi quindi passare al contesto che contiene il comando che vuoi usare.Next, you can change to the context that contains the command you want to use. I contesti disponibili dipendono dai componenti di rete installati.The contexts that are available depend on the networking components that you have installed. Se ad esempio digiti dhcp al prompt netsh e premi INVIO, Netsh passa al contesto del server DHCP.For example, if you type dhcp at the netsh prompt and press ENTER, netsh changes to the DHCP server context. Se però DHCP non è installato, viene visualizzato il messaggio seguente:If you do not have DHCP installed, however, the following message appears:

Impossibile trovare il comando seguente: dhcp.The following command was not found: dhcp.

Convenzioni di formattazioneFormatting Legend

Puoi usare le convenzioni di formattazione seguenti per interpretare e usare la sintassi dei comandi Netsh corretta quando esegui il comando al prompt netsh oppure in uno script o file batch.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.

  • Il testo in corsivo indica le informazioni che devi fornire quando digiti il comando.Text in Italic is information that you must supply while you type the command. Se ad esempio un comando ha un parametro denominato -UserName, devi digitare il nome utente effettivo.For example, if a command has a parameter named -UserName, you must type the actual user name.
  • Il testo in grassetto è costituito da informazioni che devono essere digitate esattamente così come sono quando digiti il comando.Text in Bold is information that you must type exactly as shown while you type the command.
  • Il testo seguito da puntini di sospensione (...) è un parametro che può essere ripetuto più volte in una riga di comando.Text followed by an ellipsis (...) is a parameter that can be repeated several times in a command line.
  • Il testo racchiuso tra parentesi quadre [ ] è un elemento facoltativo.Text that is between brackets [ ] is an optional item.
  • Il testo tra parentesi graffe { } con opzioni separate da una barra verticale fornisce un set di opzioni da cui devi selezionarne solo una, ad esempio {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}.
  • Il testo formattato con il tipo di carattere Courier indica codice oppure output del programma.Text that is formatted with the Courier font is code or program output.

Esecuzione di comandi Netsh dal prompt dei comandi o da Windows PowerShellRunning Netsh commands from the command prompt or Windows PowerShell

Per avviare la shell della rete e immettere netsh al prompt dei comandi o in Windows PowerShell, puoi usare il comando seguente.To start Network Shell and enter netsh at the command prompt or in Windows PowerShell, you can use the following command.

netshnetsh

Netsh è una utilità di scripting da riga di comando che consente di visualizzare o modificare localmente o da remoto la configurazione di rete di un computer attualmente in esecuzione.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. Usato senza parametri, netsh apre il prompt dei comandi Netsh.exe (ovvero netsh> ).Used without parameters, netsh opens the Netsh.exe command prompt (that is, netsh>).

SintassiSyntax

netsh[ -a AliasFile] [ -c Context ] [ -r RemoteComputer] [ -u [ DomainName\ ] UserName ] [ -p Password | *] [{NetshCommand | -f ScriptFile}]netsh[ -a AliasFile] [ -c Context ] [-r RemoteComputer] [ -u [ DomainName\ ] UserName ] [ -p Password | *] [{NetshCommand | -f ScriptFile}]

ParametriParameters

-a

Facoltativo.Optional. Specifica che dopo l'esecuzione di AliasFile verrà visualizzato nuovamente il prompt netsh.Specifies that you are returned to the netsh prompt after running AliasFile.

AliasFile

Facoltativo.Optional. Specifica il nome del file di testo che contiene uno o più comandi netsh.Specifies the name of the text file that contains one or more netsh commands.

-c

Facoltativo.Optional. Specifica che Netsh immette il contesto netsh specificato.Specifies that netsh enters the specified netsh context.

Context

Facoltativo.Optional. Specifica il contesto netsh da immettere.Specifies the netsh context that you want to enter.

-r

Facoltativo.Optional. Specifica che il comando deve essere eseguito in un computer remoto.Specifies that you want the command to run on a remote computer.

Importante

Quando usi alcuni comandi netsh in remoto in un altro computer con il parametro netsh - r, deve essere in esecuzione nel computer remoto il servizio Registro di sistema 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 non è in esecuzione, Windows visualizza un messaggio di errore che indica che il percorso di rete non è stato trovato.If it is not running, Windows displays a “Network Path Not Found” error message.

RemoteComputer

Facoltativo.Optional. Specifica il nome del computer che intendi configurare.Specifies the remote computer that you want to configure.

-u

Facoltativo.Optional. Specifica di eseguire il comando netsh con un account utente.Specifies that you want to run the netsh command under a user account.

DomainName\\

Facoltativo.Optional. Specifica il dominio in cui si trova l'account utente.Specifies the domain where the user account is located. Il valore predefinito è il dominio locale se non specifichi DomainName\ .The default is the local domain if DomainName\ is not specified.

UserName

Facoltativo.Optional. Specifica il nome dell'account utente.Specifies the user account name.

-p

Facoltativo.Optional. Specifica che vuoi fornire una password per l'account utente.Specifies that you want to provide a password for the user account.

Password

Facoltativo.Optional. Specifica la password per l'account utente indicato con -u UserName.Specifies the password for the user account that you specified with -u UserName.

NetshCommand

Facoltativo.Optional. Specifica il comando netsh da eseguire.Specifies the netsh command that you want to run.

-f

Facoltativo.Optional. Chiude netsh dopo l'esecuzione dello script designato con ScriptFile.Exits netsh after running the script that you designate with ScriptFile.

ScriptFile

Facoltativo.Optional. Specifica lo script da eseguire.Specifies the script that you want to run.

/?

Facoltativo.Optional. Visualizza la Guida al prompt netsh.Displays help at the netsh prompt.

Nota

Se specifichi -r seguito da un altro comando, netsh esegue il comando nel computer remoto e quindi torna al prompt dei comandi 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 specifichi -r senza un altro comando, netsh si apre in modalità remota.If you specify -r without another command, netsh opens in remote mode. Il processo è simile all'uso di set machine al prompt dei comandi netsh.The process is similar to using set machine at the Netsh command prompt. Quando usi -r , devi impostare il computer di destinazione solo per l'istanza corrente di netsh.When you use -r, you set the target computer for the current instance of netsh only. Dopo aver chiuso e riaperto netsh, il computer di destinazione viene reimpostato come computer locale.After you exit and reenter netsh, the target computer is reset as the local computer. Puoi eseguire i comandi netsh in un computer remoto specificando un nome di computer archiviato in WINS, un nome UNC, un nome Internet che verrà risolto dal server DNS o un indirizzo 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.

Digitazione dei valori stringa dei parametri per i comandi netshTyping parameter string values for netsh commands

In tutte le informazioni di riferimento dei comandi netsh sono presenti comandi che contengono parametri per i quali è richiesto un valore stringa.Throughout the Netsh command reference there are commands that contain parameters for which a string value is required.

Nel caso in cui un valore stringa includa spazi tra i caratteri, ad esempio valori stringa costituiti da più parole, devi racchiudere il valore stringa tra virgolette.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. Ad esempio, per un parametro denominato interface con un valore stringa Wireless Network Connection, racchiudi il valore stringa tra virgolette: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"