通过

MSFT_DNSClient 类

  • 项目

表示 DNS 客户端。

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

语法

class MSFT_DNSClient : CIM_DNSProtocolEndpoint
{
  string   InstanceId;
  string   Caption;
  string   ElementName;
  datetime InstallDate;
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus[];
  uint16   PrimaryStatus;
  string   OtherEnabledState;
  uint16   RequestedState;
  uint16   EnabledDefault;
  uint16   TransitioningToState;
  string   SystemCreationClassName;
  string   SystemName;
  string   CreationClassName;
  string   Description;
  string   Name;
  uint16   OperationalStatus[];
  uint16   EnabledState[];
  datetime TimeOfLastStateChange;
  string   NameFormat;
  uint16   ProtocolType[];
  uint16   ProtocolIFType;
  string   OtherTypeDescription;
  string   Hostname;
  uint16   DHCPOptionsToUse[];
  uint32   InterfaceIndex;
  string   InterfaceAlias;
  string   ConnectionSpecificSuffix;
  string   ConnectionSpecificSuffixSearchList[];
  boolean  RegisterThisConnectionsAddress;
  boolean  UseSuffixWhenRegistering;
};

成员

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

方法

MSFT_DNSClient 类具有以下方法。

方法 说明
注册 将本地计算机的地址注册到 DNS 服务器。
RequestStateChange 发起更改 DNS 客户端状态的请求。
此方法继承自 CIM_EnabledLogicalElement。

属性

MSFT_DNSClient 类具有以下这些属性。

Caption

数据类型：字符串

访问类型：只读

限定符：MaxLen (64)、Dynamic

获取 DNS 客户端的简短说明。

此属性继承自 CIM_ManagedElement。

CommunicationStatus

数据类型：uint16

访问类型：只读

获取一个值，该值指示 DNS 客户端是否能够与底层 CIM_ManagedElement 对象进行通信。

此属性继承自 CIM_ManagedSystemElement。

此属性包含下列值之一：

值 含义
0
 未知
1
 不可用
2
 通信正常
3
 通信中断
4
 无法联系
5 32767
 DMTF 保留
32768 65535
供应商保留

ConnectionSpecificSuffix

数据类型：字符串

访问类型：读/写

获取并设置 DNS 后缀，以便与接口进行连接。

ConnectionSpecificSuffixSearchList

数据类型：字符串数组

访问类型：只读

获取并设置包含 DNS 后缀的数组，以便与接口进行连接。

CreationClassName

数据类型：字符串

访问类型：只读

限定符：key、MaxLen (256)

获取 DNS 客户端实例的类名称。

此属性继承自 CIM_ServiceAccessPoint 类。

描述

数据类型：字符串

访问类型：只读

限定符：Override（说明）

获取 DNS 客户端的说明。

此属性继承自 CIM_ProtocolEndpoint 类。

DetailedStatus

数据类型：uint16

访问类型：只读

获取有关 DNS 客户端状态的信息，以及 PrimaryStatus 属性提供的信息。

此属性继承自 CIM_ManagedSystemElement。

此属性包含下列值之一：

值 含义
0
 不可用
1
 无更多信息
2
 有压力
3
 预计故障
4
 不可恢复的错误
5
 支持实体出错
5 32767
 DMTF 保留
32768 65535
供应商保留

DHCPOptionsToUse

数据类型：uint16 数组

访问类型：只读

限定符：ModelCorrespondence（CIM_DHCPProtocolEndpoint.OptionsReceived、CIM_DNSSettingData.DHCPOptionsToUse）

获取一个数组，其中包含 DNS 客户端在 DHCP 绑定操作后使用的动态主机配置协议 (DHCP) 选项。

此属性继承自 CIM_DNSProtocolEndpoint 类。

此属性可能包含以下值：

值 含义
8
 域名服务器
14
 主机名
17
 域名
18 32767
 DMTF 保留
32768 65535
 供应商保留

ElementName

数据类型：字符串

访问类型：只读

获取 DNS 客户端的用户友好名称。

此属性继承自 CIM_ManagedElement。

EnabledDefault

数据类型：uint16

访问类型：仅写入

指示 EnabledState 属性的默认启动配置。

默认值：“2”。 此属性继承自 CIM_EnabledLogicalElement。

此属性包含下列值之一：

值 含义
2
 已启用
3
 已禁用
5
 不适用
6
 已启用但脱机
7
 无默认值
8
 Quiesce
9 32767
 DMTF 保留
32768 65535
 供应商保留

EnabledState

数据类型：uint16 数组

访问类型：只读

限定符： ModelCorrespondence (CIM_EnabledLogicalElement.OtherEnabledState)、Override (EnabledState)

获取一个数组，该数组指示 DNS 客户端是否已启用，或者处于某种其他相关状态。

此属性继承自 CIM_ProtocolEndpoint 类。

此属性可以包含下列值之一：

值 含义
0
 未知
1
 其他
2
 已启用
3
 已禁用
4
 正在关闭
5
 重新启动
6
 已启用但脱机
7
 测试中
8
 已推迟
9
 Quiesce
10
 正在启动
11 32767
 DMTF 保留
32768 65535
 供应商保留

HealthState

数据类型：uint16

访问类型：只读

限定符：Experimental

指示 DNS 客户端的当前健康状况。

此属性继承自 CIM_ManagedSystemElement。

此属性包含下列值之一：

值 含义
0
 未知
5
 确定
10
 已降级/警告
15
 次要故障
20
 主要故障
25
 严重故障
30
 不可恢复的错误
31 32767
 DMTF 保留
32768 65535
供应商特定

Hostname

数据类型：字符串

访问类型：仅写入

获取 DNS 客户端连接的主机名称。

此属性继承自 CIM_DNSProtocolEndpoint 类。

InstallDate

数据类型：datetime

访问类型：只读

限定符：MappingStrings (MIF.DMTF|ComponentID|001.5)

获取指示 DNS 客户端何时安装的日期/时间值。

此属性继承自 CIM_ManagedSystemElement。

InstanceId

数据类型：字符串

访问类型：只读

获取此 对象的唯一标识符。 ID 在实例化命名空间的范围内必须是唯一的。

此属性继承自 CIM_ManagedElement。

InterfaceAlias

数据类型：字符串

访问类型：只读

获取客户端的用户友好名称。

InterfaceIndex

数据类型：uint32

访问类型：只读

获取接口的用户友好索引。

Name

数据类型：字符串

访问类型：只读

限定符：MaxLen (256)、key、Override (Name)

获取 DNS 客户端接口的 ID。

此属性继承自 CIM_ProtocolEndpoint 类。

NameFormat

数据类型：字符串

访问类型：只读

限定符：MaxLen (256)

获取 Name 属性的结构，该属性确保名称是唯一的值。

此属性继承自 CIM_ProtocolEndpoint 类。

OperatingStatus

数据类型：uint16 数组

访问类型：只读

限定符：ModelCorrespondence (CIM_EnabledLogicalElement.EnabledState)

获取一个数组，其中包含有关 DNS 客户端的工作状态的信息，以及 EnabledState 属性提供的信息。

此属性继承自 CIM_ManagedSystemElement。

此属性可能包含以下值：

值 含义
0
 未知
1
 不可用
2
 服务
3
 正在启动
4
 正在停止
5
 已停止
6
 已中止
7
 休眠
8
 已完成
9
 迁移
10
 正在迁出
11
 正在迁入
12
 快照
13
 正在关闭
14
 测试中
15
 正在转换
16
 维修中
17 32767
 DMTF 保留
32768 ...
 供应商保留

OperationalStatus

数据类型：uint16 数组

访问类型：只读

限定符：ArrayType (Indexed)、ModelCorrespondence (CIM_ManagedSystemElement.StatusDescriptions)、Override (OperationalStatus)

获取 DNS 客户端的当前状态。

此属性继承自 CIM_ProtocolEndpoint 类。

此属性可以包含下列值之一：

值 含义
0
 未知
1
 其他
2
 确定
3
 已降级
4
 有压力
5
 错误
6
 不可恢复的错误
7
 正在启动
8
 正在停止
9
 已停止
10
 维修中
11
12
 无法联系
13
 通信中断
14
 已中止
15
 休眠
16
 支持实体出错
17
 已完成
18
 电源模式
19 32767
 DMTF 保留
32768 ...
 供应商保留

OtherEnabledState

数据类型：字符串

访问类型：只读

限定符：ModelCorrespondence (CIM_EnabledLogicalElement.EnabledState)

获取当设置为“1”（其他）时，EnabledState 属性的值的说明。

此属性继承自 CIM_EnabledLogicalElement。

OtherTypeDescription

数据类型：字符串

访问类型：只读

限定符：MaxLen (64)、ModelCorrespondence（CIM_ProtocolEndpoint.ProtocolType、CIM_ProtocolEndpoint.ProtocolIFType）

获取一个字符串，该字符串描述当 ProtocolIFType 属性设置为 1 （其他）时，要使用的网络协议；否则，此值必须设置为 null。

此属性继承自 CIM_ProtocolEndpoint 类。

PrimaryStatus

数据类型：uint16

访问类型：只读

限定符：ModelCorrespondence（CIM_ManagedSystemElement.DetailedStatus、CIM_ManagedSystemElement.HealthState）

获取 DNS 客户端的高级状态。

此属性继承自 CIM_ManagedSystemElement。

此属性包含下列值之一：

值 含义
0
 未知
1
 确定
2
 已降级
3
 错误
4 32767
 DMTF 保留
32768 65535
供应商保留

ProtocolIFType

数据类型：uint16

访问类型：只读

限定符：ModelCorrespondence (CIM_ProtocolEndpoint.OtherTypeDescription)

获取 DNS 客户端支持的网络协议。

此属性继承自 CIM_ProtocolEndpoint 类。

此属性可能包含以下值：

值 含义
0
 未知
1
 其他
2
 Regular 1822
3
 HDH 1822
4
 DDN X.25
5
 RFC877 X.25
6
 以太网 CSMA/CD
7
 ISO 802.3 CSMA/CD
8
 ISO 802.4 令牌总线
9
 ISO 802.5 令牌环
10
 ISO 802.6 MAN
11
 StarLAN
12
 Proteon 10Mbit
13
 Proteon 80Mbit
14
 HyperChannel
15
 Fddi
16
 LAP-B
17
 SDLC
18
 DS1
19
 E1
20
 基本 ISDN
21
 主要 ISDN
22
 专有的点到点串行
23
 PPP
24
 软件环回
25
 EON
26
 以太网 3Mbit
27
 NSIP
28
 SLIP
29
 超高性能
30
 DS3
31
 SIP
32
 帧中继
33
 RS-232
34
 并行程序
35
 ARCNet
36
 ARCNet Plus
37
 ATM
38
 MIO X.25
39
 SONET
40
 X.25 PLE
41
 ISO 802.211c
42
 LocalTalk
43
 SMDS DXI
44
 帧中继服务
45
 V.35
46
 HSSI
47
 HIPPI
48
 调制解调器
49
 AAL5
50
 SONET 路径
51
 SONET VT
52
 SMDS ICIP
53
 专有虚拟/内部
54
 专有多路复用器
55
 IEEE 802.12
56
 光纤通道
57
 HIPPI 接口
58
 帧中继互连
59
 适用于 802.3 的 ATM 仿真 LAN
60
 适用于 802.5 的 ATM 仿真 LAN
61
 ATM 仿真电路
62
 快速以太网 (100BaseT)
63
 ISDN
64
 V.11
65
 V.36
66
 64K 速率下的 G703
67
 2Mb 速率下的 G703
68
 QLLC
69
 快速以太网 100BaseFX
70
 Channel
71
 IEEE 802.11
72
 IBM 260/370 OEMI 通道
73
 ESCON
74
 数据链接切换
75
 ISDN S/T 接口
76
 ISDN U 接口
77
 LAP-D
78
 IP 交换机
79
 远程源路由桥接
80
 ATM 逻辑
81
 DS0
82
 DS0 捆绑
83
 BSC
84
 异步
85
 战斗网电台
86
 ISO 802.5r DTR
87
 Ext Pos Loc 报告系统
88
 AppleTalk 远程访问协议
89
 专有无连接
90
 ITU X.29 主机 PAD
91
 ITU X.3 终端 PAD
92
 帧中继 MPI
93
 ITU X.213
94
 ADSL
95
 RADSL
96
 SDSL
97
 VDSL
98
 ISO 802.5 CRFP
99
 Myrinet
100
 语音接收和传输
101
 语音外部交换局
102
 语音外部交换服务
103
 语音封装
104
 IP 语音
105
 ATM DXI
106
 ATM FUNI
107
 ATM IMA
108
 PPP 多链路捆绑
109
 IP over CDLC
110
 IP over CLAW
111
 堆栈到堆栈
112
 虚拟 IP 地址
113
 MPC
114
 IP over ATM
115
 ISO 802.5j 光纤令牌环
116
 TDLC
117
 千兆位以太网
118
 HDLC
119
 LAP-F
120
 V.37
121
 X.25 MLP
122
 X.25 智能寻线
123
 Transp HDLC
124
 交错通道
125
 FAST 通道
126
 IP（适用于 IP 网络中的 APPN）
127
 CATV MAC 层
128
 CATV 下游
129
 CATV 上游
130
 Avalon 12MPP 交换机
131
 隧道
132
 咖啡
133
 电路仿真服务
134
 ATM 子接口
135
 使用 802.1Q 的第 2 层 VLAN
136
 使用 IP 的第 3 层 VLAN
137
 使用 IPX 的第 3 层 VLAN
138
 数字电源线
139
 通过 IP 的多媒体邮件
140
 DTM
141
 DCN
142
 IP 转发
143
 MSDSL
144
 IEEE 1394
145
 IF-GSN/HIPPI-6400
146
 DVB-RCC MAC 层
147
 DVB-RCC 下游
148
 DVB-RCC 上游
149
 ATM 虚拟
150
 MPLS 隧道
151
 SRP
152
 ATM 语音
153
 帧中继语音传送
154
 ISDL
155
 复合链路
156
 SS7 信令链路
157
 专有 P2P 无线
158
 帧转发
159
 通过 ATM 的 RFC1483 多协议
160
 USB
161
 IEEE 802.3ad 链路聚合
162
 BGP 策略计帐
163
 FRF .16 多链路 FR
164
 H.323 守护程序
165
 H.323 代理
166
 MPLS
167
 多频信令链路
168
 HDSL-2
169
 S-HDSL
170
 DS1 设施数据链路
171
 通过 SONET/SDH 传输的数据包
172
 DVB-ASI 输入
173
 DVB-ASI 输出
174
 电源线
175
 非设施关联信令
176
 TR008
177
 GR303 RDT
178
 GR303 RDT
179
 ISUP
180
 专有无线 MAC 层
181
 专有无线下游
182
 专有无线上游
183
 HIPERLAN 类型 2
184
 专有宽带无线接入点到多点
185
 SONET 开销通道
186
 数字包装器开销通道
187
 ATM 适配层 2
188
 无线电 MAC
189
 ATM 无线电
190
 计算机间中继
191
 MVL DSL
192
 长读 DSL
193
 帧中继 DLCI 终结点
194
 ATM VCI 终结点
195
 光学通道
196
 光学传输
197
 专有 ATM
198
 有线电视电缆语音传输
199
 Infiniband
200
 TE 链路
201
 Q.2931
202
 虚拟中继组
203
 SIP 中继组
204
 SIP 信号
205
 CATV 上游通道
206
 Econet
207
 FSAN 155Mb PON
208
 FSAN 622Mb PON
209
 透明网桥
210
 线路组
211
 语音 E&M 功能组
212
 语音 FGD EANA
213
 语音 DID
214
 MPEG 传输
215
 6to4
216
 GTP
217
 Paradyne EtherLoop 1
218
 Paradyne EtherLoop 2
219
 光学通道组
220
 HomePNA
221
 Gfp
222
 ciscoISLvlan
223
 actelisMetaLOOP
224
 Fcip
225 4095
 IANA 保留
4096
 IPv4
4097
 IPv6
4098
 IPv4/v6
4099
 IPX
4100
 DECnet
4101
 SNA
4102
 CONP
4103
 CLNP
4104
 VINES
4105
 XNS
4,106
 ISDN B 通道终结点
4107
 ISDN D 通道终结点
4108
 BGP
4109
 OSPF
4110
 UDP
4111
 TCP
4112
 802.11a
4113
 802.11b
4114
 802.11g
4115
 802.11h
4200
 NFS
4201
 CIFS
4202
 DAFS
4203
 WebDAV
4204
 HTTP
4205
 FTP
4300
 NDMP
4400
 Telnet
4401
 SSH
4402
 SM CLP
4403
 SMTP
4404
 LDAP
4405
 RDP
4406
 HTTPS
4407 32767
 DMTF 保留
32768 ...
 供应商保留

ProtocolType

数据类型：uint16 数组

访问类型：只读

限定符：ModelCorrespondence (CIM_ProtocolEndpoint.OtherTypeDescription)、Override (EnabledState)、Deprecated (CIM_ProtocolEndpoint.ProtocolIFType)

注意

此属性已弃用。 相反，我们建议你使用 CIM_ProtocolEndpoint.ProtocolIFType 属性。

获取 DNS 客户端支持的网络协议。

此属性继承自 CIM_ProtocolEndpoint 类。

此属性可能包含以下值：

值 含义
0
 未知
1
 其他
2
 IPv4
3
 IPv6
4
 IPX
5
 AppleTalk
6
 DECnet
7
 SNA
8
 CONP
9
 CLNP
10
 VINES
11
 XNS
12
 ATM
13
 帧中继
14
 以太网
15
 TokenRing
16
 Fddi
17
 Infiniband
18
 光纤通道
19
 ISDN BRI 终结点
20
 ISDN B 通道终结点
21
 ISDN D 通道终结点
22
 IPv4/v6
23
 BGP
24
 OSPF
25
 MPLS
26
 UDP
27
 TCP

RegisterThisConnectionsAddress

数据类型：boolean

访问类型：读/写

指示是否向 DNS 注册当前连接的地址。

RequestedState

数据类型：uint16

访问类型：只读

指示 DNS 客户端的最后一个请求状态。 客户端的实际状态通过 EnabledState 属性表示。

默认值：“12”

此属性继承自 CIM_EnabledLogicalElement。

此属性包含下列值之一：

值 含义
0
 未知
2
 已启用
3
 已禁用
4
 关闭
5
 无更改
6
 脱机
7
 测试
8
 已推迟
9
 Quiesce
10
 重新启动
11
 重置
12
 不适用
13 32767
 DMTF 保留
32768 65535
 供应商保留

Status

数据类型：字符串

访问类型：只读

限定符：MaxLen (10)、Deprecated (CIM_ManagedSystemElement.OperationalStatus)

注意

此属性已弃用。 请改为使用 OperationalStatus。

获取 DNS 客户端的状态。

此属性继承自 CIM_ManagedSystemElement。

此属性包含下列值之一：

值 含义
确定
 DNS 客户端正常工作且没有错误。
错误
 DNS 客户端遇到错误。
已降级
 DNS 客户端正常工作，但某些功能已关闭。
未知
 DNS 客户端的状态未知。
故障预警
 DNS 客户端遇到故障预警。
正在启动
 DNS 客户端正在启动。
正在停止
 DNS 客户端正在关闭。
服务
 DNS 客户端正在维修。
有压力
 DNS 客户端遇到性能问题。
不可恢复
 DNS 客户端出错，无法恢复。
无法联系
 与 DNS 客户端没有联系。
通信丢失
 与 DNS 客户端的通信已丢失。
已停止
 DNS 客户端没有运行，但可以重新启动 DNS 客户端。

StatusDescriptions

数据类型：字符串数组

访问类型：只读

限定符：ArrayType (Indexed)、ModelCorrespondence (CIM_ManagedSystemElement.OperationalStatus)

获取一个字符串数组，它描述了 OperationalStatus 属性中的相应数组值的详细信息。

此属性继承自 CIM_ManagedSystemElement。

SystemCreationClassName

数据类型：字符串

访问类型：只读

限定符：key, MaxLen (256)、Propagated (CIM_System.CreationClassName)

获取托管 DNS 客户端的系统对象的类名称。

此属性继承自 CIM_ServiceAccessPoint 类。

SystemName

数据类型：字符串

访问类型：只读

限定符：key、MaxLen (256)、Propagated (CIM_System.Name)

获取托管 DNS 客户端的系统的名称。

此属性继承自 CIM_ServiceAccessPoint 类。

TimeOfLastStateChange

数据类型：datetime

访问类型：只读

限定符：Override (TimeOfLastStateChange)

获取一个日期/时间值，它指示 EnabledState 属性上次更改的时间。

TransitioningToState

数据类型：uint16

访问类型：只读

限定符：ModelCorrespondence (CIM_EnabledLogicalElement.RequestStateChange、CIM_EnabledLogicalElement.RequestedState、CIM_EnabledLogicalElement.EnabledState)

获取 DNS 客户端将转换到的状态。

此属性继承自 CIM_EnabledLogicalElement。

值 含义
0
 未知
2
 已启用
3
 已禁用
4
 关闭
5
 无更改
6
 脱机
7
 测试
8
 延迟
9
 Quiesce
10
 重新启动
11
 重置
12
 不适用
13 ...
 DMTF 保留

UseSuffixWhenRegistering

数据类型：boolean

访问类型：读/写

指示是否在 DNS 注册过程中为连接使用 DNS 后缀。

要求
最低受支持的客户端
 Windows 8
支持的最低服务器版本
 Windows Server 2012
命名空间
 Root\StandardCimv2
MOF
DnsClientCim.mof
DLL
DnsClientCim.dll

另请参阅

Dnsclientcim 提供程序类