EnableStatic-Methode der Win32_NetworkAdapterConfiguration-Klasse
Die WMI-KlassenmethodeEnableStatic ermöglicht die statische TCP/IP-Adressierung für den Zielnetzwerkadapter. Daher ist DHCP für diesen Netzwerkadapter deaktiviert.
In diesem Thema wird MOF-Syntax (Managed Object Format) 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 ein Neustart nicht erforderlich ist, 1 (1) für einen erfolgreichen Abschluss, wenn ein Neustart erforderlich ist, und eine andere Zahl, 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, kein Neustart erforderlich.
-
Erfolgreicher Abschluss, Neustart erforderlich
-
1
Erfolgreicher Abschluss, Neustart erforderlich.
-
Methode wird auf dieser Plattform nicht unterstützt
-
64
Die Methode wird auf dieser Plattform nicht unterstützt.
-
Unbekannter Fehler
-
65
Unbekannter Fehler.
-
Ungültige Subnetzmaske
-
66
Ungültige Subnetzmaske.
-
Fehler beim Verarbeiten einer zurückgegebenen Instanz
-
67
Fehler beim Verarbeiten eines zurückgegebenen instance.
-
Ungültiger Eingabeparameter
-
68
Ungültiger Eingabeparameter.
-
Mehr als 5 Gateways angegeben
-
69
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 Zugriff auf die Registrierung für die angeforderten Informationen
-
72
Fehler beim Zugriff 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
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 mit Hinweisen.
-
DHCP-Lease kann nicht verlängert werden
-
82
DHCP-Lease kann nicht verlängert werden.
-
DHCP-Lease kann nicht freigegeben werden
-
83
DHCP-Lease kann nicht freigegeben werden.
-
IP-Adresse auf adapter nicht aktiviert
-
84
DIE IP-Adresse ist für den Adapter nicht aktiviert.
-
IPX auf adapter nicht aktiviert
-
85
IPX ist für den Adapter nicht aktiviert.
-
Frame-/Netzwerknummergrenzenfehler
-
86
Frame- oder Netzwerknummerngrenzenfehler.
-
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
Zugriff 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
Dienst kann nicht benachrichtigt werden.
-
Benachrichtigung des DNS-Diensts nicht möglich
-
96
Der DNS-Dienst kann nicht benachrichtigt werden.
-
Schnittstelle nicht konfigurierbar
-
97
Schnittstelle nicht konfigurierbar.
-
Nicht alle DHCP-Leases konnten freigegeben/erneuert werden.
-
98
Nicht alle DHCP-Leases konnten freigegeben oder erneuert werden.
-
DHCP für den Adapter nicht aktiviert
-
100
DHCP ist für den Adapter nicht aktiviert.
-
2147786788
-
Schreibsperre nicht aktiviert. Weitere Informationen finden Sie unter INetCfgLock::AcquireWriteLock.
-
Andere
-
101 4294967295
Bemerkungen
Wenn Sie EnableStatic verwenden, um die IP-Adresse des Remotecomputers zu ändern, während Sie über diesen Adapter verbunden sind, verlieren Sie wahrscheinlich die Verbindung mit dem Remotecomputer und erhalten eine RPC-Fehlermeldung nicht verfügbar. (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 Einstellung mit dem neuen Vorgang ist jedoch weiterhin erfolgreich.
Beispiele
Die statische IP-Adresse und das anschließende Hinzufügen zu einer Domäne powerShell-Codebeispiel im TechNet-Katalog verwendet EnableStatic , um einem lokalen Computer eine statische IP-Adresse hinzuzufügen.
Im Codebeispiel Zuweisen einer statischen IP-Adresse (VBScript) im TechNet-Katalog wird EnableStatic verwendet, um die IP-Adresse eines Computers festzulegen.
Im folgenden VBScript-Beispiel wird veranschaulicht, wie Sie die DHCP-Verwendung für eine instance von Win32_NetworkAdapterConfiguration deaktivieren. 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 folgenden Variablen ipaddr und Subnetz 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 Sie die DHCP-Verwendung für eine instance Win32_NetworkAdapterConfiguration deaktivieren. 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 folgenden Variablen ipaddr und Subnetz 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) |
WindowsServer 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|