Freigeben über


SetDNSServerSearchOrder-Methode der Win32_NetworkAdapterConfiguration-Klasse

Die WMI-KlassenmethodeSetDNSServerSearchOrder verwendet ein Array von Zeichenfolgenelementen, um die Suchreihenfolge des Servers festzulegen.

In diesem Thema wird MOF-Syntax (Managed Object Format) verwendet. Weitere Informationen zur Verwendung dieser Methode finden Sie unter Aufrufen einer Methode.

Syntax

uint32 SetDNSServerSearchOrder(
  [in] string DNSServerSearchOrder[]
);

Parameter

DNSServerSearchOrder [in]

Liste der Server-IP-Adressen, die nach DNS-Servern abfragt werden sollen.

Beispiel: 130.215.24.1 oder 157.54.164.1

Rückgabewert

Gibt den Wert 0 (null) für einen erfolgreichen Abschluss zurück, wenn kein Neustart 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, Neustart erforderlich (1)

Methode wird auf dieser Plattform nicht unterstützt (64)

Unbekannter Fehler (65)

Ungültige Subnetzmaske (66)

Fehler beim Verarbeiten einer zurückgegebenen Instanz (67)

Ungültiger Eingabeparameter (68)

Mehr als 5 Gateways angegeben (69)

Ungültige IP-Adresse (70)

Ungültige Gateway-IP-Adresse (71)

Fehler beim Zugriff 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 freigegeben werden (83)

IP auf Adapter nicht aktiviert (84)

IPX auf Adapter nicht aktiviert (85)

Frame/Network Number bounds error (86)

Ungültiger Frametyp (87)

Ungültige Netzwerknummer (88)

Doppelte Netzwerknummer (89)

Parameter außerhalb der 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)

Sonstige (101 4294967295)

Bemerkungen

Dies ist ein instance-abhängiger Methodenaufruf, der auf Adapterbasis angewendet wird. Nachdem statische DNS-Server für die Verwendung des Dynamic Host Configuration Protocol (DHCP) anstelle von statischen DNS-Servern angegeben wurden, können Sie die -Methode aufrufen, ohne "in"-Parameter anzugeben.

Beispiele

Das Beispiel Set DNS Server Search Order for Multiple Computers in an Organizational Unit VBScript im TechNet Gallery ruft die DNS Server-Suchreihenfolge für mehrere Computer ab, die zu einer Organisationseinheit gehören, oder legt diese fest.

Im VBScript-Beispiel Ändern der DNS-Server-Suchreihenfolge für einen Netzwerkadapter wird ein TCP/IP-gebundener Netzwerkadapter so konfiguriert, dass zwei DNS-Server verwendet werden.

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