MSFT_NetTCPSetting 类

2025-03-11

表示Microsoft TCP/IP（Internet 协议套件）WMIv2 提供程序的 TCP 参数设置。

以下语法从托管对象格式（MOF）代码简化，并包括所有继承的属性。

语法

[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;
};

成员

MSFT_NetTCPSetting 类具有以下类型的成员：

属性

属性

MSFT_NetTCPSetting 类具有以下属性。

AutomaticUseCustom

数据类型：uint8
访问类型：读/写

获取并设置一个值，该值指示自动模板设置是指定自定义模板还是默认模板。此属性可以包含以下值之一。

价值	意义
禁用 0	自动模板设置指定默认模板。
已启用 1	自动模板设置指定自定义模板。

AutoReusePortRangeNumberOfPorts

数据类型：uint16
访问类型：读/写

从 AutoReusePortRangeStartPort 属性开始的端口数，用于自动重用端口范围。

**Windows 8.1、Windows Server 2012 R2、Windows 8 和 Windows Server 2012： **

Windows 10 和 Windows Server 2016 之前不支持此属性。

AutoReusePortRangeStartPort

数据类型：uint16
访问类型：读/写

开始在 1025 和 65535 之间自动重复使用端口号。

**Windows 8.1、Windows Server 2012 R2、Windows 8 和 Windows Server 2012： **

Windows 10 和 Windows Server 2016 之前不支持此属性。

AutoTuningLevelEffective

数据类型：uint8
访问类型：只读

获取一个值，该值指示自动优化级别是由组策略还是本地设置决定。

价值	意义
本地 0	自动优化级别由本地设置确定。
GroupPolicy 1	自动优化级别由组策略决定。

AutoTuningLevelGroupPolicy

数据类型：uint8
访问类型：只读

获取和设置组策略的自动优化级别。此参数可以包含以下值之一。

价值	意义
禁用 0	自动优化级别处于禁用状态。
高度受限 1	自动优化级别高度受限。
受限 2	自动优化级别受到限制。
普通 3	自动优化级别正常。
实验性 4	自动优化级别是实验性的。

AutoTuningLevelLocal

数据类型：uint8
访问类型：读/写

获取和设置本地自动优化级别。此属性包含以下值之一。

价值	意义
禁用 0
高度受限 1	高度受限
受限 2
普通 3
实验性 4

标题

数据类型：字符串
访问类型：只读
限定符：MaxLen （64）

包含对象的简短文本说明。

此属性继承自 CIM_ManagedElement。

CommonName

数据类型：字符串
访问类型：只读

此策略相关对象的用户友好名称。

此属性继承自 CIM_Policy。

CongestionProvider

数据类型：uint8
访问类型：读/写

获取和设置 TCP 拥塞提供程序设置。此属性包含以下值之一。

价值	意义
默认 0
2	复合 TCP （TCPP）
DCTCP 3	数据中心 TCP （DCTCP）

CreationClassName

数据类型：字符串
访问类型：只读
限定符：密钥、MaxLen （256）

指示在创建实例时使用的类或子类的名称。与此类的其他键属性一起使用时，此属性允许唯一标识此类及其子类的所有实例。

此属性继承自 CIM_PolicyAction。

CwndRestart

数据类型：uint8
访问类型：读/写

获取并设置一个值，该值指示是否重新启动拥挤的窗口。此属性包含以下值之一。

价值	意义
禁用 0	未重启拥挤的窗口。
已启用 1	将重启拥挤的窗口。

DelayedAckFrequency

数据类型：uint8
访问类型：读/写

获取并设置未解析的确认数（ACK），这将导致忽略 ACK 计时器。此参数值的范围可以是 1 到 255。

DelayedAckTimeout

数据类型：uint32
访问类型：读/写

获取并设置 TCP 延迟的 ACK 超时（以毫秒为单位）。此属性可以包含从 10 到 600 的值。

说明

数据类型：字符串
访问类型：只读

提供对象的文本说明。

此属性继承自 CIM_ManagedElement。

DoActionLogging

数据类型：布尔
访问类型：只读

导致在执行作时生成日志消息。

此属性继承自 CIM_PolicyAction。

DynamicPortRangeNumberOfPorts

数据类型：uint16
访问类型：读/写

获取和设置动态端口范围内的端口数。

DynamicPortRangeStartPort

数据类型：uint16
访问类型：读/写

获取和设置动态端口范围的起始端口。该属性可以包含介于 1 和 65535 之间的值。

EcnCapability

数据类型：uint8
访问类型：读/写

获取和设置显式拥塞通知（ECN）功能。此属性包含以下值之一。

价值	意义
禁用 0	ECN 已禁用。
已启用 1	已启用 ECN。

ElementName

数据类型：字符串
访问类型：只读

包含对象的用户友好名称。此属性允许每个实例定义用户友好名称，以及其关键属性、标识数据和说明信息。

此属性继承自 CIM_ManagedElement。

ForceWS

数据类型：uint8
访问类型：读/写

获取和设置一个值，该值指示是否启用强制窗口缩放。

Windows 8 和 Windows Server 2012： 在 Windows 8.1 和 Windows Server 2012 R2 之前不支持此属性。

价值	意义
禁用 0	强制窗口缩放已禁用。
已启用 1	已启用强制窗口缩放。

InitialCongestionWindow

数据类型：uint32
访问类型：读/写

获取并设置初始拥塞窗口的最大段大小。属性值范围为 2 到 64。

InitialRto

数据类型：uint32
访问类型：读/写

获取并设置重新传输超时（以毫秒为单位）。此属性的默认值为 3000。

InstanceID

数据类型：字符串
访问类型：只读

在包含命名空间的范围内，唯一且不透明地标识此类的实例。

[!重要提示]为了确保命名空间中的唯一性，应使用以下模式构造 InstanceID 的值：

OrgID：LocalID

OrgID 必须包含由定义 InstanceID的业务实体拥有的版权、商标或其他唯一名称，或者是已识别的全局颁发机构分配的已注册 ID。这类似于 Schema 类名称的结构。此外，为了确保唯一性，InstanceID 中的第一个冒号必须在 OrgID 和LocalID之间。因此 ，OrgID 不得包含冒号（'：'）。

LocalID 由业务实体选择，不应重新用于标识不同的基础真实元素。

如果未使用上述模式，定义实体必须确保在此命名空间或其他提供程序生成的任何 InstanceID之间不会重新使用生成的 InstanceID。

对于分布式管理任务组（DMTF）定义的实例，该模式必须与设置为 CIM OrgID 一起使用。

此属性继承自 CIM_ManagedElement。

MaxSynRetransmissions

数据类型：uint8
访问类型：读/写

获取并设置尝试重新建立与 SYN 数据包的连接的次数。此属性可以包含范围为 2 到 8 的值。

Windows 8 和 Windows Server 2012： 在 Windows 8.1 和 Windows Server 2012 R2 之前不支持此属性。

MemoryPressureProtection

数据类型：uint8
访问类型：读/写

获取和设置内存压力保护设置。此属性包含以下值之一。

价值	意义
禁用 0	禁用内存压力保护。
已启用 1	启用内存压力保护。
默认 2	将内存压力保护状态还原到系统默认值。

MinRto

数据类型：uint32
访问类型：读/写

获取并设置 TCP 重新传输超时（以毫秒为单位）。属性值的范围可以是 20 毫秒到 300 毫秒。

NonSackRttResiliency

数据类型：uint8
访问类型：读/写

获取和设置一个值，该值为不支持选择性确认（SACK）的客户端启用 Round-Trip 时间（RTT）复原能力。

Windows 8 和 Windows Server 2012： 在 Windows 8.1 和 Windows Server 2012 R2 之前不支持此属性。

价值	意义
禁用 0	为不支持 SACK 的客户端禁用 RTT 复原能力。
已启用 1	为不支持 SACK 的客户端启用 RTT 复原能力。

PolicyActionName

数据类型：字符串
访问类型：只读
限定符：密钥、MaxLen （256）

此策略作的用户友好名称。

此属性继承自 CIM_PolicyAction。

PolicyKeywords

数据类型：字符串 数组
访问类型：只读

用于描述/分类策略对象的关键字数组。关键字属于以下两种类型之一：

此 MOF 和其他 MOF 中定义的关键字，或在 DMTF 白皮书中定义。这些关键字提供一种独立于供应商、独立于安装的方式来描述策略对象。
用于描述策略对象的依赖安装的关键字。示例包括“工程”、“计费”和“2000 年 12 月评审”。

此 MOF 定义了以下关键字：UNKNOWN、CONFIGURATION、USAGE、SECURITY、SERVICE、MOTIVATIONAL、INSTALLATION和 EVENT。这些概念是自我解释的，并在 SLA/策略白皮书中进一步讨论。定义了一个附加关键字：POLICY。此关键字的作用是识别某些实现中可能不可识别的策略相关实例。策略关键字不是上述其他关键字的互斥。

此属性继承自 CIM_Policy。

PolicyRuleCreationClassName

数据类型：字符串
访问类型：只读
限定符：密钥、MaxLen （256）

对于特定于规则的策略作，CreationClassName 与此作关联的策略规则对象。对于可重用的策略作，应使用特殊值“NO RULE”来指示此作是可重用的，而不是与单个策略规则关联的。

此属性继承自 CIM_PolicyAction。

PolicyRuleName

数据类型：字符串
访问类型：只读
限定符：密钥、MaxLen （256）

对于特定于规则的策略作，此作与之关联的策略规则对象的名称。对于可重用的策略作，应使用特殊值“NO RULE”来指示此作是可重用的，而不是与单个策略规则关联的。

此属性继承自 CIM_PolicyAction。

ScalingHeuristics

数据类型：uint8
访问类型：读/写

获取并设置一个值，该值指示是否启用窗口缩放启发式。

价值	意义
禁用 0	窗口缩放启发式已禁用。
已启用 1	已启用窗口缩放启发式。

SettingName

数据类型：字符串
访问类型：只读

获取设置的名称。此属性包含以下值之一。

DatacenterCustom
InternetCustom
数据中心
Compat
Internet
自动

SystemCreationClassName

数据类型：字符串
访问类型：只读
限定符：密钥、MaxLen （256）

类或子类的名称，用于在其中定义此策略作范围的 System 对象。

此属性有助于标识此策略作实例所在的系统对象。对于特定于规则的策略作，这是定义策略规则的上下文中的系统。对于可重用的策略作，这是保存作的 PolicyRepository 实例（这是 System 的子类）。

请注意，此属性和类似属性 SystemName，不表示从类 System 实例传播的键。相反，它们是在此类上下文中定义的属性，这些属性重复此策略作相关的系统实例中的值，无论是直接通过策略作 InPolicyRepository 关联还是间接通过 PolicyActionInPolicyRule 聚合。

此属性继承自 CIM_PolicyAction。

SystemName

数据类型：字符串
访问类型：只读
限定符：密钥、MaxLen （256）

定义此策略作范围的系统对象的名称。

此属性完成系统对象的标识，其作用域内存在此策略作实例。对于特定于规则的策略作，这是定义策略规则的上下文中的系统。对于可重用的策略作，这是保存作的 PolicyRepository 实例（这是 System 的子类）。

此属性继承自 CIM_PolicyAction。

时间戳

数据类型：uint8
访问类型：读/写

获取和设置 RFC 时间戳设置。此属性包含以下值之一。

价值	意义
禁用 0	禁用 TCP 时间戳。
已启用 1	在出站连接上启用 TCP 时间戳，并允许入站连接使用 TCP 时间戳。
允许 2	如果传入连接尝试协商 TCP 时间戳，请启用 TCP 时间戳。

要求


支持的最低客户端	Windows 8操作系统
支持的最低服务器	Windows Server 2012
Namespace	Root\StandardCimv2
MOF	NetTCPIP.mof
DLL	NetTCPIP.dll

另请参阅

CIM_PolicyAction
NetTCPIP 提供程序类

通过

MSFT_NetTCPSetting 类

语法

成员

属性

要求

另请参阅

反馈

其他资源