EnableStatic-Methode der Win32_NetworkAdapterConfiguration-Klasse

Artikel
06/12/2023

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

Erfolgreicher Abschluss, kein Neustart erforderlich.

Erfolgreicher Abschluss, Neustart erforderlich

Erfolgreicher Abschluss, Neustart erforderlich.

Methode wird auf dieser Plattform nicht unterstützt

Die Methode wird auf dieser Plattform nicht unterstützt.

Unbekannter Fehler

Unbekannter Fehler.

Ungültige Subnetzmaske

Ungültige Subnetzmaske.

Fehler beim Verarbeiten einer zurückgegebenen Instanz

Fehler beim Verarbeiten eines zurückgegebenen instance.

Ungültiger Eingabeparameter

Ungültiger Eingabeparameter.

Mehr als 5 Gateways angegeben

Mehr als fünf Gateways angegeben.

Ungültige IP-Adresse

Ungültige IP-Adresse.

Ungültige Gateway-IP-Adresse

Ungültige Gateway-IP-Adresse.

Fehler beim Zugriff auf die Registrierung für die angeforderten Informationen

Fehler beim Zugriff auf die Registrierung für die angeforderten Informationen.

Ungültiger Domänenname

Ungültiger Domänenname.

Ungültiger Hostname

Ungültiger Hostname.

Kein primärer/sekundärer WINS-Server definiert

Kein primärer oder sekundärer WINS-Server definiert.

Ungültige Datei

Ungültige Datei

Ungültiger Systempfad

Ungültiger Systempfad.

Fehler beim Kopieren der Datei

Fehler beim Kopieren der Datei.

Ungültiger Sicherheitsparameter

Ungültiger Sicherheitsparameter.

Tcp/IP-Dienst kann nicht konfiguriert werden

Tcp/IP-Dienst kann nicht konfiguriert werden.

Dhcp-Dienst kann nicht konfiguriert werden

Dhcp-Dienst kann nicht konfiguriert werden. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

DHCP-Lease kann nicht verlängert werden

DHCP-Lease kann nicht verlängert werden.

DHCP-Lease kann nicht freigegeben werden

DHCP-Lease kann nicht freigegeben werden.

IP-Adresse auf adapter nicht aktiviert

DIE IP-Adresse ist für den Adapter nicht aktiviert.

IPX auf adapter nicht aktiviert

IPX ist für den Adapter nicht aktiviert.

Frame-/Netzwerknummergrenzenfehler

Frame- oder Netzwerknummerngrenzenfehler.

Ungültiger Frametyp

Ungültiger Frametyp.

Ungültige Netzwerknummer

Ungültige Netzwerknummer.

Doppelte Netzwerknummer

Doppelte Netzwerknummer.

Parameter außerhalb der Grenzen

Parameter außerhalb der Grenzen.

Zugriff verweigert

Zugriff verweigert.

Nicht genügend Arbeitsspeicher

Nicht genügend Arbeitsspeicher.

Bereits vorhanden

Ist bereits vorhanden.

Pfad, Datei oder Objekt nicht gefunden

Pfad, Datei oder Objekt nicht gefunden.

Dienst kann nicht benachrichtigt werden

Dienst kann nicht benachrichtigt werden.

Benachrichtigung des DNS-Diensts nicht möglich

Der DNS-Dienst kann nicht benachrichtigt werden.

Schnittstelle nicht konfigurierbar

Schnittstelle nicht konfigurierbar.

Nicht alle DHCP-Leases konnten freigegeben/erneuert werden.

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	CIMWin32.mof
DLL	CIMWin32.dll

Siehe auch

Hardwareklassen des Computersystems
Win32_NetworkAdapterConfiguration
WMI-Aufgaben: Netzwerk
WMI-Aufgaben: Konten und Domänen
IPv6- und IPv4-Unterstützung in WMI

Freigeben über