MSFT_NetTCPSetting-Klasse

Artikel
05/14/2024

Stellt die TCP-Parametereinstellung für den Microsoft TCP/IP (Internet Protocol Suite) WMIv2-Anbieter dar.

Die folgende Syntax wurde aus MOF-Code (Managed Object Format, verwaltetes Objektformat) vereinfacht und enthält alle geerbten Eigenschaften.

Syntax

[UMLPackagePath("CIM::Policy"), ClassVersion("1.0.0"), dynamic, provider("nettcpip"), AMENDMENT]
class MSFT_NetTCPSetting : CIM_PolicyAction
{
  string  InstanceID;
  string  Caption;
  string  Description;
  string  ElementName;
  string  CommonName;
  string  PolicyKeywords[];
  string  SystemCreationClassName;
  string  SystemName;
  string  PolicyRuleCreationClassName;
  string  PolicyRuleName;
  string  CreationClassName;
  string  PolicyActionName;
  boolean DoActionLogging;
  string  SettingName;
  uint32  MinRto;
  uint32  InitialCongestionWindow;
  uint8   CwndRestart;
  uint8   MemoryPressureProtection;
  uint8   CongestionProvider;
  uint8   AutoTuningLevelLocal;
  uint8   EcnCapability;
  uint8   Timestamps;
  uint32  InitialRto;
  uint8   ScalingHeuristics;
  uint16  DynamicPortRangeStartPort;
  uint16  DynamicPortRangeNumberOfPorts;
  uint8   AutoTuningLevelGroupPolicy;
  uint8   AutoTuningLevelEffective;
  uint32  DelayedAckTimeout;
  uint8   DelayedAckFrequency;
  uint8   AutomaticUseCustom;
  uint8   NonSackRttResiliency;
  uint8   ForceWS;
  uint8   MaxSynRetransmissions;
  uint16  AutoReusePortRangeStartPort;
  uint16  AutoReusePortRangeNumberOfPorts;
};

Member

Die MSFT_NetTCPSetting-Klasse weist folgende Typen von Mitgliedern auf:

Eigenschaften

Eigenschaften

Die MSFT_NetTCPSetting-Klasse weist folgende Eigenschaften auf.

AutomaticUseCustom

Datentyp: uint8
Zugriffstyp: Lesen/Schreiben

Liest und setzt einen Wert, der angibt, ob die automatische Vorlageneinstellung benutzerdefinierte oder Standardvorlagen vorgibt. Diese Eigenschaft kann einen der folgenden Werte enthalten:

Wert	Bedeutung
Disabled 0	Die automatische Vorlageneinstellung legt die Standardvorlagen fest.
Aktiviert 1	Die automatische Vorlageneinstellung legt benutzerdefinierte Vorlagen fest.

AutoReusePortRangeNumberOfPorts

Datentyp: uint16
Zugriffstyp: Lesen/Schreiben

Anzahl der Ports ab der Eigenschaft AutoReusePortRangeStartPort für die automatische Wiederverwendung des Portbereichs.

** Windows 8.1, Windows Server 2012 R2, Windows 8 und Windows Server 2012: **

Diese Eigenschaft wird vor Windows 10 und Windows Server 2016 nicht unterstützt.

AutoReusePortRangeStartPort

Datentyp: uint16
Zugriffstyp: Lesen/Schreiben

Starten der automatischen Wiederverwendung der Portnummer zwischen 1025 und 65535.

** Windows 8.1, Windows Server 2012 R2, Windows 8 und Windows Server 2012: **

Diese Eigenschaft wird vor Windows 10 und Windows Server 2016 nicht unterstützt.

AutoTuningLevelEffective

Datentyp: uint8
Zugriffstyp: Schreibgeschützt

Ruft einen Wert ab, der angibt, ob die Auto-Tuning-Stufe durch eine Gruppenrichtlinie oder eine lokale Einstellung bestimmt wird.

Wert	Bedeutung
Lokal 0	Die Auto-Tuning-Stufe wird durch eine lokale Einstellung bestimmt.
GroupPolicy 1	Die Auto-Tuning-Stufe wird durch die Gruppenrichtlinie bestimmt.

AutoTuningLevelGroupPolicy

Datentyp: uint8
Zugriffstyp: Schreibgeschützt

Ruft die Auto-Tuning-Stufe für die Gruppenrichtlinie ab und legt sie fest. Dieser Parameter kann einen der folgenden Werte enthalten.

Wert	Bedeutung
Disabled 0	Die Auto-Tuning-Stufe ist deaktiviert.
Hochgradig eingeschränkt 1	Die Auto-Tuning-Stufe ist stark eingeschränkt.
Eingeschränkt 2	Die Auto-Tuning-Stufe ist eingeschränkt.
Normal 3	Die Auto-Tuning-Stufe ist normal.
Experimentell 4	Die Auto-Tuning-Stufe ist experimental.

AutoTuningLevelLocal

Datentyp: uint8
Zugriffstyp: Lesen/Schreiben

Ruft die lokale Auto-Tuning-Stufe auf und legt sie fest. Diese Eigenschaft enthält einen der folgenden Werte:

Wert	Bedeutung
Disabled 0
Hochgradig eingeschränkt 1	Stark eingeschränkt
Eingeschränkt 2
Normal 3
Experimentell 4

Caption

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Kennzeichner: MaxLen (64)

Enthält eine kurze Textbeschreibung des Objekts.

Diese Eigenschaft wird von CIM_ManagedElement geerbt.

CommonName

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Ein benutzerfreundlicher Name für dieses richtlinienbezogene Objekt.

Diese Eigenschaft wird von CIM_Policy geerbt.

CongestionProvider

Datentyp: uint8
Zugriffstyp: Lesen/Schreiben

Ruft die TCP-Überlastungsanbietereinstellung ab und legt sie fest. Diese Eigenschaft enthält einen der folgenden Werte:

Wert	Bedeutung
Standard 0
CTCP 2	Compound TCP (CTCP)
DCTCP 3	Rechenzentrum-TCP (DCTCP)

CreationClassName

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Kennzeichner: key, MaxLen (256)

Gibt den Namen der beim Erstellen einer Instanz verwendeten Klasse oder Unterklasse an. In Verbindung mit den anderen Schlüsseleigenschaften dieser Klasse ermöglicht diese Eigenschaft die eindeutige Identifizierung aller Instanzen dieser Klasse und ihrer Unterklassen.

Diese Eigenschaft wird von CIM_PolicyAction geerbt.

CwndRestart

Datentyp: uint8
Zugriffstyp: Lesen/Schreiben

Ermittelt und bestimmt einen Wert, der angibt, ob ein überlastetes Fenster neu gestartet wird. Diese Eigenschaft enthält einen der folgenden Werte:

Wert	Bedeutung
Disabled 0	Ein überlastetes Fenster wird nicht neu gestartet.
Aktiviert 1	Ein überlastetes Fenster wird neu gestartet.

DelayedAckFrequency

Datentyp: uint8
Zugriffstyp: Lesen/Schreiben

Ermittelt und bestimmt die Anzahl der nicht aufgelösten Bestätigungen (Acknowledgments, ACK), die dazu führen, dass der ACK-Timer ignoriert wird. Dieser Parameter kann zwischen 1 und 255 liegen.

DelayedAckTimeout

Datentyp: uint32
Zugriffstyp: Lesen/Schreiben

Ruft das verzögerte ACK-Timeout von TCP in Millisekunden ab und legt es fest. Diese Eigenschaft kann einen Wert von 10 bis 600 aufweisen.

Beschreibung

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Bietet eine Textbeschreibung des Objekts.

Diese Eigenschaft wird von CIM_ManagedElement geerbt.

DoActionLogging

Datentyp: Boolesch
Zugriffstyp: Schreibgeschützt

Bewirkt, dass eine Protokollmeldung generiert wird, wenn die Aktion ausgeführt wird.

Diese Eigenschaft wird von CIM_PolicyAction geerbt.

DynamicPortRangeNumberOfPorts

Datentyp: uint16
Zugriffstyp: Lesen/Schreiben

Ruft die Anzahl der Ports im dynamischen Portbereich ab und legt sie fest.

DynamicPortRangeStartPort

Datentyp: uint16
Zugriffstyp: Lesen/Schreiben

Ruft den Startport des dynamischen Portbereichs ab und legt ihn fest. Die Eigenschaft kann einen Wert zwischen 1 und 65535 aufweisen.

EcnCapability

Datentyp: uint8
Zugriffstyp: Lesen/Schreiben

Ermittelt und bestimmt die Explizite Überlastungsbenachrichtigung (Explicit Congestion Notification, ECN)-Funktion fest. Diese Eigenschaft enthält einen der folgenden Werte:

Wert	Bedeutung
Disabled 0	ECN ist deaktiviert.
Aktiviert 1	ECN ist aktiviert.

ElementName

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Enthält einen benutzerfreundlichen Namen für das Objekt. Diese Eigenschaft ermöglicht jeder Instanz, neben den wichtigsten Eigenschaften, den Identitätsdaten und beschreibenden Informationen einen benutzerfreundlichen Namen zu definieren.

Diese Eigenschaft wird von CIM_ManagedElement geerbt.

ForceWS

Datentyp: uint8
Zugriffstyp: Lesen/Schreiben

Ruft einen Wert ab und legt einen Wert fest, der angibt, ob die erzwungene Fensterskalierung aktiviert ist.

Windows 8 und Windows Server 2012: Diese Eigenschaft wird vor Windows 8.1 und Windows Server 2012 R2 nicht unterstützt.

Wert	Bedeutung
Disabled 0	Erzwungene Fensterskalierung ist deaktiviert.
Aktiviert 1	Die erzwungene Fensterskalierung ist aktiviert.

InitialCongestionWindow

Datentyp: uint32
Zugriffstyp: Lesen/Schreiben

Ermittelt und bestimmt die maximale Segmentgröße des anfänglichen Überlastungsfensters. Der Eigenschaftswert kann zwischen 2 und 64 liegen.

InitialRto

Datentyp: uint32
Zugriffstyp: Lesen/Schreiben

Ermittelt und bestimmt den Timeout für die erneute Übertragung in Millisekunden. Der Standardwert dieser Eigenschaft beträgt 3.000.

InstanceID

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Identifiziert eindeutig und nicht transparent eine Instanz dieser Klasse im Bereich des enthaltenden Namespace.

[!Wichtig]Um die Eindeutigkeit innerhalb des Namespace zu gewährleisten, sollte der Wert von InstanceID gemäß folgendem Muster erstellt werden:

OrgID:LocalID

OrgID muss einen urheberrechtlich geschützten, Marken- oder anderweitig eindeutigen Namen enthalten, der der Geschäftsentität gehört, die die InstanceID definiert, oder eine registrierte ID sein, die von einer anerkannten globalen Autorität zugewiesen wird. Dies ähnelt der Struktur der Schemaklassennamen. Um die Eindeutigkeit des ersten Doppelpunkts in InstanceID sicherzustellen, muss er sich außerdem zwischen der OrgID und localID befinden. Daher darf die OrgID keinen Doppelpunkt („:“) enthalten.

LocalID wird von der Geschäftsentität ausgewählt und sollte nicht wiederverwendet werden, um unterschiedliche zugrunde liegende (reale) Elemente zu identifizieren.

Wenn das vorherige Muster nicht verwendet wird, muss die definierende Entität sicherstellen, dass die resultierende InstanceID nicht in allen InstanceIDs wiederverwendet wird, die von diesem oder anderen Anbietern dieses Namespace erstellt werden.

Für definierte Instanzen der Distributed Management Task Force (DMTF) muss das Muster verwendet werden, wobei die OrgID auf CIM gesetzt wird.

Diese Eigenschaft wird von CIM_ManagedElement geerbt.

MaxSynRetransmissions

Datentyp: uint8
Zugriffstyp: Lesen/Schreiben

Ermittelt und bestimmt die Anzahl der Versuche fest, eine Verbindung mit SYN-Paketen wiederherzustellen. Diese Eigenschaft kann einen Wert von 2 bis 8 aufweisen.

Windows 8 und Windows Server 2012: Diese Eigenschaft wird vor Windows 8.1 und Windows Server 2012 R2 nicht unterstützt.

MemoryPressureProtection

Datentyp: uint8
Zugriffstyp: Lesen/Schreiben

Ruft die Einstellung für den Speicherdruckschutz ab und legt sie fest. Diese Eigenschaft enthält einen der folgenden Werte:

Wert	Bedeutung
Disabled 0	Deaktivieren des Speicherdruckschutzes.
Aktiviert 1	Aktivieren des Speicherdruckschutzes.
Standard 2	Zurücksetzen des Speicherdruckschutzstatus auf den Systemstandard.

MinRto

Datentyp: uint32
Zugriffstyp: Lesen/Schreiben

Ermittelt und bestimmt den Timeout für die erneute TCP-Übertragung in Millisekunden. Der Eigenschaftswert kann zwischen 20 Millisekunden und 300 Millisekunden liegen.

NonSackRttResiliency

Datentyp: uint8
Zugriffstyp: Lesen/Schreiben

Dient zum Abrufen und Festlegen eines Werts, der die Resilienz von Roundtrip-Zeit (RoundTrip Time, RTT) für Clients ermöglicht, die keine selektive Bestätigung (Selective Acknowledgment, SACK) unterstützen.

Windows 8 und Windows Server 2012: Diese Eigenschaft wird vor Windows 8.1 und Windows Server 2012 R2 nicht unterstützt.

Wert	Bedeutung
Disabled 0	Deaktivieren der RTT-Resilienz für Clients, die SACK nicht unterstützen.
Aktiviert 1	Aktivieren der RTT-Resilienz für Clients, die SACK nicht unterstützen.

PolicyActionName

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Kennzeichner: key, MaxLen (256)

Ein benutzerfreundlicher Name dieser Richtlinienaktion.

Diese Eigenschaft wird von CIM_PolicyAction geerbt.

PolicyKeywords

Datentyp: string-Array
Zugriffstyp: Schreibgeschützt

Ein Array von Schlüsselwörtern zum Charakterisieren/Kategorisieren von Richtlinienobjekten. Es gibt zwei Arten von Schlüsselwörtern:

Schlüsselwörter, die in dieser und anderen MOFs oder in DMTF-Whitepapers definiert sind. Diese Schlüsselwörter bieten eine hersteller- und installationsunabhängige Möglichkeit zur Charakterisierung von Richtlinienobjekten.
Installationsabhängige Schlüsselwörter zur Charakterisierung von Richtlinienobjekten. Beispiele sind ‚Technik’, ‚Rechnungsstellung’ und ‚Überprüfung im Dezember 2000’.

Diese MOF definiert die folgenden Schlüsselwörter: UNBEKANNT, KONFIGURATION, VERBRAUCH, SICHERHEIT, DIENST, MOTIVATIONSABHÄNGIG, INSTALLATION und EVENT. Diese Konzepte sind selbsterklärend und werden im SLA/Whitepaper der Richtlinie näher erläutert. Es wird ein zusätzliches Schlüsselwort definiert: RICHTLINIE. Die Rolle dieses Schlüsselworts besteht darin, richtlinienbezogene Instanzen zu identifizieren, die in einigen Implementierungen möglicherweise nicht anderweitig identifizierbar sind. Das Schlüsselwort RICHTLINIE schließt die anderen oben genannten Schlüsselwörter NICHT aus.

Diese Eigenschaft wird von CIM_Policy geerbt.

PolicyRuleCreationClassName

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Kennzeichner: key, MaxLen (256)

Bei einer regelspezifischen Aktion der CreationClassName des Regelobjekts, mit dem diese Aktion verknüpft ist. Für eine wiederverwendbare Richtlinienaktion sollte ein spezieller Wert, ‚OHNE REGEL’, verwendet werden, um anzuzeigen, dass diese Aktion wiederverwendbar und nicht mit einer einzelnen Richtlinienregel verbunden ist.

Diese Eigenschaft wird von CIM_PolicyAction geerbt.

PolicyRuleName

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Kennzeichner: key, MaxLen (256)

Bei einer regelspezifischen Aktion der Name des Regelobjekts, mit dem diese Aktion verknüpft ist. Für eine wiederverwendbare Richtlinienaktion sollte ein spezieller Wert, ‚OHNE REGEL’, verwendet werden, um anzuzeigen, dass diese Aktion wiederverwendbar und nicht mit einer einzelnen Richtlinienregel verbunden ist.

Diese Eigenschaft wird von CIM_PolicyAction geerbt.

ScalingHeuristics

Datentyp: uint8
Zugriffstyp: Lesen/Schreiben

Ruft einen Wert ab und legt einen Wert fest, der angibt, ob die Heuristik der Fensterskalierung aktiviert ist.

Wert	Bedeutung
Disabled 0	Die Heuristik der Fensterskalierung ist deaktiviert.
Aktiviert 1	Die Heuristik der Fensterskalierung ist aktiviert.

settingName

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Ruft den Namen der Einstellung ab. Diese Eigenschaft enthält einen der folgenden Werte:

DatacenterCustom
InternetCustom
Datacenter
Compat
Internet
Automatisch

SystemCreationClassName

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Kennzeichner: key, MaxLen (256)

Der Name der Klasse oder der Unterklasse, die bei der Erstellung des Systemobjekts verwendet wurde, in dessen Geltungsbereich diese Richtlinienaktion definiert ist.

Diese Eigenschaft hilft bei der Identifizierung des Systemobjekts, in dessen Geltungsbereich diese Instanz der Richtlinienaktion existiert. Bei einer regelspezifischen Richtlinienaktion ist dies das System, in dessen Kontext die Richtlinienregel definiert ist. Bei einer wiederverwendbaren Richtlinienaktion ist dies die Instanz von PolicyRepository (einer Unterklasse von System), die die Aktion enthält.

Beachten Sie, dass diese Eigenschaft und die analoge Eigenschaft SystemName keine verteilten Schlüssel aus einer Instanz des Klassensystems darstellen. Stattdessen handelt es sich um Eigenschaften, die im Kontext dieser Klasse definiert sind und die Werte aus der Instanz von System wiederholen, mit der diese Richtlinienaktion verbunden ist, entweder direkt über die Assoziation InPolicyRepository der Richtlinienaktion oder indirekt über die Aggregation PolicyActionInPolicyRule.

Diese Eigenschaft wird von CIM_PolicyAction geerbt.

SystemName

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Kennzeichner: key, MaxLen (256)

Der Name des Systemobjekts, in dessen Geltungsbereich diese Richtlinienaktion definiert ist.

Diese Eigenschaft vervollständigt die Identifizierung des Systemobjekts, in dessen Geltungsbereich diese Instanz der Richtlinienaktion existiert. Bei einer regelspezifischen Richtlinienaktion ist dies das System, in dessen Kontext die Richtlinienregel definiert ist. Bei einer wiederverwendbaren Richtlinienaktion ist dies die Instanz von PolicyRepository (einer Unterklasse von System), die die Aktion enthält.

Diese Eigenschaft wird von CIM_PolicyAction geerbt.

Zeitstempel

Datentyp: uint8
Zugriffstyp: Lesen/Schreiben

Ruft die Einstellung für den RFC-Zeitstempel ab und legt sie fest. Diese Eigenschaft enthält einen der folgenden Werte:

Wert	Bedeutung
Disabled 0	Deaktivieren Sie die RFC 1323-Zeitstempel.
Aktiviert 1	Aktivieren Sie die RFC 1323-Zeitstempel.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 8
Unterstützte Mindestversion (Server)	Windows Server 2012
Namespace	Root\StandardCimv2
MOF	NetTCPIP.mof
DLL	NetTCPIP.dll

Weitere Informationen

CIM_PolicyAction
NetTCPIP-Anbieterklassen

Freigeben über

MSFT_NetTCPSetting-Klasse

Syntax

Member

Eigenschaften

Anforderungen

Weitere Informationen

Feedback

Zusätzliche Ressourcen