Udostępnij za pośrednictwem


Składnia poleceń netsh, konteksty i formatowanie

Korzystając z tego artykułu, dowiesz się, jak wprowadzać konteksty netsh i podteksty, zrozumieć składnię netsh i formatowanie poleceń oraz jak uruchamiać polecenia netsh na komputerach lokalnych i zdalnych.

Netsh to narzędzie do obsługi skryptów wiersza polecenia, które umożliwia wyświetlanie lub modyfikowanie konfiguracji sieciowej komputera, który jest aktualnie uruchomiony. Polecenia netsh można uruchamiać, wpisując polecenia w powłoce netsh i używane w plikach wsadowych lub skryptach. Komputery zdalne i komputer lokalny można skonfigurować za pomocą poleceń netsh.

Netsh udostępnia również funkcję skryptów, która umożliwia uruchamianie grupy poleceń w trybie wsadowym na określonym komputerze. Za pomocą narzędzia netsh można zapisać skrypt konfiguracji w pliku tekstowym w celach archiwalnych lub ułatwić konfigurowanie innych komputerów.

Składnia

netsh
netsh [-a AliasFile] [-c Context] [-r RemoteMachine] [-u [DomainName\]UserName] [-p Password | *] [Command | -f ScriptFile]

Poniższe parametry są uznawane za opcjonalne.

Parametr Opis
-a Określa, że po uruchomieniu AliasFilezostaniesz zwrócony do powłoki netsh.
AliasFile Określa nazwę pliku tekstowego zawierającego jedno lub więcej poleceń netsh.
-c Określa, że netsh wchodzi w określony kontekst netsh.
Context Określa kontekst netsh, który chcesz wprowadzić.
-r Określa, że polecenie ma być uruchamiane na komputerze zdalnym. Usługa rejestru zdalnego musi być uruchomiona na komputerze zdalnym. Jeśli nie jest uruchomiony, system Windows wyświetli komunikat o błędzie "Nie znaleziono ścieżki sieciowej".
RemoteComputer Określa komputer zdalny, który chcesz skonfigurować.
-u Określa, że chcesz uruchomić polecenie netsh używając konta użytkownika.
DomainName\ Określa domenę, w której znajduje się konto użytkownika. Wartość domyślna to domena lokalna, jeśli nie określono DomainName\.
UserName Określa nazwę konta użytkownika.
-p Określa, że chcesz podać hasło dla konta użytkownika.
Password Określa hasło dla konta użytkownika, które określiłeś przy użyciu -uUserName.
Command Określa polecenie netsh, które chcesz uruchomić.
-f Zamyka netsh po uruchomieniu skryptu określonego przez ScriptFile.
ScriptFile Określa skrypt, który chcesz uruchomić.

Notatka

Jeśli określisz -r, po którym następuje inne polecenie, netsh uruchomi polecenie na komputerze zdalnym, a następnie powróci do wiersza polecenia. Jeśli określisz -r bez innego polecenia, netsh otworzy się w trybie zdalnym. Proces jest podobny do użycia komendy ustawiającej maszynę w powłoce netsh. Kiedy używasz -r, ustawiasz komputer docelowy tylko dla bieżącej instancji netsh. Po wyjściu i ponownym wejściu do netshdocelowy komputer zostanie zresetowany do ustawień komputera lokalnego. Można uruchomić netsh polecenia na komputerze zdalnym, określając nazwę komputera przechowywanego w usłudze WINS, nazwę UNC, nazwę internetową do rozpoznania przez serwer DNS lub adres IP.

Uruchamianie poleceń netsh

Aby uruchomić polecenie netsh, musisz uruchomić netsh z wiersza polecenia lub programu PowerShell, wpisując netsh, a następnie naciskając ENTER. Następnie możesz zmienić kontekst zawierający polecenie, którego chcesz użyć. Dostępne konteksty zależą od zainstalowanych składników sieciowych.

Jeśli na przykład wpiszesz dhcp w powłoce netsh i naciśniesz ENTER, netsh przełączy się do trybu serwera DHCP. Jeśli nie masz zainstalowanej roli serwera DHCP, zostanie wyświetlony następujący komunikat:

The following command was not found: dhcp.

Konteksty netsh

Platforma Netsh współdziała z innymi składnikami systemu operacyjnego przy użyciu plików biblioteki dll (dynamic-link).

Każda biblioteka DLL pomocnika netsh udostępnia obszerny zestaw funkcji nazywanych kontekstem , który jest grupą poleceń specyficznych dla roli lub funkcji serwera sieciowego. Te konteksty rozszerzają funkcjonalność netsh, zapewniając obsługę konfiguracji i monitorowania dla co najmniej jednej usługi, narzędzi lub protokołów.

Na przykład Dhcpmon.dll udostępnia netsh kontekst i zestaw poleceń niezbędnych do konfigurowania serwerów DHCP i zarządzania nimi.

Listę kontekstów netsh można uzyskać, otwierając wiersz polecenia lub program Windows PowerShell, a następnie wpisz netsh /? lub netsh help i naciśnij ENTER.

Przykładowe dane wyjściowe są następujące:

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 ?.

Podkonteksty netsh

Konteksty netsh mogą zawierać polecenia i dodatkowe konteksty nazywane podkontekstami. Na przykład w kontekście interfejsu , można przełączyć się na podkonteksty IPv4 i IPv6.

Aby wyświetlić listę poleceń i subkontekstów, których można użyć w danym kontekście, w powłoce netsh wpisz nazwę subkontekstu, a następnie wpisz albo ? lub pomoc. Na przykład:

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 ?.

Aby wykonywać zadania w innym kontekście bez zmiany z bieżącego kontekstu, wpisz ścieżkę kontekstu polecenia, którego chcesz użyć w konsoli netsh. Aby na przykład dodać statyczny adres IPv4 dla "NetLAN1" i określić maskę podsieci i bramę, wpisz:

netsh interface ipv4 set address "NetLAN1" static <IP_Address> <Subnet_Mask> <Gateway>

Legenda formatowania

Możesz użyć następującej legendy formatowania, aby interpretować i używać poprawnej składni polecenia netsh podczas uruchamiania polecenia w powłoce netsh, w pliku wsadowym lub w skrypcie.

  • Tekst kursywą w to informacja, którą należy podać podczas wpisywania polecenia. Jeśli na przykład polecenie ma parametr o nazwie -UserName, musisz wpisać rzeczywistą nazwę użytkownika.
  • Tekst w pogrubioną to informacje, które należy wpisać dokładnie tak, jak pokazano podczas wpisywania polecenia.
  • Tekst, po którym następuje wielokropek (...) to parametr, który można powtórzyć kilka razy w wierszu polecenia.
  • Tekst, który znajduje się między nawiasami kwadratowymi [ ] jest elementem opcjonalnym.
  • Tekst między nawiasami klamrowymi { } z opcjami rozdzielonymi pionową kreską zawiera zestaw opcji, z których należy wybrać tylko jedną, na przykład {enable|disable}.
  • Tekst sformatowany za pomocą czcionki Courier to kod lub dane wyjściowe programu.

Wartości ciągów dla poleceń netsh

Istnieją polecenia zawierające parametry, dla których wymagana jest wartość ciągu. W przypadku, gdy wartość ciągu zawiera spacje między znakami, musisz ująć wartość ciągu w znaki podwójnego cudzysłowu.

Podczas ustawiania parametru interfejsu dla sieci IPv4 z wartością ciągu Połączenia bezprzewodowego dhcp, użyj podwójnych cudzysłowów wokół wartości ciągu. Na przykład:

netsh interface ipv4>set address name="Wireless Network Connection" dhcp

Alternatywnie w przypadku interfejsów sieciowych numer indeksu może być używany zamiast skojarzonej z nią nazwy. Na przykład:

netsh interface ipv4>set address name=15 dhcp

Aby znaleźć nazwę lub indeks połączonych interfejsów, musisz znajdować się w podtekstu interfejsu IPv4 lub IPv6 i wpisać pokazać interfejsy. Na przykład:

netsh interface ipv4>show interfaces
netsh interface ipv6>show interfaces

Zobacz też