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

È possibile utilizzare questo argomento per informazioni su come immettere i sottocontesti e contesti di netsh, conoscere la sintassi di netsh e comandi di formattazione e come eseguire i comandi netsh nei 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 è un'utilità di scripting da riga di comando che consente di visualizzare o modificare la configurazione di rete di un computer in cui è 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. È possibile eseguire comandi Netsh digitando i comandi al prompt netsh e possono essere utilizzati 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 di NetshNetsh contexts

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

Ogni DLL di supporto di netsh fornisce un'ampia gamma di funzionalità chiamate una contesto, ovvero un gruppo di comandi specifici di un ruolo del server o funzionalità 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. Questi contesti di estendono le funzionalità di netsh grazie a configurazione e il supporto per uno o più servizi, utilità o protocolli di monitoraggio.These contexts extend the functionality of netsh by providing configuration and monitoring support for one or more services, utilities, or protocols. Ad esempio, file Dhcpmon. netsh con 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

È possibile ottenere un elenco di contesti di netsh, aprire Windows PowerShell o prompt dei comandi 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. Digitare il comando netsh e premere INVIO.Type the command netsh and press ENTER. Tipo di /? , quindi premere INVIO.Type /?, and then press ENTER.

Seguito è riportato l'output di 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

Netsh contesti possono contenere sia comandi sia altri contesti, chiamati sottocontesti.Netsh contexts can contain both commands and additional contexts, called subcontexts. All'interno del contesto di Routing, ad esempio, è possibile modificare per i sottocontesti l'indirizzo 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 i sottocontesti che è possibile usare in un contesto, al prompt netsh, digitare il nome del contesto e quindi digitare uno /?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 /? oppure aiutare.or help. Ad esempio, per visualizzare un elenco di sottocontesti e che è possibile usare i comandi nel contesto di Routing, al prompt netsh (vale a dire netsh> ), digitare uno dei 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 /?

Guida di routingrouting help

Per eseguire attività in un altro contesto senza modificare il contesto corrente, digitare il percorso del contesto del comando da usare al prompt dei comandi di 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 Area locale" nel contesto di IGMP senza modificare il primo nel contesto di IGMP, al prompt netsh, digitare: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 aggiungere interfaccia "Connessione Area locale" startupqueryinterval = 21routing ip igmp add interface "Local Area Connection" startupqueryinterval=21

Esecuzione di comandi netshRunning netsh commands

Per eseguire un comando netsh, è necessario avviare netsh dal prompt dei comandi digitando netsh e quindi premere INVIO.To run a netsh command, you must start netsh from the command prompt by typing netsh and then pressing ENTER. Successivamente, è possibile modificare il contesto che contiene il comando da usare.Next, you can change to the context that contains the command you want to use. I contesti disponibili variano in base i componenti di rete installate.The contexts that are available depend on the networking components that you have installed. Ad esempio, se si digita dhcp prompt netsh, quindi premere INVIO, netsh delle modifiche nel contesto di server DHCP.For example, if you type dhcp at the netsh prompt and press ENTER, netsh changes to the DHCP server context. Se non hai DHCP installato, tuttavia, viene visualizzato il messaggio seguente:If you do not have DHCP installed, however, the following message appears:

Il comando seguente non è stato trovato: dhcp.The following command was not found: dhcp.

Formattazione della legendaFormatting Legend

È possibile utilizzare la legenda di formattazione seguente per interpretare e usare la sintassi del comando netsh corretto quando si esegue il comando al prompt netsh o in un file batch o 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.

  • Testo in corsivo informazioni che è necessario fornire mentre si digita il comando.Text in Italic is information that you must supply while you type the command. Ad esempio, se un comando ha un parametro denominato -UserName, è necessario digitare il nome utente effettivo.For example, if a command has a parameter named -UserName, you must type the actual user name.
  • Testo in grassetto informazioni che è necessario digitare esattamente come visualizzati mentre si digita il comando.Text in Bold is information that you must type exactly as shown while you type the command.
  • Testo seguita dai 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.
  • Testo che si trova tra parentesi quadre [ ] è un elemento facoltativo.Text that is between brackets [ ] is an optional item.
  • Testo che si trova tra parentesi graffe { } con varie scelte separate da una pipe fornisce un set di opzioni da cui è necessario selezionare solo uno, 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 è codice programma o output.Text that is formatted with the Courier font is code or program output.

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

Per avviare la Shell di rete e immettere netsh al prompt dei comandi o in Windows PowerShell, è possibile 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 è un'utilità di scripting da riga di comando che consente, in locale o remoto, visualizzare o modificare 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. Se utilizzato 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 [ - una FileAlias ] [ - c   Contesto ] [ - r ComputerRemoto ] [ - u [ NomeDominio\ ] UserName ] [ -p   Password | * ] [{comando Netsh | -f   ScriptFile}]netsh[ -a AliasFile] [ -c Context ] [-r RemoteComputer] [ -u [ DomainName\ ] UserName ] [ -p Password | *] [{NetshCommand | -f ScriptFile}]

ParametriParameters

-a

Facoltativo.Optional. Specifica che sono restituiti per il netsh dei messaggi di richiesta dopo aver eseguito FileAlias.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ù netsh comandi.Specifies the name of the text file that contains one or more netsh commands.

-c

Facoltativo.Optional. Specifica che netsh passa l'oggetto specificato netsh contesto.Specifies that netsh enters the specified netsh context.

Context

Facoltativo.Optional. Specifica la netsh contesto che si desidera immettere.Specifies the netsh context that you want to enter.

-r

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

Importante

Quando si usano alcuni comandi netsh in modalità remota in un altro computer con il netsh – r parametro, il servizio Registro di sistema remoto deve essere in esecuzione nel computer 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 "Rete percorso non trovato".If it is not running, Windows displays a “Network Path Not Found” error message.

RemoteComputer

Facoltativo.Optional. Specifica il computer remoto che si desidera configurare.Specifies the remote computer that you want to configure.

-u

Facoltativo.Optional. Specifica che si desidera 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 NomeDominio\ non è specificato.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 si desidera specificare 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 specificato con -u UserName.Specifies the password for the user account that you specified with -u UserName.

NetshCommand

Facoltativo.Optional. Specifica la netsh comando che si desidera eseguire.Specifies the netsh command that you want to run.

-f

Facoltativo.Optional. Uscite netsh dopo aver eseguito lo script specificato con il ScriptFile.Exits netsh after running the script that you designate with ScriptFile.

ScriptFile

Facoltativo.Optional. Specifica lo script che si desidera eseguire.Specifies the script that you want to run.

/?

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

Nota

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

Digitare i valori di stringa di parametro per i comandi netshTyping parameter string values for netsh commands

In tutto il riferimento ai comandi Netsh sono disponibili comandi contenenti parametri per il quale è necessario un valore di 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 contiene spazi tra i caratteri, ad esempio i valori stringa costituita da più di una parola, è necessario racchiudere il valore di 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 il valore stringa connessione rete Wireless, racchiudere il valore di 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"