EnableStatic-Methode der Win32 _ NetworkAdapterConfiguration-Klasse
Die EnableStatic WMI-Klassenmethode aktiviert die statische TCP/IP-Adressierung für den Zielnetzwerkadapter. Daher ist DHCP für diesen Netzwerkadapter deaktiviert.
In diesem Thema wird Managed Object Format (MOF)-Syntax verwendet. Weitere Informationen zur Verwendung dieser Methode finden Sie unter Aufrufen einer Methode.
Syntax
uint32 EnableStatic(
[in] string IPAddress[],
[in] string SubnetMask[]
);
Parameter
-
IPAddress [ In]
-
Listet alle statischen IP-Adressen für den aktuellen Netzwerkadapter auf.
Beispiel: 155.34.22.0.
-
SubnetMask [ In]
-
Subnetzmasken, die die Werte im IPAddress-Parameter ergänzen.
Beispiel: 255.255.0.0.
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 eine beliebige andere Zahl, 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, kein Neustart erforderlich.
-
Erfolgreicher Abschluss, Neustart erforderlich
-
1
Erfolgreicher Abschluss, Neustart erforderlich.
-
Methode wird auf dieser Plattform nicht unterstützt
-
64
Methode wird auf dieser Plattform nicht unterstützt.
-
Unbekannter Fehler
-
65
Unbekannter Fehler.
-
Ungültige Subnetzmaske
-
66
Ungültige Subnetzmaske.
-
Fehler beim Verarbeiten einer instanz, die zurückgegeben wurde
-
67
Fehler beim Verarbeiten einer instanz, die zurückgegeben wurde.
-
Ungültiger Eingabeparameter
-
68
Ungültiger Eingabeparameter.
-
Mehr als fünf Gateways angegeben
-
69
Es wurden mehr als fünf Gateways angegeben.
-
Ungültige IP-Adresse
-
70
Ungültige IP-Adresse.
-
Ungültige Gateway-IP-Adresse
-
71
Ungültige Gateway-IP-Adresse.
-
Fehler beim Zugreifen auf die Registrierung für die angeforderten Informationen
-
72
Fehler beim Zugreifen auf die Registrierung für die angeforderten Informationen.
-
Ungültiger Domänenname
-
73
Ungültiger Domänenname.
-
Ungültiger Hostname
-
74
Ungültiger Hostname.
-
Kein primärer/sekundärer WINS-Server definiert
-
75
Kein primärer oder sekundärer WINS-Server definiert.
-
Ungültige Datei
-
76
Ungültige Datei.
-
Ungültiger Systempfad
-
77
Ungültiger Systempfad.
-
Fehler beim Kopieren der Datei
-
78
Fehler beim Kopieren der Datei.
-
Ungültiger Sicherheitsparameter
-
79
Ungültiger Sicherheitsparameter.
-
TCP/IP-Dienst kann nicht konfiguriert werden
-
80
Der TCP/IP-Dienst kann nicht konfiguriert werden.
-
DHCP-Dienst kann nicht konfiguriert werden
-
81
DHCP-Dienst kann nicht konfiguriert werden. Weitere Informationen finden Sie im Abschnitt "Hinweise".
-
DHCP-Lease kann nicht verlängert werden
-
82
DHCP-Lease kann nicht erneuert werden.
-
DHCP-Lease kann nicht veröffentlicht werden
-
83
DHCP-Lease kann nicht veröffentlicht werden.
-
IP-Adresse auf Adapter nicht aktiviert
-
84
DIE IP-Adresse ist auf dem Adapter nicht aktiviert.
-
IPX auf Adapter nicht aktiviert
-
85
IPX ist auf adapter nicht aktiviert.
-
Frame-/Netzwerknummer-Begrenzungsfehler
-
86
Frame- oder Netzwerknummer-Begrenzungsfehler.
-
Ungültiger Frametyp
-
87
Ungültiger Frametyp.
-
Ungültige Netzwerknummer
-
88
Ungültige Netzwerknummer.
-
Doppelte Netzwerknummer
-
89
Doppelte Netzwerknummer.
-
Parameter außerhalb der Grenzen
-
90
Parameter außerhalb der Grenzen.
-
Zugriff verweigert
-
91
Der Zugriff wurde verweigert.
-
Nicht genügend Arbeitsspeicher
-
92
Nicht genügend Arbeitsspeicher.
-
Bereits vorhanden
-
93
Ist bereits vorhanden.
-
Pfad, Datei oder Objekt nicht gefunden
-
94
Pfad, Datei oder Objekt nicht gefunden.
-
Dienst kann nicht benachrichtigt werden
-
95
Der Dienst kann nicht benachrichtigt werden.
-
DNS-Dienst kann nicht benachrichtigt werden
-
96
Der DNS-Dienst kann nicht benachrichtigt werden.
-
Schnittstelle nicht konfigurierbar
-
97
Die Schnittstelle kann nicht konfiguriert werden.
-
Nicht alle DHCP-Leases konnten freigegeben/erneuert werden.
-
98
Nicht alle DHCP-Leases können freigegeben oder erneuert werden.
-
DHCP für Adapter nicht aktiviert
-
100
DHCP für Adapter nicht aktiviert.
-
2147786788
-
Schreibsperre nicht aktiviert. Weitere Informationen finden Sie unter INetCfgLock::AcquireWriteLock.
-
Andere
-
101 4294967295
Hinweise
Wenn Sie EnableStatic verwenden, um die IP-Adresse des Remotecomputers zu ändern, während sie über diesen Adapter verbunden ist, verlieren Sie wahrscheinlich die Verbindung mit dem Remotecomputer und erhalten eine RPC-Fehlermeldung, die nicht verfügbar ist. (Die Einstellungen werden jedoch geändert.) Um dieses Szenario zu vermeiden, sollten Sie die Gateway- und/oder DNS-Einstellungen ändern, bevor Sie die IP-Adresse des Adapters festlegen.
Wenn Sie EnableStatic verwenden, um einem Adapter eine statische IP-Konfiguration zu geben, gibt die Funktion "81 – DHCP-Dienst kann nicht konfiguriert werden" zurück, wenn der Adapter bereits mit einer statischen Adresse konfiguriert ist. Die Funktion kann jedoch weiterhin mit dem neuen Vorgang festgelegt werden.
Beispiele
Die statische IP-Adresse und anschließende Verknüpfung mit einer PowerShell-Domäne im TechNet-Katalog verwendet EnableStatic, um einem lokalen Computer eine statische IP-Adresse hinzuzufügen.
Im VbScript-Codebeispiel Zuweisen einer statischen IP-Adresse im TechNet-Katalog wird EnableStatic verwendet, um die IP-Adresse eines Computers festzulegen.
Im folgenden VBScript-Beispiel wird veranschaulicht, wie die DHCP-Verwendung für eine Instanz von Win32 _ NetworkAdapterConfigurationdeaktiviert wird. In diesem Fall geben wir den Adapter mit dem Index 0 an. Der richtige Index sollte aus Win32 _ NetworkAdapter-Instanzen für andere Schnittstellen ausgewählt werden.
Hinweis
Dieses Skript gilt nur für NT-basierte Systeme Ändern Sie die unten aufgeführten ipaddr- und Subnetzvariablen in die Werte, die Sie auf den Adapter anwenden möchten.
Set Adapter = GetObject("winmgmts:Win32_NetworkAdapterConfiguration=1")
ipaddr = Array("1.1.1.1")
subnet = Array("255.255.255.0")
RetVal = Adapter.EnableStatic(ipaddr,subnet)
if RetVal = 0 then
WScript.Echo "DHCP disabled, using static IP address"
else
WScript.Echo "DHCP disable failed"
end if
Im folgenden Perl-Beispiel wird veranschaulicht, wie die DHCP-Verwendung für eine Instanz von Win32 _ NetworkAdapterConfigurationdeaktiviert wird. In diesem Fall geben wir den Adapter mit dem Index 0 an. Der richtige Index sollte aus Win32 _ NetworkAdapter-Instanzen für andere Schnittstellen ausgewählt werden.
Hinweis
Dieses Skript gilt nur für NT-basierte Systeme Ändern Sie die unten aufgeführten ipaddr- und Subnetzvariablen in die Werte, die Sie auf den Adapter anwenden möchten.
use strict;
use Win32::OLE;
my ($Adapter, @ipaddr, @subnet, $RetVal);
eval { $Adapter =
Win32::OLE->GetObject("winmgmts:{impersonationLevel=impersonate}!\\\\.\\root\\cimv2:Win32_NetworkAdapterConfiguration.Index=\"0\""); };
unless ($@)
{
push @ipaddr, "192.168.144.107";
push @subnet, "255.255.255.0";
$RetVal = $Adapter->EnableStatic(\@ipaddr, \@subnet);
if ($RetVal == 0)
{
print "\nDHCP disabled, using static IP address\n";
}
else
{
print "\nDHCP disable failed\n";
}
}
else
{
print STDERR "\n", Win32::OLE->LastError, "\n";
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Namespace |
Stamm \ CIMV2 |
| MOF |
|
| DLL |
|