SetGateways-Methode der Win32 _ NetworkAdapterConfiguration-Klasse

Die WMI-Klassenmethode SetGateways gibt eine Liste von Gateways zum Weiterleiten von Paketen an ein Subnetz an, das sich von dem Subnetz, mit dem der Netzwerkadapter verbunden ist, unterscheiden kann.

In diesem Thema wird Managed Object Format (MOF)-Syntax 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 zu Gateways, an die Netzwerkpakete geroutet werden.

GatewayCostMetric [ in, optional]

Weist einen Wert zwischen 1 und 9999 zu, der zum Berechnen der schnellsten und zuverlässigsten Routen verwendet wird. 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 kein Neustart erforderlich ist, 1 (eins) für einen erfolgreichen Abschluss, wenn ein Neustart erforderlich ist, und jeden anderen Wert, wenn ein Fehler auftritt. Weitere Informationen zu Fehlercodes finden Sie unter WMI-Fehlerkonstistenzen 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 instanz, die zurückgegeben wurde

67

Ungültiger Eingabeparameter

68

Mehr als fünf Gateways angegeben

69

Ungültige IP-Adresse

70

Ungültige Gateway-IP-Adresse

71

Fehler beim Zugreifen 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 veröffentlicht werden

83

IP-Adresse auf Adapter nicht aktiviert

84

IPX auf Adapter nicht aktiviert

85

Frame-/Netzwerknummer-Begrenzungsfehler

86

Ungültiger Frametyp

87

Ungültige Netzwerknummer

88

Doppelte Netzwerknummer

89

Parameter über grenzenlose 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

DNS-Dienst kann nicht benachrichtigt werden

96

Schnittstelle nicht konfigurierbar

97

Nicht alle DHCP-Leases konnten freigegeben/erneuert werden.

98

DHCP auf Adapter nicht aktiviert

100

Andere

101 4294967295

Bemerkungen

Diese Methode funktioniert nur, wenn sich die Netzwerkschnittstellenkarte (NIC) im statischen IP-Modus befindet.

Um das Gateway zu löschen, legen Sie ihr Gateway auf die gleiche 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 werden die IP-Adresse und das Gateway eines Computers bestimmt.

Das PowerShell-Beispiel statische IP und anschließender Beitritt zu einer Domäne hilft bei der Neuerstellung von Computern.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista
Unterstützte Mindestversion (Server)
Windows Server 2008
Namespace
\Stamm-CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Weitere Informationen

Hardwareklassen des Computersystems

Win32 _ NetworkAdapterConfiguration

WMI-Aufgaben: Netzwerk

WMI-Aufgaben: Konten und Domänen

IPv6- und IPv4-Unterstützung in WMI