WMI 类 Win32_NetworkAdapterConfiguration管理网卡的一个参数介绍

功能简介:

管理客户端上的 DHCP
虽然 DHCP 已经是一种自动化方式，但是使用脚本可以帮助您自动配置一组客户端以利用 DHCP。通过 WMI 类 Win32_NetworkAdapterConfiguration 提供的属性和方法，您可以枚举 DHCP 设置，启用或禁用 DHCP，以及续订或中止租约。

开发参数介绍

表 9 说明了可用于 IP 地址分配的 Win32_NetworkAdapterConfiguration 属性。
表 9

属性	类型	说明
DefaultIPGateway	字符串数组	计算机系统使用的默认网关的 IP 地址数组。
DHCPEnabled	布尔	如果是 True，DHCP 服务器会在建立网络连接时自动为计算机系统分配一个 IP 地址
DHCPLeaseExpires	datetime	DHCP 服务器为计算机分配的租用 IP 地址的到期日期和时间。
DHCPLeaseObtained	datetime	DHCP 服务器为计算机分配的 IP 地址获得租约的日期和时间。
DHCPServer	字符串	DHCP 服务器的 IP 地址。
GatewayCostMetric	Uint16	用于计算最快、最可靠或最廉价路由的整数成本跃点数值（从 1 到 9999）数组。这个参数与 DefaultIPGateway 属性之间存在一一对应关系。
IPConnectionMetric（Windows XP 的新增属性）	Uint32	绑定了 IP 的适配器的已配置路由的使用成本；对于 IP 路由表中的路由来说，这是一个加权值。如果在 IP 路由表中有多个指向目标计算机的路由，将使用跃点数最少的路由。默认值是 1。
IPAddress	字符串	与当前网络适配器相关的所有 IP 地址构成的数组。
IPSubnet	字符串	与当前网络适配器相关的所有子网掩码构成的数组。

上表中的所有属性都是只读的。

类型 uint16 和 uint32 是由强类型编程语言使用的无符号整数类型；VBScript 可将它们有效地作为整数进行处理。

表 10 描述了可用于 IP 地址分配的 Win32_NetworkAdapterConfiguration 方法。
表 10 Win32_NetworkAdapterConfiguration IP 地址分配方法

方法	参数	说明
EnableDHCP	无	为使用这个网络适配器的服务启用 DHCP。DHCP 允许动态分配 IP 地址。
EnableStatic	IPAddress – 字符串数组 SubnetMask – 字符串数组	为目标网络适配器启用静态 TCP/IP 寻址。这样便会对此网络适配器禁用 DHCP。
ReleaseDHCPLease	无	释放已绑定到启用了 DHCP 的特定网络适配器的 IP 地址。警告 如果在本地计算机上启用 DHCP，该选项会对这个特定的网络适配器禁用 TCP/IP。如果您没有访问目标系统的其他路径（即另一个绑定 TCP/IP 的网络适配器），所有 TCP/IP 通信都会中断。
ReleaseDHCPLeaseAll	无	静态方法。释放已绑定到所有启用了 DHCP 的网络适配器的 IP 地址。

警告 如果在本地计算机上启用 DHCP，此选项将终止所有的 DHCP TCP/IP 连接。
RenewDHCPLease
无
续订启用了 DHCP 的特定网络适配器上的 IP 地址。DHCP 服务器分配的 IP 地址的租约有一个截止日期；如果客户端打算继续使用分配的 IP 地址，就必须进行续订。
RenewDHCPLeaseAll
无
静态方法。续订所有启用了 DHCP 的网络适配器的 IP 地址。DHCP 服务器分配的 IP 地址的租约有一个截止日期；如果客户端打算继续使用分配的 IP 地址，就必须进行续订。
SetGateways
DefaultIPGateway – 字符串数组
GatewayCostMetric – unit16
指定一个网关列表，这些网关用于将数据包路由到该网络适配器连接的子网以外的子网。该方法仅在网络适配器处于静态 IP 模式时才有效。
上表中的所有方法都返回一个正整数：

返回值	说明
0	表示成功完成
1	表示成功完成，并需要重新启动。
大于 1 的数字	表示出现了某种问题，方法无法完成。

WMI SDK 列出了这些方法的返回值的含义。