共用方式為

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 類別具有這些屬性。

標題

數據類型： 字串

存取類型：唯讀

限定符：MaxLen （64），動態

取得 DNS 用戶端的簡短描述。

此屬性繼承自 CIM_ManagedElement。

CommunicationStatus

數據類型： uint16

存取類型：唯讀

取得值，這個值表示 DNS 用戶端能夠與基礎 CIM_ManagedElement 對象通訊。

此屬性繼承自 CIM_ManagedSystemElement。

此屬性包含下列其中一個值：

值 意義
0
 Unknown
1
 無法使用
2
 通訊正常
3
 遺失通訊
4
 無連絡人
5 32767
 DMTF 保留
32768 65535
廠商保留

ConnectionSpecificSuffix

數據類型： 字串

存取類型：讀取/寫入

取得和設定介面連線的 DNS 後綴。

ConnectionSpecificSuffixSearchList

數據類型： 字串 陣列

存取類型：唯讀

取得和設定陣列，其中包含介面每個連線的 DNS 後綴。

CreationClassName

數據類型： 字串

存取類型：唯讀

限定符： 金鑰、 MaxLen （256）

取得 DNS 用戶端實例的類別名稱。

此屬性繼承自 CIM_ServiceAccessPoint 類別。

說明

數據類型： 字串

存取類型：唯讀

限定符： 覆寫 （描述）

取得 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
 Host Name
17
 網域名稱
18 32767
 DMTF Reserverd
32768 65535
 廠商保留

ElementName

數據類型： 字串

存取類型：唯讀

取得 DNS 用戶端的使用者易記名稱。

此屬性繼承自 CIM_ManagedElement。

EnabledDefault

數據類型： uint16

存取類型：僅限寫入

指出 EnabledState 屬性的預設啟動組態。

默認值：「2」。。 此屬性繼承自 CIM_EnabledLogicalElement。

此屬性包含下列其中一個值：

值 意義
2
 已啟用
3
 已停用
5
 不適用
6
 已啟用但離線
7
 無預設值
8
 靜止
9 32767
 DMTF 保留
32768 65535
 廠商保留

EnabledState

數據類型： uint16 陣列

存取類型：唯讀

限定符： ModelCorrespondence （CIM_EnabledLogicalElement.OtherEnabledState）、 Override （EnabledState）

取得陣列，指出 DNS 用戶端已啟用或處於某些其他相關狀態。

此屬性繼承自 CIM_ProtocolEndpoint 類別。

這個屬性可以包含下列其中一個值：

值 意義
0
 Unknown
1
 其他
2
 已啟用
3
 已停用
4
 關閉
5
 重新啟動
6
 已啟用但離線
7
 在測試中
8
 已延遲
9
 靜止
10
 啟動中
11 32767
 DMTF 保留
32768 65535
 廠商保留

HealthState

數據類型： uint16

存取類型：唯讀

限定符： 實驗性

指出 DNS 用戶端目前的健全狀況。

此屬性繼承自 CIM_ManagedSystemElement。

此屬性包含下列其中一個值：

值 意義
0
 Unknown
5
 確定
10
 降級/警告
15
 次要失敗
20
 主要失敗
25
 重大失敗
30
 無法復原的錯誤
31 32767
 DMTF 保留
32768 65535
廠商特定

主機名稱

數據類型： 字串

存取類型：僅限寫入

取得 DNS 用戶端連線的主機名。

此屬性繼承自 CIM_DNSProtocolEndpoint 類別。

InstallDate

數據類型： datetime

存取類型：唯讀

限定符： MappingStrings （MIF.DMTF|ComponentID|001.5）

取得 datetime 值，指出 DNS 用戶端安裝的時間。

此屬性繼承自 CIM_ManagedSystemElement。

InstanceId

數據類型： 字串

存取類型：唯讀

取得這個物件的唯一標識符。 標識碼在具現化命名空間的範圍內必須是唯一的。

此屬性繼承自 CIM_ManagedElement。

InterfaceAlias

數據類型： 字串

存取類型：唯讀

取得介面的用戶易記名稱。

InterfaceIndex

數據類型： uint32

存取類型：唯讀

取得介面的用戶易記索引。

名稱

數據類型： 字串

存取類型：唯讀

限定符： MaxLen （256）， 機碼， 覆寫 （名稱）

取得 DNS 用戶端介面的識別碼。

此屬性繼承自 CIM_ProtocolEndpoint 類別。

NameFormat

數據類型： 字串

存取類型：唯讀

限定符： MaxLen （256）

取得 Name 屬性的結構 ，這可確保 Name 是唯一值。

此屬性繼承自 CIM_ProtocolEndpoint 類別。

OperatingStatus

數據類型： uint16 陣列

存取類型：唯讀

限定符： ModelCorrespondence （CIM_EnabledLogicalElement.EnabledState）

取得陣列，其中包含 DNS 用戶端作業狀態的相關信息，以及 EnabledState 屬性所提供的資訊。

此屬性繼承自 CIM_ManagedSystemElement。

這個屬性可以包含下列值：

值 意義
0
 Unknown
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
 Unknown
1
 其他
2
 [確定]
3
 已降級
4
 強調
5
 錯誤
6
 無法復原的錯誤
7
 啟動中
8
 正在停止
9
 已停止
10
 在服務中
11
12
 無連絡人
13
 遺失通訊
14
 已中止
15
 睡眠狀態的
16
 支援實體錯誤
17
 已完成
18
 Power Mode
19 32767
 DMTF 保留
32768 ...
 廠商保留

OtherEnabledState

數據類型： 字串

存取類型：唯讀

限定符： ModelCorrespondence （CIM_EnabledLogicalElement.EnabledState）

取得當 EnabledState 屬性值設定為 「1」 時的描述（其他）。

此屬性繼承自 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
 Unknown
1
 [確定]
2
 已降級
3
 錯誤
4 32767
 DMTF 保留
32768 65535
廠商保留

ProtocolIFType

數據類型： uint16

存取類型：唯讀

限定符： ModelCorrespondence （CIM_ProtocolEndpoint.OtherTypeDescription）

取得 DNS 用戶端所支援的網路協定。

此屬性繼承自 CIM_ProtocolEndpoint 類別。

這個屬性可以包含下列值：

值 意義
0
 Unknown
1
 其他
2
 一般 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 Token Ring
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
 Software Loopbac
25
 宙
26
 乙太網路 3Mbit
27
 NSIP
28
 滑
29
 Ultra
30
 DS3
31
 SIP
32
 Frame Relay
33
 RS-232
34
 Parallel
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
 Frame Relay Service
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
 ATM 模擬 LAN 802.3
60
 ATM 模擬 LAN 802.5
61
 ATM 模擬線路
62
 快速乙太網路 （100BaseT）
63
 ISDN
64
 V.11
65
 V.36
66
 G703 在 64K
67
 G703 at 2Mb
68
 QLLC
69
 快速乙太網路 100BaseFX
70
 通道
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
 Async
85
 戰鬥網無線電
86
 ISO 802.5r DTR
87
 Ext Pos Loc 報表系統
88
 AppleTalk 遠端訪問通訊協定
89
 專屬的無連線
90
 ITU X.29 Host PAD
91
 ITU X.3 終端機 PAD
92
 Frame Relay 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
 透過CDLC的IP
110
 透過 CLAW 的 IP
111
 堆疊到堆疊
112
 虛擬 IP 位址
113
 MPC
114
 透過 ATM 的 IP
115
 ISO 802.5j 光纖令牌通道
116
 TDLC
117
 Gigabit Ethernet
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 HPR）
127
 CATV MAC 層
128
 CATV 下游
129
 CATV 上游
130
 Avalon 12MPP 參數
131
 Tunnel
132
 咖啡
133
 線路模擬服務
134
 ATM SubInterface
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
 自動取款機語音
153
 Voice over Frame Relay
154
 ISDL
155
 復合連結
156
 SS7 訊號連結
157
 專屬 P2P 無線
158
 框架正向
159
 透過 ATM RFC1483 Multiprotocol
160
 USB
161
 IEEE 802.3ad 鏈接匯總
162
 BGP 原則會計
163
 FRF .16 Multilink FR
164
 H.323 閘道守衛
165
 H.323 Proxy
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
 專屬寬頻無線存取點至 Mulipoint
185
 SONET 額外負荷通道
186
 數字包裝函式額外通道
187
 ATM 適配層 2
188
 無線電 MAC
189
 ATM 無線電
190
 機器間主幹
191
 MVL DSL
192
 Long Read DSL
193
 Frame Relay 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
4,101
 SNA
4102
 CONP
4103
 CLNP
4104
 藤 蔓
4105
 XNS
4,106
 ISDN B 通道端點
4107
 ISDN D 通道端點
4108
 BGP
4109
 OSPF
4,110
 UDP
4111
 TCP
4112
 802.11a
4113
 802.11b
4,114
 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）、已淘汰 （CIM_ProtocolEndpoint.ProtocolIFType）

注意

這個屬性已被取代。 相反地，我們建議您使用 CIM_ProtocolEndpoint.ProtocolIFType 屬性。

取得 DNS 用戶端所支援的網路協定。

此屬性繼承自 CIM_ProtocolEndpoint 類別。

這個屬性可以包含下列值：

值 意義
0
 Unknown
1
 其他
2
 IPv4
3
 IPv6
4
 IPX
5
 AppleTalk
6
 DECnet
7
 SNA
8
 CONP
9
 CLNP
10
 藤 蔓
11
 XNS
12
 ATM
13
 Frame Relay
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

數據類型： 布爾值

存取類型：讀取/寫入

指出是否要向 DNS 註冊目前連線的位址。

RequestedState

數據類型： uint16

存取類型：唯讀

指出 DNS 用戶端的最後一個要求狀態。 用戶端的實際狀態是由 EnabledState 屬性表示。

默認值：「12」。。

此屬性繼承自 CIM_EnabledLogicalElement。

此屬性包含下列其中一個值：

值 意義
0
 Unknown
2
 已啟用
3
 已停用
4
 關閉
5
 無變更
6
 離線
7
 Test
8
 已延遲
9
 靜止
10
 重新啟動
11
 Reset
12
 不適用
13 32767
 DMTF 保留
32768 65535
 廠商保留

狀態

數據類型： 字串

存取類型：唯讀

限定符： MaxLen （10）， 已 淘汰 （CIM_ManagedSystemElement.OperationalStatus）

注意

這個屬性已被取代。 請改用 OperationalStatus。

取得 DNS 用戶端的狀態。

此屬性繼承自 CIM_ManagedSystemElement。

此屬性包含下列其中一個值：

值 意義
[確定]
 DNS 用戶端運作時沒有錯誤。
錯誤
 DNS 用戶端發生錯誤。
已降級
 DNS 用戶端運作正常，但某些功能已關閉。
Unknown
 DNS 用戶端的狀態未知。
預先失敗
 DNS 用戶端發生預測性失敗。
啟動中
 DNS 用戶端正在啟動。
正在停止
 DNS 用戶端正在關閉。
服務
 DNS 用戶端正在服務中。
強調
 DNS 用戶端發生效能問題。
NonRecover
 DNS 用戶端發生錯誤且無法復原。
無連絡人
 DNS 用戶端沒有連絡。
遺失的 Comm
 已遺失與 DNS 用戶端的通訊。
已停止
 不過，DNS 用戶端並未執行，可能會重新啟動 DNS 用戶端。

StatusDescriptions

數據類型： 字串 陣列

存取類型：唯讀

限定符：ArrayType （Indexed）、ModelCorrespondence （CIM_ManagedSystemElement.OperationalStatus）

取得字串陣列，描述 OperationalStatus 屬性中對應陣列值的詳細數據。

此屬性繼承自 CIM_ManagedSystemElement。

SystemCreationClassName

數據類型： 字串

存取類型：唯讀

限定符： key、 MaxLen （256）、 傳播 （CIM_System.CreationClassName）

取得裝載 DNS 用戶端之系統物件的類別名稱。

此屬性繼承自 CIM_ServiceAccessPoint 類別。

SystemName

數據類型： 字串

存取類型：唯讀

限定符： 索引鍵、 MaxLen （256）、 傳播 （CIM_System.Name）

取得裝載 DNS 用戶端的系統名稱。

此屬性繼承自 CIM_ServiceAccessPoint 類別。

TimeOfLastStateChange

數據類型： datetime

存取類型：唯讀

限定符： 覆寫 （TimeOfLastStateChange）

取得 datetime 值，指出上次變更 EnabledState 屬性的時間。

TransitioningToState

數據類型： uint16

存取類型：唯讀

限定符： ModelCorrespondence （CIM_EnabledLogicalElement.RequestStateChange， CIM_EnabledLogicalElement.RequestedState， CIM_EnabledLogicalElement.EnabledState）

取得 DNS 用戶端轉換的目標狀態。

此屬性繼承自 CIM_EnabledLogicalElement。

值 意義
0
 Unknown
2
 已啟用
3
 已停用
4
 關閉
5
 無變更
6
 離線
7
 Test
8
 延遲
9
 靜止
10
 重新啟動
11
 Reset
12
 不適用
13 ...
 DMTF 保留

UseSuffixWhenRegistering

數據類型： 布爾值

存取類型：讀取/寫入

指出是否要在 DNS 註冊期間使用連線的 DNS 後綴。

需求
最低支援的用戶端
 Windows 8
最低支援的伺服器
 Windows Server 2012
Namespace
 Root\StandardCimv2
MOF
DnsClientCim.mof
DLL
DnsClientCim.dll

另請參閱

Dnsclientcim 提供者類別