MicrosoftDNS_Server-Klasse

Die MicrosoftDNS_Server-Klasse beschreibt einen DNS-Server. Jede instance dieser Klasse kann einer instance MicrosoftDNS_Cache, einer instance von MicrosoftDNS_RootHints und mehreren Instanzen von MicrosoftDNS_Zone zugeordnet sein.

Die folgende Syntax wird durch einen MOF-Code vereinfacht.

Syntax

class MicrosoftDNS_Server : CIM_Service
{
  string  Name;
  uint32  Version;
  uint32  LogLevel;
  string  LogFilePath;
  uint32  LogFileMaxSize;
  string  LogIPFilterList[];
  uint32  EventLogLevel;
  sint32  RpcProtocol;
  uint32  NameCheckFlag;
  uint32  AddressAnswerLimit;
  uint32  RecursionRetry;
  uint32  RecursionTimeout;
  uint32  DsPollingInterval;
  uint32  DsTombstoneInterval;
  uint32  MaxCacheTTL;
  uint32  MaxNegativeCacheTTL;
  uint32  SendPort;
  uint32  XfrConnectTimeout;
  uint32  BootMethod;
  uint32  AllowUpdate;
  uint32  UpdateOptions;
  boolean DsAvailable;
  boolean DisableAutoReverseZones;
  boolean AutoCacheUpdate;
  boolean NoRecursion;
  boolean RoundRobin;
  boolean LocalNetPriority;
  boolean StrictFileParsing;
  boolean LooseWildcarding;
  boolean BindSecondaries;
  boolean WriteAuthorityNS;
  uint32  ForwardDelegations;
  boolean SecureResponses;
  boolean DisjointNets;
  uint32  AutoConfigFileZones;
  uint32  ScavengingInterval;
  uint32  DefaultRefreshInterval;
  uint32  DefaultNoRefreshInterval;
  boolean DefaultAgingState;
  uint32  EDnsCacheTimeout;
  boolean EnableEDnsProbes;
  uint32  EnableDnsSec;
  string  ServerAddresses[];
  string  ListenAddresses[];
  string  Forwarders[];
  uint32  ForwardingTimeout;
  boolean IsSlave;
  boolean EnableDirectoryPartitions;
};

Member

Die MicrosoftDNS_Server-Klasse verfügt über die folgenden Membertypen:

• Methoden
• Eigenschaften

Methoden

Die MicrosoftDNS_Server-Klasse verfügt über diese Methoden.

Methode	BESCHREIBUNG
GetDistinguishedName	Ruft den distinguished DNS-Namen für die Zone ab.
StartScavenging	Beginnt mit dem Aufräumen veralteter Datensätze in den Zonen, die dem Aufräumen unterliegen.
Startservice	Startet den DNS-Server.
StopService	Beendet den DNS-Server.

Eigenschaften

Die MicrosoftDNS_Server-Klasse verfügt über diese Eigenschaften.

AddressAnswerLimit

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Maximale Anzahl von Hostdatensätzen, die als Antwort auf eine Adressanforderung zurückgegeben werden. Werte zwischen 5 und 28 sind gültig.

AllowUpdate

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Gibt an, ob der DNS-Server dynamische Updateanforderungen akzeptiert. Gültige Werte sind wie in der folgenden Tabelle dargestellt.

Wert	Bedeutung
0	Keine Einschränkungen.
1	Dynamische Updates von SOA-Einträgen sind nicht zulässig.
2	Erlaubt keine dynamischen Updates von NS-Datensätzen im Zonenstamm.
4	Erlaubt keine dynamischen Updates von NS-Einträgen, die sich nicht im Zonenstamm befinden (Delegierungs-NS-Datensätze).

Summieren Sie diese Werte, um den Einstellungswert zu bestimmen.

AutoCacheUpdate

Datentyp: Boolesch

Zugriffstyp: Lese-/Schreibzugriff

Gibt an, ob der DNS-Server versucht, seine Cacheeinträge mithilfe von Daten von Stammservern zu aktualisieren. Wenn ein DNS-Server gestartet wird, benötigt er eine Liste von Stammserverhinweisen für NS und A-Einträge für die Server, die historisch als Cachedatei bezeichnet werden. Microsoft DNS-Server verfügen über ein Feature, mit dem sie versuchen können, basierend auf den Antworten von Stammservern eine neue Cachedatei zurückzuschreiben.

AutoConfigFileZones

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Gibt an, welche primären Standardzonen, die für den Namen des DNS-Servers autoritativ sind, aktualisiert werden müssen, wenn sich der Nameserver ändert. Gültige Werte sind:

Wert	Bedeutung
0	Keine
1	Nur Server, die dynamische Updates zulassen.
2	Nur Server, die keine dynamischen Updates zulassen.
4	Alle Server.

Der Standardwert ist 1.

**Windows Server 2003: **

Die Zahl 3 stellt Alle Server dar.

BindSecondaries

Datentyp: Boolesch

Zugriffstyp: Lese-/Schreibzugriff

Bestimmt das AXFR-Nachrichtenformat beim Senden an Nicht-Microsoft DNS Server-Sekundärdateien. Wenn true festgelegt ist, sendet der DNS-Server Übertragungen an Nicht-Microsoft DNS Server-Sekundärdateien im nicht komprimierten Format. Bei FALSE werden alle Übertragungen im schnellen Format gesendet.

BootMethod

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Initialisierungsmethode für den DNS-Server. Gültige Werte werden in der folgenden Tabelle angezeigt.

Wert	Bedeutung
0	Nicht initialisiert.
1	Starten Sie aus der Datei.
2	Starten Sie aus der Registrierung.
3	Starten Sie aus Verzeichnis und Registrierung.

DefaultAgingState

Datentyp: Boolesch

Zugriffstyp: Lese-/Schreibzugriff

Standardmäßiger ScavengingInterval-Wert für alle in Active Directory integrierten Zonen festgelegt, die auf diesem DNS-Server erstellt werden. Der Standardwert ist 0, was angibt, dass das Auffangen deaktiviert ist.

DefaultNoRefreshInterval

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Kein Aktualisierungsintervall (in Stunden) für alle in Active Directory integrierten Zonen festgelegt, die auf diesem DNS-Server erstellt wurden. Der Standardwert ist 168 Stunden (sieben Tage).

DefaultRefreshInterval

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Aktualisierungsintervall (in Stunden) für alle in Active Directory integrierten Zonen festgelegt, die auf diesem DNS-Server erstellt wurden. Der Standardwert ist 168 Stunden (sieben Tage).

DisableAutoReverseZones

Datentyp: Boolesch

Zugriffstyp: Lese-/Schreibzugriff

Gibt an, ob der DNS-Server automatisch Standardmäßige Reverse-Look up-Zonen erstellt.

DisjointNets

Datentyp: Boolesch

Zugriffstyp: Lese-/Schreibzugriff

Gibt an, ob die Standardportbindung für einen Socket, der zum Senden von Abfragen an DNS-Remoteserver verwendet wird, überschrieben werden kann.

DsAvailable

Datentyp: Boolesch

Zugriffstyp: Lese-/Schreibzugriff

Gibt an, ob auf dem DNS-Server ein DS verfügbar ist.

DsPollingInterval

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Intervall in Sekunden, um die in DS integrierten Zonen abzufragen.

DsTombstoneInterval

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Lebensdauer von Grabsteinen in integrierten Zonen des Verzeichnisdiensts, ausgedrückt in Sekunden.

EDnsCacheTimeout

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Lebensdauer der zwischengespeicherten Informationen, die die von anderen DNS-Servern unterstützte EDNS-Version beschreiben, in Sekunden.

EnableDirectoryPartitions

Datentyp: Boolesch

Zugriffstyp: Lese-/Schreibzugriff

Gibt an, ob die Unterstützung für Anwendungsverzeichnispartitionen auf dem DNS-Server aktiviert ist.

**Windows Server 2003: **

Diese Methode heißt EnableDirectoryPartitionSupport.

EnableDnsSec

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Gibt gemäß der folgenden Tabelle an, ob der DNSSEC-spezifische RRs, KEY, SIG und NXT in einer Antwort enthält:

Wert	Bedeutung
0	In der Antwort sind keine DNSSEC-Einträge enthalten, es sei denn, die Abfrage hat einen Ressourcendatensatz des DNSSEC-Datensatztyps angefordert.
1	DNSSEC-Einträge sind in der Antwort gemäß RFC 2535 enthalten.
2	DNSSEC-Einträge sind nur in einer Antwort enthalten, wenn die ursprüngliche Clientabfrage den OPT-Ressourceneintrag gemäß RFC 2671 enthielt.

Wenn eine Abfrage einen Ressourcendatensatz des DNSSEC-Typs anfordert, antwortet der DNS-Server immer mit solchen Datensätzen, sofern verfügbar.

EnableEDnsProbes

Datentyp: Boolesch

Zugriffstyp: Lese-/Schreibzugriff

Gibt das Verhalten des DNS-Servers an. Bei TRUE antwortet der DNS-Server immer mit OPT-Ressourceneinträgen gemäß RFC 2671, es sei denn, der Remoteserver hat angegeben, dass er EDNS bei einem vorherigen Austausch nicht unterstützt. Bei FALSE antwortet der DNS-Server nur dann auf Abfragen mit OPTs, wenn OPTs in der ursprünglichen Abfrage gesendet werden.

Eventloglevel

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Gibt an, welche Ereignisse vom DNS-Server im Ereignisanzeige Systemprotokoll aufgezeichnet werden. Die folgenden Werte werden verwendet.

Wert	Bedeutung
0	Keine
1	Nur Fehler protokollieren.
2	Protokollieren Sie nur Warnungen und Fehler.
4	Protokollieren Sie alle Ereignisse.

ForwardDelegations

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Gibt an, ob Abfragen an delegierte Unterzonen weitergeleitet werden.

Weiterleitungen

Datentyp: Zeichenfolgenarray

Zugriffstyp: Lese-/Schreibzugriff

Listet die Liste der IP-Adressen von Weiterleitungen auf, an die der DNS-Server Abfragen weiterleitet.

ForwardingTimeout

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

In Sekunden wartet ein DNS-Server, der eine Abfrage weiterleitt, auf die Auflösung von der Weiterleitung , bevor versucht wird, die Abfrage selbst aufzulösen.

Dieser Wert ist bedeutungslos, wenn der Weiterleitungsserver nicht auf rekursion festgelegt ist. Um dies zu ermitteln, überprüfen Sie die Boolesche Eigenschaft IsSlave.

Isslave

Datentyp: Boolesch

Zugriffstyp: Lese-/Schreibzugriff

TRUE , wenn der DNS-Server keine Rekursion verwendet, wenn die Namensauflösung über Weiterleitungen fehlschlägt.

ListenAddresses

Datentyp: Zeichenfolgenarray

Zugriffstyp: Lese-/Schreibzugriff

Listet die Liste der IP-Adressen auf, für die der DNS-Server Abfragen empfangen kann.

LocalNetPriority

Datentyp: Boolesch

Zugriffstyp: Lese-/Schreibzugriff

Gibt an, ob der DNS-Server der lokalen Netzadresse Beim Zurückgeben von A-Einträgen Priorität einräumt.

LogFileMaxSize

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Größe des DNS-Server-Debugprotokolls in Bytes.

Logfilepath

Datentyp: Zeichenfolge

Zugriffstyp: Lese-/Schreibzugriff

Dateiname und Pfad für das DNS Server-Debugprotokoll. Der Standardwert ist %system32%\dns\dns.log. Relative Pfade sind relativ zu %Systemroot%\System32. Absolute Pfade können verwendet werden, UNC-Pfade werden jedoch nicht unterstützt.

LogIPFilterList

Datentyp: Zeichenfolgenarray

Zugriffstyp: Lese-/Schreibzugriff

Liste der IP-Adressen, die zum Filtern von DNS-Ereignissen verwendet werden, die in das Debugprotokoll geschrieben wurden.

LogLevel

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Gibt an, welche Richtlinien im Ereignisanzeige Systemprotokoll aktiviert sind.

Sollte auf bestimmte Werte basierend auf dem folgenden Algorithmus festgelegt werden: Jeder Richtlinie (die im Ereignisanzeige Systemprotokoll aktiviert werden soll) wird ein bestimmter Wert zugewiesen.

Wert	Bedeutung
1	Abfrage
16	Benachrichtigen.
32	Update.
254	Transaktionen ohne Abfrage.
256	Fragen.
512	Antworten.
4096	Send.
8192	Erhalten.
16384	UDP.
32768	TCP.
65535	Alle Pakete.
65536	NT Directory Service-Schreibtransaktion.
131072	NT Directory Service-Updatetransaktion.
16777216	Vollständige Pakete.
2147483648	Durchschreiben.

Die Summe der Werte, die allen zu aktivierenden Richtlinien entsprechen, wird in dieser Eigenschaft angegeben.

LooseWildcarding

Datentyp: Boolesch

Zugriffstyp: Lese-/Schreibzugriff

Gibt an, ob der DNS-Server lose Feldhalterungen ausführt. Wenn nicht definiert oder null, folgt der Server dem im DNS-RFC angegebenen Feldhalterverhalten. In diesem Fall wird einem Administrator empfohlen, MX-Einträge für alle Hosts aufzunehmen, die nicht in der Lage sind, E-Mails zu empfangen. Bei nichtzero sucht der Server den nächstgelegenen Feldhalterknoten. In diesem Fall sollte ein Administrator MX-Einträge im Zonenstamm und in einem Platzhalterknoten ('*') direkt unterhalb des Zonenstamms platzieren. Außerdem sollten Administratoren selbstverweisende MX-Einträge auf Hosts platzieren, die ihre eigenen E-Mails empfangen.

MaxCacheTTL

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Der Datensatz einer rekursiven Namensabfrage kann maximal in Sekunden im DNS-Servercache verbleiben. Der DNS-Server löscht Datensätze aus dem Cache, wenn der Wert dieses Eintrags abläuft, auch wenn der Wert des TTL-Felds im Datensatz größer ist.

Der Standardwert dieser Eigenschaft ist 86.400 Sekunden (1 Tag).

MaxNegativeCacheTTL

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Ein Namesfehler, der aus einer rekursiven Abfrage resultiert, kann maximal in Sekunden im DNS-Servercache verbleiben. DNS löscht Datensätze aus dem Cache, wenn dieser Timer abläuft, auch wenn das TTL-Feld größer ist. Der Standardwert ist 86.400 (ein Tag).

Name

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Vollqualifizierter Domänenname (FQDN) oder IP-Adresse des DNS-Servers.

NameCheckFlag

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Gibt den Satz berechtigter Zeichen an, die in DNS-Namen verwendet werden sollen. Die folgenden Werte werden verwendet.

Wert	Bedeutung
0	Strict RFC (ANSI)
1	Nicht RFC (ANSI)
3	Multibyte (UTF8)

**Windows Server 2003: **

Der Wert "2" gibt "Any" an.

NoRecursion

Datentyp: Boolesch

Zugriffstyp: Lese-/Schreibzugriff

Gibt an, ob der DNS-Server rekursive Look ups ausführt. TRUE gibt an, dass rekursive Nachschlagevorgänge nicht ausgeführt werden.

RecursionRetry

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Sekunden vor dem wiederholen eines rekursiven Nachschlagens verstrichen. Wenn die Eigenschaft nicht definiert oder null ist, werden nach drei Sekunden Wiederholungen durchgeführt. Benutzern wird davon abgeraten, diese Eigenschaft zu ändern. Es gibt bestimmte Situationen, in denen die Eigenschaft geändert werden sollte. Ein Beispiel ist, wenn der DNS-Server Remoteserver über einen langsamen Link kontaktiert, und der DNS-Server versucht erneut, bevor die Antwort vom Remote-DNS empfangen wird. In diesem Fall wäre es sinnvoll, das Timeout auf etwas länger als die vom Remote-DNS beobachtete Antwortzeit zu erhöhen.

RekursionTimeout

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Sekunden verstrichen, bevor der DNS-Server die rekursive Abfrage aufgibt. Wenn die Eigenschaft nicht definiert oder null ist, gibt der DNS-Server nach 15 Sekunden auf. Im Allgemeinen reicht das Timeout von 15 Sekunden aus, um eine ausstehende Antwort zurück zum DNS-Server zu ermöglichen.

Benutzern wird davon abgeraten, diese Eigenschaft zu ändern. Ein Szenario, in dem die Eigenschaft geändert werden sollte, ist, wenn der DNS-Server Remoteserver über eine langsame Verbindung kontaktiert, und der DNS-Server wird beobachtet, wie Abfragen (mit SERVER_FAILURE) abgelehnt werden, bevor Antworten empfangen werden.

Clientlöser wiederholen auch Abfragen, sodass eine sorgfältige Untersuchung erforderlich ist, um zu ermitteln, ob Remoteantworten tatsächlich der Abfrage zugeordnet sind, bei der ein Timeout aufgetreten ist. In diesem Fall wäre es sinnvoll, den Timeoutwert auf etwas länger als die vom Remote-DNS beobachtete Antwortzeit zu erhöhen.

RoundRobin

Datentyp: Boolesch

Zugriffstyp: Lese-/Schreibzugriff

Gibt an, ob der DNS-Server mehrere A-Einträge rundet.

RpcProtocol

Datentyp: sint32

Zugriffstyp: Lese-/Schreibzugriff

RPC-Protokoll oder -Protokolle, über die administrative RPC ausgeführt wird. Der folgende Algorithmus wird verwendet, um einen bestimmten Wert zuzuweisen:

Wert	Bedeutung
0	Keine
1	TCP
2	Named Pipes
4	LPC

Die Summe der Werte gibt die verwendeten Protokolle an.

ScavengingInterval

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Intervall in Stunden zwischen zwei aufeinanderfolgenden Aufräumvorgängen, die vom DNS-Server ausgeführt werden. Null gibt an, dass das Auffangen deaktiviert ist. Der Standardwert ist 168 Stunden (sieben Tage).

SecureResponses

Datentyp: Boolesch

Zugriffstyp: Lese-/Schreibzugriff

Gibt an, ob der DNS-Server ausschließlich Datensätze mit Namen in derselben Unterstruktur speichert wie der Server, von dem sie bereitgestellt wurden.

SendPort

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Port, an dem der DNS-Server UDP-Abfragen an andere Server sendet. Standardmäßig sendet der DNS-Server Abfragen an einen Socket, der an den DNS-Port gebunden ist.

In bestimmten Situationen ist dies nicht die beste Konfiguration. Ein offensichtlicher Fall ist, wenn ein Administrator den DNS-Port mit einer Firewall blockiert, um den externen Zugriff auf den DNS-Server zu verhindern, aber dennoch möchte, dass der Server Internet-DNS-Server kontaktieren kann, um die Namensauflösung für interne Clients bereitzustellen. Ein weiterer Fall ist, wenn der DNS-Server disjoint nets unterstützt (die Eigenschaft DisjointNets , die auf TRUE festgelegt ist, identifiziert dieses Szenario). In diesen Fällen wird der DNS-Server durch Festlegen der SendOnNonDnsPort-Eigenschaft auf einen nichtzero-Wert an einen beliebigen Port zum Senden an Remote-DNS-Server gebunden.

Wenn der SendOnNonDnsPort-Wert größer als 1024 ist, bindet der DNS-Server explizit an den angegebenen Portwert. Diese Konfigurationsoption ist nützlich, wenn ein Administrator den DNS-Abfrageport für Firewallzwecke reparieren muss.

**Windows Server 2003: **

Wenn Die SendPort-Eigenschaft auf einen Wert ungleich 0 festgelegt wird, wird der DNS-Server an einen beliebigen Port gebunden, um an Remote-DNS-Server zu senden.

ServerAddresses

Datentyp: Zeichenfolgenarray

Zugriffstyp: Schreibgeschützt

Listet die Liste der IP-Adressen für den DNS-Server auf.

StrictFileParsing

Datentyp: Boolesch

Zugriffstyp: Lese-/Schreibzugriff

Gibt an, ob der DNS-Server Zonendateien streng analysiert. Wenn nicht definiert oder null, protokolliert und ignoriert der Server fehlerhafte Daten in der Zonendatei und lädt weiterhin. Wenn nicht zero, protokolliert der Server und schlägt bei Zonendateifehlern fehl.

UpdateOptions

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Schränkt den Typ von Datensätzen ein, die dynamisch auf dem Server aktualisiert werden können, die zusätzlich zu den AllowUpdate-Einstellungen für Server- und Zonenobjekte verwendet werden.

**Windows Server 2003: **

0: Keine Einschränkungen.

1: Lassen Sie keine dynamischen Updates von SOA-Datensätzen zu.

2: Lassen Sie keine dynamischen Updates von NS-Datensätzen am Zonenstamm zu.

4: Lassen Sie keine dynamischen Updates von NS-Datensätzen zu, die sich nicht am Zonenstamm befinden (Delegierungs-NS-Datensätze).

Summieren Sie diese Werte, um den Einstellungswert zu bestimmen.

Version

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Version des DNS-Servers.

WriteAuthorityNS

Datentyp: Boolesch

Zugriffstyp: Lese-/Schreibzugriff

Gibt an, ob der DNS-Server NS- und SOA-Datensätze nach erfolgreicher Antwort in den Autoritätsabschnitt schreibt.

XfrConnectTimeout

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

In Sekunden wartet der DNS-Server beim Versuch einer Zonenübertragung auf eine erfolgreiche TCP-Verbindung mit einem Remoteserver.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Namespace	Stamm\MicrosoftDNS
MOF	Dnsprov.mof

Siehe auch

StartService-Methode der MicrosoftDNS_Server-Klasse

StopService-Methode der MicrosoftDNS_Server-Klasse

StartScavenging-Methode der MicrosoftDNS_Server-Klasse

GetDistinguishedName-Methode der MicrosoftDNS_Server-Klasse