Win32_NetworkAdapterConfiguration 类的 EnableDNS 方法

EnableDNSWMI 类静态方法为服务启用域名系统 (DNS) 。

本主题使用托管对象格式 (MOF) 语法。 有关使用此方法的详细信息，请参阅 调用方法。

语法

uint32 EnableDNS(
  [in, optional] string DNSHostName,
  [in, optional] string DNSDomain,
  [in, optional] string DNSServerSearchOrder[],
  [in, optional] string DNSDomainSuffixSearchOrder[]
);

参数

DNSHostName [in， optional]

此方法启用的 DNS 主机的名称。

示例：“corpdns”

DNSDomain [in， optional]

表示一个组织名称，后跟一个句点和一个指示组织类型的扩展名。

示例：“microsoft.com”

DNSServerSearchOrder [in， optional]

要查询 DNS 服务器的服务器 IP 地址列表。

DNSDomainSuffixSearchOrder [in， optional]

在名称解析期间追加到主机名的 DNS 域后缀。 从仅主机名解析完全限定的域名 (FQDN) 时，系统会追加本地域名。 如果名称解析不成功，系统将使用域后缀列表按列出的顺序创建其他 FQDN，然后查询每个 FQDN 的 DNS 服务器。

返回值

如果不需要重新启动，则返回一个值 0 (零) 的成功完成，在需要重新启动时返回 1 (一个) ，如果出现错误，则返回任何其他数字。 有关错误代码的详细信息，请参阅 WMI 错误常量 或 WbemErrorEnum。 有关常规 HRESULT 值，请参阅 系统错误代码。

成功完成，无需重启

0

成功完成，无需重启。

成功完成，需要重新启动

1

成功完成，需要重新启动。

此平台上不支持的方法

64

此平台不支持方法。

未知失败

65

未知失败。

子网掩码无效

66

子网掩码无效。

处理返回的实例时出错

67

处理返回的实例时出错。

无效的输入参数

68

输入参数无效。

指定的网关数超过 5 个

69

指定的网关超过 5 个。

无效的 IP 地址

70

IP 地址无效。

网关 IP 地址无效

71

网关 IP 地址无效。

访问注册表以获取请求的信息时出错

72

访问注册表以获取请求的信息时出错。

无效的域名

73

无效的域名。

主机名无效

74

主机名无效。

未定义主/辅助 WINS 服务器

75

未定义主 WINS 服务器或辅助 WINS 服务器。

文件无效

76

文件无效。

系统路径无效

77

系统路径无效。

文件复制失败

78

文件复制失败。

无效的安全参数

79

无效的安全参数。

无法配置 TCP/IP 服务

80

无法配置 TCP/IP 服务。

无法配置 DHCP 服务

81

无法配置 DHCP 服务。

无法续订 DHCP 租约

82

无法续订 DHCP 租约。

无法释放 DHCP 租约

83

无法释放 DHCP 租约。

适配器上未启用 IP

84

适配器上未启用 IP。

适配器上未启用 IPX

85

适配器上未启用 IPX。

帧/网络编号边界错误

86

帧或网络编号边界错误。

无效的帧类型

87

无效的帧类型。

网络编号无效

88

网络号码无效。

重复的网络号码

89

重复的网络号码。

参数超出边界

90

参数超出边界。

访问被拒绝

91

访问被拒绝。

内存不足

92

内存不足。

已存在

93

已存在。

找不到路径、文件或对象

94

找不到路径、文件或对象。

无法通知服务

95

无法通知服务。

无法通知 DNS 服务

96

无法通知 DNS 服务。

接口不可配置

97

接口不可配置。

并非所有 DHCP 租约都可以释放/续订

98

并非所有 DHCP 租约都可以释放或续订。

适配器上未启用 DHCP

100

适配器上未启用 DHCP。

其他

101 4294967295

示例

下面的代码示例取自 TechNet 库 上启用所有网络适配器上的 DNS VBScript 代码示例，为计算机上的所有网络适配器启用 DNS。

On Error Resume Next 
 
strComputer = "." 
Set objWMIService = GetObject("winmgmts:" _ 
    & "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2") 
 
Set objNetworkSettings = objWMIService.Get("Win32_NetworkAdapterConfiguration") 
strHostName = "fabrikam1" 
arrDNSSuffixes = Array("hr.fabrikam.com", "research.fabrikam.com") 
objNetworkSettings.EnableDNS strHostName, , , arrDNSSuffixes 

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
命名空间	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

另请参阅

计算机系统硬件类

Win32_NetworkAdapterConfiguration

WMI 任务：网络

WMI 任务：帐户和域

WMI 中的 IPv6 和 IPv4 支持