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

Siehe auch

Computersystemhardwareklassen

Win32 _ NetworkAdapterConfiguration

WMI-Aufgaben: Netzwerk

WMI-Aufgaben: Konten und Domänen

IPv6- und IPv4-Unterstützung in WMI