Win32_NetworkAdapterConfiguration 类的 SetDNSSuffixSearchOrder 方法
SetDNSSuffixSearchOrderWMI 类静态方法使用字符串元素数组来设置后缀搜索顺序。
本主题使用托管对象格式 (MOF) 语法。 有关使用此方法的详细信息，请参阅 调用方法。
语法
uint32 SetDNSSuffixSearchOrder(
[in] string DNSDomainSuffixSearchOrder[]
);
参数
-
DNSDomainSuffixSearchOrder [in]
-
要查询 DNS 服务器的服务器后缀列表。 DNS 后缀的注册表位置 HKEY_LOCAL_MACHINE\System\CurrentControlSet\服务\Tcpip|NameServer
示例：“suffix1.company.com”、“suffix2.company.com”
返回值
如果不需要重新启动，则返回一个值 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
备注
这是一个独立于实例的调用，适用于所有适配器，但仅适用于 Windows。
示例
修改所有网络适配器的 DNS 后缀搜索顺序 VBScript 代码示例将计算机配置为在执行 DNS 搜索时使用两个 DNS 后缀。
在计算机上 启用 DHCP 设置 VBScript 示例配置在计算机上启用 DHCP 通常需要的所有设置。
以下 PowerShell 代码设置 DNS 后缀搜索顺序。
#First store the suffixes to set in a variable
$suffixes = 'microsoft.com', 'google.com', 'yahoo.com'
#Since this is a static method, get a class object and then call the method.
$class = [wmiclass]'Win32_NetworkAdapterConfiguration'
$class.SetDNSSuffixSearchOrder($suffixes)
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows Vista |
| 最低受支持的服务器 |
Windows Server 2008 |
| 命名空间 |
Root\CIMV2 |
| MOF |
|
| DLL |
|