SetGateways-Methode der Win32_NetworkAdapterConfiguration-Klasse
Die SetGatewaysWMI-Klassenmethode gibt eine Liste von Gateways zum Weiterleiten von Paketen an ein Subnetz an, das sich von dem Subnetz unterscheidet, mit dem der Netzwerkadapter verbunden ist.
In diesem Thema wird MOF-Syntax (Managed Object Format) verwendet. Weitere Informationen zur Verwendung dieser Methode finden Sie unter Aufrufen einer Methode.
Syntax
uint32 SetGateways(
[in] string DefaultIPGateway[],
[in, optional] uint16 GatewayCostMetric[]
);
Parameter
-
DefaultIPGateway [in]
-
Liste der IP-Adressen für Gateways, für die Netzwerkpakete weitergeleitet werden.
-
GatewayCostMetric [in, optional]
-
Weist einen Wert zwischen 1 und 9999 zu, mit dem die schnellsten und zuverlässigsten Routen berechnet werden. Die Werte dieses Parameters entsprechen den Werten im DefaultIPGateway-Parameter . Der Standardwert für ein Gateway ist 1.
Rückgabewert
Gibt den Wert 0 (null) für einen erfolgreichen Abschluss zurück, wenn ein Neustart nicht erforderlich ist, 1 (1) für einen erfolgreichen Abschluss, wenn ein Neustart erforderlich ist, und einen beliebigen anderen Wert, wenn ein Fehler vorliegt. Weitere Informationen zu Fehlercodes finden Sie unter WMI-Fehlerkonstanten oder WbemErrorEnum. Allgemeine HRESULT-Werte finden Sie unter Systemfehlercodes.
-
Erfolgreicher Abschluss, kein Neustart erforderlich
-
0
-
Erfolgreicher Abschluss, Neustart erforderlich
-
1
-
Methode wird auf dieser Plattform nicht unterstützt
-
64
Die Methode wird nicht unterstützt, wenn sich die NIC im DHCP-Modus befindet.
-
Unbekannter Fehler
-
65
-
Ungültige Subnetzmaske
-
66
-
Fehler beim Verarbeiten einer zurückgegebenen Instanz
-
67
-
Ungültiger Eingabeparameter
-
68
-
Mehr als 5 Gateways angegeben
-
69
-
Ungültige IP-Adresse
-
70
-
Ungültige Gateway-IP-Adresse
-
71
-
Fehler beim Zugriff auf die Registrierung für die angeforderten Informationen
-
72
-
Ungültiger Domänenname
-
73
-
Ungültiger Hostname
-
74
-
Kein primärer/sekundärer WINS-Server definiert
-
75
-
Ungültige Datei
-
76
-
Ungültiger Systempfad
-
77
-
Fehler beim Kopieren der Datei
-
78
-
Ungültiger Sicherheitsparameter
-
79
-
Tcp/IP-Dienst kann nicht konfiguriert werden
-
80
-
Dhcp-Dienst kann nicht konfiguriert werden
-
81
-
DHCP-Lease kann nicht verlängert werden
-
82
-
DHCP-Lease kann nicht freigegeben werden
-
83
-
IP-Adresse auf adapter nicht aktiviert
-
84
-
IPX auf adapter nicht aktiviert
-
85
-
Frame-/Netzwerknummergrenzenfehler
-
86
-
Ungültiger Frametyp
-
87
-
Ungültige Netzwerknummer
-
88
-
Doppelte Netzwerknummer
-
89
-
Parameter außerhalb der Grenzen
-
90
-
Zugriff verweigert
-
91
-
Nicht genügend Arbeitsspeicher
-
92
-
Bereits vorhanden
-
93
-
Pfad, Datei oder Objekt nicht gefunden
-
94
-
Dienst kann nicht benachrichtigt werden
-
95
-
Benachrichtigung des DNS-Diensts nicht möglich
-
96
-
Schnittstelle nicht konfigurierbar
-
97
-
Nicht alle DHCP-Leases konnten freigegeben/erneuert werden.
-
98
-
DHCP für den Adapter nicht aktiviert
-
100
-
Andere
-
101 4294967295
Bemerkungen
Diese Methode funktioniert nur, wenn sich die Netzwerkschnittstellenkarte (Network Interface Card, NIC) im statischen IP-Modus befindet.
Um das Gateway zu löschen, legen Sie Ihr Gateway auf dieselbe IP-Adresse fest, die Sie für EnableStatic verwenden.
Beispiele
Im VBScript-Beispiel Ändern der Gateways für einen Netzwerkadapter werden zwei Gateways für einen Netzwerkadapter konfiguriert.
Im VBScript-Beispiel Zuweisen einer statischen IP-Adresse wird die IP-Adresse und das Gateway eines Computers festgelegt.
Die statische IP-Adresse und die anschließende Einbindung zu einer Domäne – PowerShell-Beispiel hilft bei der Neuerstellung von Computern.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
WindowsServer 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|