Sintassi, contesti e formattazione dei comandi Netsh
Si applica a: Windows Server 2022, Windows Server 2019, Windows Server 2016, Azure Stack HCI, versioni 21H2 e 20H2
Leggere questo articolo 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.
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. I comandi Netsh possono essere eseguiti mediante digitazione alla shell netsh e possono essere usati in script o file batch. I computer remoti e il computer locale possono essere configurati usando i comandi Netsh.
Netsh offre inoltre una funzionalità di scripting che consente di eseguire un gruppo di comandi in modalità batch su un computer specificato. 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.
Sintassi
netsh
netsh [-a AliasFile] [-c Context] [-r RemoteMachine] [-u [DomainName\]UserName] [-p Password | *] [Command | -f ScriptFile]
I seguenti parametri sono considerati facoltativi.
| Parametro | Descrizione |
|---|---|
| -a | Specifica che viene restituita la shell netsh dopo l'esecuzione di AliasFile. |
AliasFile |
Specifica il nome del file di testo che contiene uno o più comandi netsh. |
| -c | Specifica che Netsh immette il contesto netsh specificato. |
Context |
Specifica il contesto netsh da immettere. |
| -r | Specifica che il comando deve essere eseguito in un computer remoto. Il servizio Registro remoto deve essere in esecuzione nel computer remoto. Se non è in esecuzione, Windows visualizza un messaggio di errore "Percorso di rete non trovato". |
RemoteComputer |
Specifica il nome del computer che intendi configurare. |
| -u | Specifica di eseguire il comando netsh con un account utente. |
DomainName\ |
Specifica il dominio in cui si trova l'account utente. Se DomainName\ non è specificato, il valore predefinito è il dominio locale. |
UserName |
Specifica il nome dell'account utente. |
| -p | Specifica che vuoi fornire una password per l'account utente. |
Password |
Specifica la password per l'account utente indicato con -uUserName. |
Command |
Specifica il comando netsh da eseguire. |
| -f | Chiude netsh dopo l'esecuzione dello script designato con ScriptFile. |
ScriptFile |
Specifica lo script da eseguire. |
Nota
Se si specifica -r, seguito da un altro comando, netsh esegue il comando nel computer remoto e quindi torna al prompt dei comandi. Se specifichi -r senza un altro comando, netsh si apre in modalità remota. Il processo è simile all'uso di set machine alla shell del comando netsh. Quando usi -r, devi impostare il computer di destinazione solo per l'istanza corrente di netsh. Dopo aver chiuso e riaperto netsh, il computer di destinazione viene reimpostato come computer locale. 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.
Esecuzione dei comandi Netsh
Per eseguire un comando Netsh, devi avviare Netsh dal prompt dei comandi digitando netsh e premendo INVIO. Puoi quindi passare al contesto che contiene il comando che vuoi usare. I contesti disponibili dipendono dai componenti di rete installati.
Se, ad esempio, si digita dhcp nella shell netsh e si preme INVIO, Netsh passa al contesto del server DHCP. Se non si ha un ruolo server DHCP installato, viene visualizzato il messaggio seguente:
The following command was not found: dhcp.
Contesti Netsh
Netsh interagisce con altri componenti del sistema operativo tramite file DLL dynamic-link library (DLL).
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. I contesti estendono le funzionalità di Netsh fornendo supporto per la configurazione e il monitoraggio per uno o più servizi, utilità o protocolli.
Ad esempio, Dhcpmon.dll fornisce a Netsh il contesto e il set di comandi necessari per configurare e gestire i server DHCP.
È possibile ottenere un elenco di contesti netsh aprendo il prompt dei comandi o Windows PowerShell, quindi digitare netsh /? o netsh help e premere INVIO.
Di seguito è riportato un esempio di output:
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 ?.
Sottocontesti Netsh
I contesti Netsh possono contenere sia comandi che contesti aggiuntivi, denominati sottocontesti. Ad esempio, dal contesto interface, è possibile passare ai sottocontesti IPv4 e IPv6.
Per visualizzare un elenco di comandi e sottocontesti che possono essere usati all'interno di un contesto, alla shell netsh digitare il nome del sottocontesto, quindi ? o help. Ad esempio:
netsh> interface help The following commands are available: Commands in this context: 6to4 - Changes to the `netsh interface 6to4' context. ? - Displays a list of commands. dump - Displays a configuration script. help - Displays a list of commands. httpstunnel - Changes to the `netsh interface httpstunnel' context. ipv4 - Changes to the `netsh interface ipv4' context. ipv6 - Changes to the `netsh interface ipv6' context. isatap - Changes to the `netsh interface isatap' context. portproxy - Changes to the `netsh interface portproxy' context. set - Sets configuration information. show - Displays information. tcp - Changes to the `netsh interface tcp' context. teredo - Changes to the `netsh interface teredo' context. udp - Changes to the `netsh interface udp' context. The following sub-contexts are available: 6to4 httpstunnel ipv4 ipv6 isatap portproxy tcp teredo udp To view help for a command, type the command, followed by a space, and then type ?.
Per eseguire attività in un altro contesto senza cambiare il contesto corrente, digitare il percorso del contesto del comando che si desidera usare nella shell netsh. Ad esempio, per aggiungere un indirizzo IPv4 statico per "NetLAN1" e specificare sia la subnet mask che il gateway, digitare:
netsh interface ipv4 set address "NetLAN1" static <IP_Address> <Subnet_Mask> <Gateway>
Convenzioni di formattazione
È possibile usare le convenzioni di formattazione seguenti per interpretare e usare la sintassi dei comandi Netsh corretta quando si esegue il comando alla shell netsh oppure in uno script o file batch.
- Il testo in corsivo indica le informazioni che devi fornire quando digiti il comando. Se ad esempio un comando ha un parametro denominato -UserName, devi digitare il nome utente effettivo.
- Il testo in grassetto è costituito da informazioni che devono essere digitate esattamente così come sono quando digiti il comando.
- Il testo seguito da puntini di sospensione (...) è un parametro che può essere ripetuto più volte in una riga di comando.
- Il testo racchiuso tra parentesi quadre [ ] è un elemento facoltativo.
- 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}. - Il testo formattato con il tipo di carattere Courier indica codice oppure output del programma.
Valori stringa per i comandi netsh
Esistono comandi che contengono parametri per i quali è richiesto un valore stringa. Nel caso in cui un valore stringa contenga spazi tra i caratteri, è necessario racchiudere il valore stringa tra virgolette doppie.
Quando si imposta il parametro interface per le reti IPv4 con un valore stringa di Connessione di rete wireless a DHCP, racchiudere il valore stringa tra virgolette doppie. Ad esempio:
netsh interface ipv4>set address name="Wireless Network Connection" dhcp
In alternativa, per le interfacce di rete, è possibile usare il numero di indice al posto del nome associato. Ad esempio:
netsh interface ipv4>set address name=15 dhcp
Per trovare il nome o l'indice delle interfacce connesse, è necessario trovarsi nel sottocontesto dell'interfaccia IPv4 o IPv6 e digitare mostra interfacce. Ad esempio:
netsh interface ipv4>show interfaces
netsh interface ipv6>show interfaces