Netsh (Übersicht)

Netsh ist ein Befehlszeilen-Skriptingprogramm, mit dem Sie lokal oder remote die Netzwerkkonfiguration eines aktiven Computers anzeigen oder ändern können. Netsh stellt außerdem eine Skriptingfunktion zur Verfügung, mit der eine Gruppe von Befehlen im Stapelverarbeitungsmodus auf einem ausgewählten Computer ausgeführt werden kann. Mit Netsh kann darüber hinaus ein Konfigurationsskript in einer Textdatei gespeichert werden, um die Konfiguration zu archivieren oder um mit ihrer Hilfe weitere Server zu konfigurieren.

Netsh-Kontexte

Netsh arbeitet über DLL-Dateien (Dynamic Link Library) mit anderen Betriebssystemkomponenten zusammen. Jede Netsh-Hilfsprogramm-DLL verfügt über einen umfangreichen Funktionssatz, den so genannten Kontext, d. h. eine Gruppe von spezifischen Befehlen für eine Netzwerkkomponente. Diese Kontexte erweitern die Funktionalität von netsh, indem sie Unterstützung für die Konfiguration und Überwachung einzelner oder mehrerer Dienste, Dienstprogramme oder Protokolle zur Verfügung stellen. Die Datei Dhcpmon.dll stellt für netsh z. B. den Kontext und die Befehlsgruppe zum Konfigurieren und Verwalten von DHCP-Servern zur Verfügung.

Um einen netsh-Befehl auszuführen, müssen Sie netsh an der Eingabeaufforderung von Cmd.exe starten und zu dem Kontext mit dem Befehl wechseln, den Sie verwenden möchten. Welche Kontexte zur Verfügung stehen, ist davon abhängig, welche Netzwerkkomponenten Sie installiert haben. Wenn Sie z. B. dhcp an der Netsh-Eingabeaufforderung eingeben, um zum DHCP-Kontext zu wechseln, DHCP aber nicht installiert ist, wird folgende Meldung angezeigt:

Der folgende Befehl wurde nicht gefunden: dhcp.

Weitere Informationen zu Netsh-Kontexten finden Sie in den folgenden Themen:

Hinweis

„Gemeinsame Nutzung der Internetverbindung“ und „Netzwerkbrücke“ sind in Windows Server 2003 Web Edition, Windows Server 2003 Datacenter Edition und den Itanium-basierten Versionen der ursprünglichen Version der Betriebssysteme der Windows Server 2003-Produktfamilie nicht enthalten.

Verwenden mehrerer Kontexte

Ein Kontext kann andere Kontexte enthalten. Innerhalb des Routingkontextes können Sie z. B. zu den Unterkontexten IP und IPX wechseln.

Um eine Liste der in einem Kontext verwendbaren Befehle und Unterkontexte anzuzeigen, geben Sie an der Eingabeaufforderung von netsh den Kontextnamen und dann entweder /? oder help ein. Geben Sie z. B. einen der folgenden Befehle an der Eingabeaufforderung von netsh (angezeigt als netsh>) ein, um eine Liste der im Routingkontext verwendbaren Unterkontexte und Befehle anzuzeigen:

routing /?

routing help

Um Tasks in einem anderen Kontext auszuführen, ohne den aktuellen Kontext zu wechseln, müssen Sie an der Eingabeaufforderung von netsh den Kontextpfad des gewünschten Befehls eingeben. Geben Sie an der Eingabeaufforderung von netsh z. B. folgenden Befehl ein, um die Schnittstelle für die LAN-Verbindung im IGMP-Kontext hinzuzufügen, ohne zum IGMP-Kontext zu wechseln:

routing ip igmp add interface "LAN-Verbindung" startupqueryinterval=21

Ausführen von Netsh-Befehlen an der Eingabeaufforderung von Cmd.exe

Wenn Sie netsh an der Eingabeaufforderung von Cmd.exe ausführen, besitzt netsh die im Folgenden beschriebene Syntax. Um diese Befehle auf einem Remotecomputer unter Windows 2000 Server auszuführen, müssen Sie zunächst mit Remotedesktopverbindung eine Verbindung zu einem Computer unter Windows 2000 Server herstellen, auf dem Terminaldienste ausgeführt wird. Die Netsh-Kontextbefehle unter Betriebssystemen der Windows Server 2003-Produktfamilie können eine andere Funktionalität aufweisen als unter Windows 2000.

Im folgenden Abschnitt wird der Befehl netsh beschrieben:

netsh

Netsh ist ein Befehlszeilen-Skriptingprogramm, mit dem Sie, entweder lokal oder remote, die Netzwerkkonfiguration eines aktiven Computers anzeigen oder ändern können. Wenn keine Parameter angegeben werden, öffnet netsh die Eingabeaufforderung von Netsh.exe (angezeigt alsnetsh>).

Syntax

netsh[-aAliasdatei] [-cKontext] [-rRemotecomputer] [{Netsh-Befehl | -fSkriptdatei}]

Parameter

-a: Kehrt nach der Ausführung von Aliasdatei zur Eingabeaufforderung von netsh zurück.

Aliasdatei: Gibt den Namen der Textdatei an, die mindestens einen netsh-Befehl enthält.

-c: Wechselt zum angegebenen netsh-Kontext.

Kontext

Gibt den netsh-Kontext an. In der folgenden Tabelle werden die verfügbaren netsh-Kontexte aufgelistet:

Kontext	Beschreibung
Netsh-Befehle für AAAA	In diesem Kontext kann die Konfiguration der AAAA-Datenbank (Authentication, Authorization, Accounting, and Auditing), die vom Internetauthentifizierungsdienst (IAS) und vom Routing- und RAS-Dienst verwendet wird, angezeigt und festgelegt werden.
"Netsh"-Befehle für DHCP	Verwaltet DHCP-Server und bildet eine gleichwertige Alternative zur konsolenbasierten Verwaltung.
"Netsh"-Diagnosebefehle (diag-Befehle)	Dient zur Verwaltung und Problembehandlung von Betriebssystem- und Netzwerkdienstparametern.
Netsh-Befehle für Schnittstellen-IP	Konfiguriert das TCP/IP-Protokoll (einschließlich Adressen, Standardgateways, DNS-Server und WINS-Server) und zeigt Konfigurations- und Statistikdaten an.
Netsh-Befehle für die IPv6-Schnittstelle	Dient zum Abfragen und Konfigurieren von IPv6-Schnittstellen, -Adressen, -Caches und -Routen.
Netsh-Befehle für Schnittstellen-Portproxy	Verwaltet Server, die als Proxys zwischen IPv4- und IPv6-Netzwerken und -Anwendungen dienen.
Netsh-Befehle für die IPv6-Schnittstelle	Bietet eine gleichwertige Alternative zu den konsolenbasierten Verwaltungs- und Diagnosefunktionen der Snap-Ins IP-Sicherheitsrichtlinienverwaltung und IP-Sicherheitsmonitor, die in der Microsoft Management Console (MMC) verfügbar sind. Mithilfe der Netsh-Befehle für IPSec können Sie statische oder dynamische Hauptmoduseinstellungen, Schnellmoduseinstellungen, Regeln und Konfigurationsparameter von IPSec konfigurieren und anzeigen.
Netsh-Befehle für Netzwerkbrücke	Aktiviert oder deaktiviert den Schicht-3-Kompatiblitätsmodus und zeigt Konfigurationsinformationen für die Netzwerkbrückenadapter an.
Netsh-Befehle für den Remote Access (RAS)	Verwaltet RAS-Server.
Netsh-Befehle für das Routing	Verwaltet Routingserver.
Netsh-Befehle für RPC	Dient zum Ändern, Zurücksetzen oder Anzeigen ausgewählter Systembindungseinstellungen.
Netsh-Befehle für WINS	Verwaltet WINS-Server.

-r: Konfiguriert einen Remotecomputer.

Remotecomputer: Gibt den zu konfigurierenden Remotecomputer an.

Netsh-Befehl: Gibt den netsh-Befehl an, den Sie ausführen möchten.

-f: Beendet Netsh.exe, nachdem das Skript ausgeführt wurde.

Skriptdatei: Gibt das auszuführende Skript an.

/?: Zeigt Hilfe an der Eingabeaufforderung an.

Hinweise

Wenn Sie -r gefolgt von einem anderen Befehl angeben, führt netsh den Befehl auf dem Remotecomputer aus und kehrt dann zur Eingabeaufforderung von Cmd.exe zurück. Wenn Sie -r ohne einen anderen Befehl angeben, wird netsh im Remotemodus geöffnet. Der Vorgang ist ähnlich wie bei Eingabe des Befehls set machine an der Eingabeaufforderung von netsh. Mit -r legen Sie nur den Zielcomputer für die aktuelle Instanz von netsh fest. Wenn Sie netsh beenden und netsh erneut eingeben, ist wieder der lokale Computer als Zielcomputer festgelegt. Sie können netsh-Befehle auf einem Remotecomputer ausführen, indem Sie einen in WINS gespeicherten Computernamen, einen UNC-Namen, einen vom DNS-Server aufzulösenden Internetnamen oder eine IP-Adresse angeben.

Ausführen von Netsh-Befehlen an der Eingabeaufforderung von Netsh.exe

Netsh verwendet die folgenden Standardbefehle in allen Kontexten, die Sie an einer Eingabeaufforderung von Netsh.exe (angezeigt als netsh>) ausführen können. Um diese Netsh-Befehle auf einem Remotecomputer unter Windows 2000 Server auszuführen, müssen Sie zunächst mit Remotedesktopverbindung eine Verbindung zu einem Computer unter Windows 2000 Server herstellen, auf dem Terminalserver ausgeführt wird. Die Netsh-Kontextbefehle unter Betriebssystemen der Windows Server 2003-Produktfamilie können eine andere Funktionalität aufweisen als unter Windows 2000.

Klicken Sie auf einen Befehl, um dessen Syntax anzuzeigen.

..
abort
add helper
alias
bye
commit
delete helper
dump
exec
exit
help
offline
online
popd
pushd
quit
set file
set machine
set mode
show
unalias

..

Wechselt zum Kontext auf der nächsthöheren Ebene.

Syntax

Parameter

/?: Zeigt Hilfe an der Eingabeaufforderung an.

abort

Verwirft die im Offlinemodus durchgeführten Änderungen. Abort hat im Onlinemodus keine Auswirkungen.

Syntax

abort

Parameter

/?: Zeigt Hilfe an der Eingabeaufforderung an.

add helper

Installiert die Hilfsprogramm-DLL in netsh.

Syntax

add helperDLL-Name

Parameter

DLL-Name: Erforderlich. Gibt den Namen der Hilfsprogramm-DLL an, die Sie installieren möchten.

/?: Zeigt Hilfe an der Eingabeaufforderung an.

alias

Fügt einen Alias hinzu. Dabei handelt es sich um eine benutzerdefinierte Zeichenfolge, die von netsh wie eine andere Zeichenfolge behandelt wird. Wenn keine Parameter angegeben werden, zeigt alias alle verfügbaren Aliase an.

Syntax

alias[Aliasname] [Zeichenfolge1 [Zeichenfolge2 ...]]

Parameter

alias [Aliasname]: Zeigt den angegebenen Alias an.

alias[Aliasname] [Zeichenfolge1 [Zeichenfolge2...]]: Legt die angegebenen Zeichenfolgen als Aliasname fest.

/?: Zeigt Hilfe an der Eingabeaufforderung an.

Beispiele

Das folgende netsh-Beispielskript legt zwei netsh-Aliase, Shaddr und Shp, fest und verlässt dann die Eingabeaufforderung von netsh im Schnittstellen-IP-Kontext (interface ip):

alias shaddr show interface ip addr

alias shp show helpers

interface ip

Wenn Sie shaddr an der Eingabeaufforderung von Netsh eingeben, interpretiert Netsh.exe dies als Befehl show interface ip addr. Wenn Sie shp an der Eingabeaufforderung von Netsh eingeben, interpretiert Netsh.exe dies als Befehl show helpers.

bye

Beendet Netsh.exe.

Syntax

bye

Parameter

/?: Zeigt Hilfe an der Eingabeaufforderung an.

commit

Leitet alle im Offlinemodus durchgeführten Änderungen an den Router weiter. Commit hat im Onlinemodus keine Auswirkungen.

Syntax

commit

Parameter

/?: Zeigt Hilfe an der Eingabeaufforderung an.

delete helper

Entfernt die Hilfsprogramm-DLL aus netsh.

Syntax

delete helperDLL-Name

Parameter

DLL-Name: Erforderlich. Gibt den Namen der Hilfsprogramm-DLL an, die Sie deinstallieren möchten.

/?: Zeigt Hilfe an der Eingabeaufforderung an.

dump

Erstellt ein Skript mit der aktuellen Konfiguration. Wenn Sie dieses Skript in einer Datei speichern, können Sie geänderte Konfigurationseinstellungen mithilfe der Datei wiederherstellen. Wenn Sie dump ohne Parameter angeben, werden alle Kontextkonfigurationen von netsh angezeigt.

Syntax

dump [Dateiname]

Parameter

[ Dateiname]: Gibt den Namen der Datei an, in die Ausgaben umgeleitet werden sollen.

/?: Zeigt Hilfe an der Eingabeaufforderung an.

exec

Lädt eine Skriptdatei und führt die darin enthaltenen Befehle aus.

Syntax

execSkriptdatei

Parameter

Skriptdatei: Erforderlich. Gibt den Namen des Skripts an, das geladen und ausgeführt werden soll.

Hinweise

Die mit Skriptdatei angegebene Datei kann auf einem oder mehreren Computern ausgeführt werden.

exit

Beendet Netsh.exe.

Syntax

exit

Parameter

/?: Zeigt Hilfe an der Eingabeaufforderung an.

help

Zeigt die Hilfe an.

Syntax

{/? | ? | help | h}

Parameter

Keine

offline

Legt den aktuellen Modus auf offline fest.

Syntax

offline

Parameter

/?: Zeigt Hilfe an der Eingabeaufforderung an.

Hinweise

Änderungen, die Sie in diesem Modus ausführen, werden zwar gespeichert, Sie müssen jedoch den Befehl commit oder online ausführen, damit die Änderungen im Router festgelegt werden.
Wenn Sie vom Offlinemodus in den Onlinemodus wechseln, werden die im Offlinemodus ausgeführten Änderungen in die gerade aktive Konfiguration übernommen.
Änderungen, die Sie im Onlinemodus ausführen, werden sofort in die gerade aktive Konfiguration übernommen.

online

Legt den aktuellen Modus auf online fest.

Syntax

online

Parameter

/?: Zeigt Hilfe an der Eingabeaufforderung an.

Hinweise

Änderungen, die Sie im Onlinemodus ausführen, werden sofort in die gerade aktive Konfiguration übernommen.
Wenn Sie vom Offlinemodus in den Onlinemodus wechseln, werden die im Offlinemodus ausgeführten Änderungen in die gerade aktive Konfiguration übernommen.

popd

Stellt einen Kontext aus dem Stapel wieder her.

Syntax

popd

Parameter

/?: Zeigt Hilfe an der Eingabeaufforderung an.

Hinweise

Wenn Sie popd in Verbindung mit pushd verwenden, können Sie den Kontext wechseln, den Befehl im neuen Kontext ausführen und dann den vorherigen Kontext wiederherstellen.

Beispiele

Das folgende Beispielskript führt einen Wechsel vom Stammkontext zum Kontext interface ip durch, fügt eine statische IP-Route hinzu und kehrt dann zum Stammkontext zurück:

netsh>pushd

netsh>interface ip

netsh interface ip>set address local static 10.0.0.9 255.0.0.0 10.0.0.1 1

netsh interface ip>popd

netsh>

pushd

Speichert den aktuellen Kontext in einem FILO-Stapel (First-In-Last-Out).

Syntax

pushd

Parameter

/?: Zeigt Hilfe an der Eingabeaufforderung an.

Hinweise

Wenn Sie pushd in Verbindung mit popd verwenden, können Sie den Kontext wechseln, den Befehl im neuen Kontext ausführen und dann den vorherigen Kontext wiederherstellen.

quit

Beendet Netsh.exe.

Syntax

quit

Parameter

/?: Zeigt Hilfe an der Eingabeaufforderung an.

set file

Kopiert die Ausgabe im Eingabeaufforderungsfenster in eine Datei.

Syntax

set file {openDateiname | appendDateiname | close}

Parameter

openDateiname: Sendet die Ausgabe im Eingabeaufforderungsfenster an die angegebene Datei.

appendDateiname: Hängt die Ausgabe im Eingabeaufforderungsfenster an die angegebene, vorhandene Datei an.

close: Stoppt das Senden der Ausgabe und schließt eine Datei.

/?: Zeigt Hilfe an der Eingabeaufforderung an.

Hinweise

Wenn eine Datei mit dem angegebenen Namen Dateiname noch nicht vorhanden ist, erstellt netsh eine neue Datei mit diesem Namen. Wenn eine Datei namens Dateiname bereits vorhanden ist, überschreibt netsh die vorhandenen Daten.

Beispiele

Geben Sie Folgendes ein, um eine neue Protokolldatei mit dem Namen Sitzung.log zu erstellen und alle nachfolgenden Ein- und Ausgaben von netsh in diese Datei zu kopieren:

set file open c:\Sitzung.log

set machine

Legt den aktuellen Computer fest, auf dem Konfigurationsaufgaben ausgeführt werden. Wenn keine Parameter angegeben werden, legt set machine den lokalen Computer fest.

Syntax

set machine [[Computername=]Zeichenfolge]

Parameter

Computername: Gibt den Namen des Computers an, auf dem Konfigurationsaufgaben ausgeführt werden.

Zeichenfolge: Gibt den Standort des Remotecomputers an.

/?: Zeigt Hilfe an der Eingabeaufforderung an.

Hinweise

Sie können in einem einzigen Skript Befehle auf mehreren Computern ausführen. Mit dem Befehl set machine können Sie in einem Skript einen Zielcomputer (z. B. Computer A) angeben und dann auf diesem Computer die Befehle ausführen, die im Anschluss an set machine angegeben wurden. Anschließend können Sie mit set machine einen anderen Zielcomputer (z. B. Computer B) angeben und dann auf diesem Computer Befehle ausführen.

set mode

Wechselt vom aktuellen Modus in den Online- oder Offlinemodus.

Syntax

set mode {online | offline}

Parameter

online: Legt den aktuellen Modus auf online fest.

offline: Legt den aktuellen Modus auf offline fest.

/?: Zeigt Hilfe an der Eingabeaufforderung an.

show

Zeigt Informationen zum Alias, Hilfsprogramm und Modus an.

Syntax

show {alias | helper | mode}

Parameter

alias: Listet alle definierten Aliase auf.

helper: Listet alle Hilfsprogramme der höchsten Ebene auf.

mode: Zeigt den aktuellen Modus an.

/?: Zeigt Hilfe an der Eingabeaufforderung an.

unalias

Löscht den angegebenen Alias.

Syntax

unaliasAliasname

Parameter

Aliasname: Erforderlich. Gibt den Namen des Alias an.

/?: Zeigt Hilfe an der Eingabeaufforderung an.

Formatierungslegende

Format	Bedeutung
Kursiv	Informationen, die der Benutzer bereitstellen muss
Fett	Elemente, die der Benutzer genau so wie dargestellt eingeben muss
Auslassungspunkte (...)	Parameter, die mehrmals in einer Befehlszeile wiederholt werden können
Zwischen eckigen Klammern ([])	Optionale Elemente
Zwischen geschweiften Klammern ({}); Optionen durch Verkettungszeichen (\|) voneinander getrennt. Beispiel: {gerade\|ungerade}	Eine Gruppe von Auswahlmöglichkeiten, aus denen der Benutzer eine Option auswählen muss.
`Schriftart Courier`	Code oder Programmausgabe