共用方式為

MSFT_NetUDPEndpoint類別

  • 發行項

代表 Microsoft TCP/IP WMI v2 提供者的 UDP 連線。

下列語法已經過受管理物件格式 (MOF) 程式碼簡化，並包含所有已繼承的屬性。

語法

[UMLPackagePath("CIM::Network::Pipes"), ClassVersion("1.0.0"), dynamic, provider("nettcpip"), AMENDMENT]
class MSFT_NetUDPEndpoint : MSFT_NetTransportConnection
{
  string   Caption;
  string   Description;
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[];
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  string   OtherEnabledState;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   TransitioningToState = 12;
  uint16   AvailableRequestedStates[];
  string   InstanceID;
  uint16   EnabledState;
  uint16   RequestedState = 5;
  uint16   Directionality;
  uint16   AggregationBehavior;
  string   LocalAddress;
  uint16   LocalPort;
};

成員

MSFT_NetUDPEndpoint類別具有下列類型的成員：

方法

MSFT_NetUDPEndpoint 類別具有這些方法。

方法 描述
RequestStateChange 要求將專案的狀態變更為 RequestedState 參數中指定的值。 當要求的狀態變更發生時，專案的啟用狀態和要求狀態會相同。 叫用 RequestChangeState 方法多次可能會導致先前的要求遭到覆寫或遺失。 如果傳回 0，則工作已順利完成，且不需要使用 CIM_ConcreteJob 。 如果傳回 4096 （0x1000），則工作需要一些時間才能完成， 就會建立CIM_ConcreteJob ，並在輸出參數 Job 中傳回其參考。 任何其他傳回碼都表示錯誤狀況。
此方法繼承自 CIM_EnabledLogicalElement。

屬性

MSFT_NetUDPEndpoint類別具有這些屬性。

AggregationBehavior

數據類型： uint16

存取類型：唯讀

指出管線是否由較低層級管道組成，如果是的話，這些較低層級管道的匯總方式（平行或循序）。 使用 NetworkPipeComposition 關聯來描述合併之 NetworkPipe 的特定實例。

此屬性繼承自 CIM_NetworkPipe。

未知 （0）

沒有較低層級的組合 （2）

平行 結合 （3）

依序 合併 （4）

AvailableRequestedStates

數據類型： uint16 陣列

存取類型：唯讀

限定符： ModelCorrespondence （“CIM_EnabledLogicalElement.RequestStateChange”、“CIM_EnabledLogicalElementCapabilities.RequestedStatesSupported”）

AvailableRequestedStates 表示用來起始狀態變更之 RequestStateChange 方法 RequestedState 參數的可能值。 列出的值應該是CIM_EnabledLogicalElementCapabilities相關聯實例的 RequestedStatesSupported 屬性中包含的值子集，其中選取的值是CIM_EnabledLogicalElement目前狀態的函式。 如果實作能夠將可能值集公告為目前狀態的函式，這個屬性可能是非 Null。 如果實作無法將可能值集合判斷為目前狀態的函式，則此屬性應該是 null。

此屬性繼承自 CIM_EnabledLogicalElement。

已開啟 （2）

已 停用 （3）

關機 （4）

離線 （6）

測試 （7）

延遲 （8）

靜止 （9）

重新啟動 （10）

重設 （11）

DMTF 保留 （12 65535）

標題

數據類型： 字串

存取類型：唯讀

限定符： MaxLen （64）

包含物件的簡短文字描述。

此屬性繼承自 CIM_ManagedElement。

CommunicationStatus

數據類型： uint16

存取類型：唯讀

表示檢測能夠與這個項目通訊。 NULL 值表示檢測不支援此屬性。

此屬性繼承自 CIM_ManagedSystemElement。

值 意義
Unknown
0
 表示檢測目前無法報告 CommunicationStatus 屬性。
無法使用
1
 表示檢測能夠報告這個屬性，但刻意不會針對這個專案。
通訊正常
2
 僅表示與專案建立通訊。
遺失通訊
3
 表示過去已連絡專案，但目前無法連線。
無連絡人
4
 表示檢測具有這個專案的連絡資訊，但從未能夠與其通訊。
DMTF 保留
5 32767
 已保留。
廠商保留
32768 = value
已保留。

說明

數據類型： 字串

存取類型：唯讀

提供物件的文字描述。

此屬性繼承自 CIM_ManagedElement。

DetailedStatus

數據類型： uint16

存取類型：唯讀

限定符： ModelCorrespondence （“CIM_EnabledLogicalElement.PrimaryStatus”、“CIM_ManagedSystemElement.HealthState”）

指出補充 PrimaryStatus 屬性的其他狀態詳細數據。 NULL 值表示檢測不支援這個屬性。

此屬性繼承自 CIM_ManagedSystemElement。

值 意義
無法使用
0
 表示檢測能夠報告這個屬性，但刻意不會報告這個項目的檢測。
沒有其他資訊
1
 指出沒有詳細數據必須新增至 PrimaryStatus 屬性，例如，當 PrimaryStatus 設定為 [確定] 時。
強調
2
 表示專案函式，但需要注意。 超載和過熱是壓力狀態的範例。
預測性失敗
3
 表示項目名義上運作，但會預測近期的失敗。
無法復原的錯誤
4
 表示此元素處於需要人為介入的錯誤狀況。
支援錯誤中的實體
5
 指出這個專案相依的項目發生錯誤。 此元素可能 沒問題 ，但因相依專案的狀態而無法運作。 例如，網路服務或端點因低層網路問題而無法運作。
DMTF 保留
6 32767
 已保留。
廠商保留
32768 = value
已保留。

方向性

數據類型： uint16

存取類型：唯讀

表示管道的方向性。 針對單向管道，來源和接收會以關聯 EndpointOfNetworkPipe 的屬性 （SourceOrSink） 表示。

此屬性繼承自 CIM_NetworkPipe。

未知 （0）

雙向 （2）

單向 （3）

ElementName

數據類型： 字串

存取類型：唯讀

包含物件的使用者易記名稱。 這個屬性可讓每個實例除了定義其索引鍵屬性、身分識別數據和描述資訊之外，還定義使用者易記的名稱。

此屬性繼承自 CIM_ManagedElement。

EnabledDefault

數據類型： uint16

存取類型：讀取/寫入

列舉值，表示系統管理員針對元素的啟用狀態的預設或啟動組態。 根據預設，元素為 “Enabled” （value=2）。

此屬性繼承自 CIM_EnabledLogicalElement。

已開啟 （2）

已 停用 （3）

不適用 （5）

已啟用但離線 （6）

無預設值 （7）

靜止 （9）

DMTF 保留 （10 32767）

廠商保留 （32768 65535）

EnabledState

數據類型： uint16

存取類型：唯讀

限定符： ModelCorrespondence （“CIM_EnabledLogicalElement.OtherEnabledState”）

EnabledState 是整數列舉，表示元素的啟用和停用狀態。 它也可以指出這些要求狀態之間的轉換。 例如，關閉 （value=4） 和 starting （value=10） 是啟用和停用之間的暫時性狀態。

此屬性繼承自 CIM_NetworkPipe。

值 意義
Unknown
0
 項目狀態未知。
其他
1
 元素處於此處所列以外的狀態。
已啟用
2
 元素是或可能執行命令、會處理任何已排入佇列的命令，以及將新要求排入佇列。
停用
3
 專案不會執行命令，而且會卸除任何新的要求。
關閉
4
 元素正在進入 「已停用」狀態。
不適用
5
 項目不支援啟用或停用。
已啟用但離線
6
 元素可能正在完成命令，而且將會卸除任何新的要求。
在測試中
7
 項目處於測試狀態。
遞延
8
 元素可能正在完成命令，但會將任何新的要求排入佇列。
靜止
9
 元素已啟用，但處於受限制模式。
正在啟動
10
 元素正在進入 Enabled 狀態。 新的要求會排入佇列。
DMTF 保留
11 32767
廠商保留
32768 65535

HealthState

數據類型： uint16

存取類型：唯讀

表示專案的目前健康情況。 這個屬性表示這個專案的健康情況，但不一定表示其子元件的健康情況。

此屬性繼承自 CIM_ManagedSystemElement。

值 意義
Unknown
0
 目前無法報告 HealthState 的實作。
確定
5
 元素功能完整，且在一般操作參數內運作，且沒有錯誤。
降級/警告
10
 元素是工作順序，而且會提供所有功能。 不過，元素無法發揮其最佳功能。 例如，元素可能無法以最佳效能運作，或可能報告可復原的錯誤
次要失敗
15
 所有功能都可供使用，但有些功能可能會降級。
主要失敗
20
 項目失敗。 此元件的某些或所有功能可能已降級或無法運作。
重大失敗
25
 項目無法運作，而且可能無法復原。
無法復原的錯誤
30
 元素已完全失敗，而且無法復原。 這個專案提供的所有功能都已遺失。
DMTF 保留
31 = value
DMTF 已保留持續性的未使用部分，以供未來其他 HealthStates 值使用。

InstallDate

數據類型： datetime

存取類型：唯讀

指出物件安裝的時間。 缺少值並不表示未安裝 物件。

此屬性繼承自 CIM_ManagedSystemElement。

InstanceID

數據類型： 字串

存取類型：唯讀

限定符： 索引鍵

唯一且不透明地識別這個類別在包含命名空間的範圍內實例。

[!重要]為了確保命名空間內的唯一性，應該以下列模式建構 InstanceID 的值：

OrgID：LocalID

OrgID 必須包含由定義 InstanceID 之商業實體所擁有的著作權、商標或其他唯一名稱，或是由已辨識的全域授權單位指派的已註冊標識符。 這類似於 Schema 類別名稱的結構。 此外，為了確保 InstanceID 中的第一個冒號必須介於 OrgID 和LocalID 之間。 在那裡，OrgID 不得包含冒號 （'：'）。

LocalID 是由商業實體選擇，不應重新用來識別不同的基礎真實世界元素。

如果未使用上述模式，定義實體必須確保由此或這個命名空間的其他提供者所產生的任何 InstanceID 不會重複使用產生的 InstanceID。

針對分散式管理工作組 （DMTF） 定義的實例，模式必須與設定為 CIM 的 OrgID 搭配使用。

此屬性繼承自 CIM_NetworkPipe。

LocalAddress

數據類型： 字串

存取類型：唯讀

傳輸連線的本機位址。

此屬性繼承自 MSFT_NetTransport連線 ion。

LocalPort

數據類型： uint16

存取類型：唯讀

傳輸連線的本機埠。

此屬性繼承自 MSFT_NetTransport連線 ion。

名稱

數據類型： 字串

存取類型：唯讀

限定符： MaxLen （1024）

指出此作業實例的使用者易記名稱。 此外，使用者易記的名稱也可以當做搜尋或查詢的屬性使用。

[!提示]
名稱 在命名空間內不一定是唯一的。

此屬性繼承自 CIM_ManagedSystemElement。

OperatingStatus

數據類型： uint16

存取類型：唯讀

限定符： ModelCorrespondence （“CIM_EnabledLogicalElement.EnabledState”）

表示專案的目前作業條件。 這個屬性可用來提供專案目前狀態的詳細數據。 它也可以指出過渡狀態。 NULL 值表示檢測不支援這個屬性。

此屬性繼承自 CIM_ManagedSystemElement。

值 意義
Unknown
0
 表示檢測目前無法報告 OperatingStatus 屬性。
無法使用
1
 表示檢測能夠報告這個屬性，但刻意不會報告這個項目的檢測。
服務
2
 表示專案正在處理中，以設定、維護、清除或管理。
正在啟動
3
 表示專案正在初始化。
正在停止
4
 表示專案正被帶至有序停止。
已停止
5
 表示已刻意停止專案。
已中止
6
 表示專案以非預期的方式停止。
休眠
7
 表示專案為非使用中或已靜止。
已完成
8
 表示專案已完成其作業。 建議您使用OK、Error或Degraded的 PrimaryStatus 屬性值，以指出作業成功或失敗。
移轉
9
 表示專案正在主項目之間移動。
移民
10
 表示專案正從主元素移開。
移民
11
 表示專案正在移至新的主專案。
快照集
12
 表示正在建立專案的快照集復本。
關閉
13
 表示專案正在突然停止。
在測試中
14
 表示專案正在執行測試函式。
過渡
15
 表示項目位於狀態之間，且兩種狀態都無法完全使用。 使用另一個值，指出如果有的話，表示更具體的轉換。
在服務中
16
 表示專案在服務中且可運作。
DMTF 保留
17 32767
 已保留。
廠商保留
32768 = value
已保留。

OperationalStatus

數據類型： uint16 陣列

存取類型：唯讀

限定符：ArrayType （“Indexed”），ModelCorrespondence （“CIM_ManagedSystemElement.StatusDescriptions”）

包含專案目前狀態的指標。 OperationalStatus 的第一個值應該包含專案的主要狀態。

注意

OperationalStatus 會取代已被 取代的 Status 屬性。 由於在管理應用程式中廣泛使用現有的 Status 屬性，Microsoft 強烈建議提供者或檢測同時提供 Status 和 OperationalStatus 屬性。 檢測時， Status （因為它是單一值），也應該提供專案的主要狀態。

此屬性繼承自 CIM_ManagedSystemElement。

值 意義
Unknown
0
 表示目前無法報告 OperationalStatus 的實作。
其他
1
 表示未定義的狀態。
確定
2
 表示完整功能，而不會發生錯誤。
已降級
3
 表示專案正在運作，並且會提供所有功能。 不過，元素無法發揮其最佳功能。 例如，元素可能無法以最佳效能運作，或可能報告可復原的錯誤
強調
4
 表示元素正常運作，但需要注意。 超載和過熱是壓力狀態的範例。
預測性失敗
5
 表示項目在名義上運作，但預測近期失敗。
錯誤
6
 表示發生錯誤。
無法復原的錯誤
7
 發生無法復原的錯誤。
正在啟動
8
 作業正在啟動。
正在停止
9
 作業正在停止。
已停止
10
 元素已刻意停止。
在服務中
11
 表示正在設定、維護、清除或管理的專案。
無連絡人
12
 表示監視系統具備此元素的知識，但從未能夠與其建立通訊。
遺失通訊
13
 表示已知作業存在，且過去已成功連絡，但目前無法連線。
已中止
14
 表示作業以非預期的方式停止。 可能需要更新作業的狀態和組態。
休眠
15
 表示作業為非使用中狀態。
支援錯誤中的實體
16
 指出此作業相依的項目發生錯誤。 這個元素可能沒 問題 ，但因為相依專案的狀態而無法運作。 例如，網路服務或端點因低層網路問題而無法運作。
已完成
17
 表示作業已完成其作業。 此值應該與 OK、ErrorError 或 Degraded 結合，讓用戶端可以判斷完成的作業已完成與 OK（已傳遞）、已完成錯誤（失敗），或已完成且已降級的作業（作業已完成，但未完成確定或未回報錯誤）。
Power Mode
18
 “Power Mode” 表示元素具有包含在相關聯 PowerManagementService 關聯中的其他電源模型資訊。
DMTF 保留
19 32767
 DMTF 已保留此範圍的這個部分，以供日後的其他 OperationalStatus 值使用。
廠商保留
32768 65535
 Microsoft 已保留範圍中未使用的部分，以供日後的其他 OperationalStatus 值使用。

OtherEnabledState

數據類型： 字串

存取類型：唯讀

限定符： ModelCorrespondence （“CIM_EnabledLogicalElement.EnabledState”）

字串，描述 EnabledState 屬性設定為 1 時元素的啟用或停用狀態（「其他」）。 當 EnabledState 是 1 以外的任何值時，這個屬性必須設定為 null。

此屬性繼承自 CIM_EnabledLogicalElement。

PrimaryStatus

數據類型： uint16

存取類型：唯讀

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

表示高階狀態值。

此屬性繼承自 CIM_ManagedSystemElement。

可能的值為 。

未知 （0）

確定 （1）

降級 （2）

錯誤 （3）

DMTF 保留 （4 32767）

廠商保留 （32768 = 值 ）

RequestedState

數據類型： uint16

存取類型：讀取/寫入

限定符： ModelCorrespondence （“CIM_EnabledLogicalElement.EnabledState”）

RequestedState 是一個整數列舉，指出元素的最後一個要求或所需狀態，不論其要求的機制為何。 項目的實際狀態是由 EnabledState 表示。 提供這個屬性來比較上次要求和目前啟用或停用的狀態。 請注意，當 EnabledState 設定為 5 （“不適用”），則此屬性沒有意義。 如需 RequestedState 列舉中值的說明，請參閱 EnabledState 屬性描述。

此屬性繼承自 CIM_NetworkPipe。

值 意義
Unknown
0
 元素的最後一個要求狀態未知。
已啟用
2
停用
3
 會要求立即停用 專案，使其不會執行或接受任何命令或處理要求。
關閉
4
 要求有條不紊地轉換至 [已停用] 狀態，且可能涉及移除電源，以完全清除任何現有的狀態。
無變更
5
 取代表示最後一個要求狀態為 「未知」（0）。 如果最後一個要求或所需狀態未知，RequestedState 應該有值 “Unknown” （0），但可能有值 “No Change” （5）。
離線
6
 元素已要求轉換為 Enabled 但離線 EnabledState。
Test
7
遞延
8
靜止
9
重新啟動
10
 是指執行「關機」，然後移至「已啟用」狀態。
重設
11
 [重設] 表示元素會先是 “Disabled”，然後是 “Enabled”。
不適用
12
 EnabledLogicalElement 不支持最後一個 RequestedState 的知識。
DMTF 保留
13 32767
廠商保留
32768 65535

狀態

數據類型： 字串

存取類型：唯讀

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

包含字串，指出物件的主要狀態。

注意

這個屬性已被取代，並由 OperationalStatus 屬性取代。 如果您選擇使用 Status 屬性進行回溯相容性，它應該次要於 OperationalStatus 屬性。

此屬性繼承自 CIM_ManagedSystemElement。

可能的值為 。

（“OK”）

（“錯誤”）

（“已降級”）

（“未知”）

（“Pred Fail”）

（“起始”）

（“停止”）

（“服務”）

（“壓力”）

（“NonRecover”）

（“無聯繫人”）

（“Lost Comm”）

（“已停止”）

StatusDescriptions

數據類型： 字串 陣列

存取類型：唯讀

限定符：ArrayType （“Indexed”），ModelCorrespondence （“CIM_ManagedSystemElement.OperationalStatus”）

指出 OperationalStatus 陣列中對應值的描述。 例如，如果 OperationalStatus 屬性中的元素包含 Stopping 值，則此屬性中相同陣列索引的專案可能會包含停止物件原因的說明。

此屬性繼承自 CIM_ManagedSystemElement。

TimeOfLastStateChange

數據類型： datetime

存取類型：唯讀

上次變更專案啟用狀態的日期或時間。 如果元素的狀態尚未變更，而且已填入此屬性，則必須將它設定為 0 間隔值。 如果要求狀態變更，但遭到拒絕或尚未處理，則不得更新 屬性。

此屬性繼承自 CIM_EnabledLogicalElement。

TransitioningToState

數據類型： uint16

存取類型：唯讀

限定符： ModelCorrespondence （“CIM_EnabledLogicalElement.RequestStateChange”、“CIM_EnabledLogicalElement.RequestedState”、“CIM_EnabledLogicalElement.EnabledState”）

TransitioningToState 表示實例正在轉換的目標狀態。

值為 5 「無變更」，表示沒有任何轉換正在進行中。值 12 「不適用」應表示實作不支援表示進行中的轉換。

5 或 12 以外的值應該識別元素在轉換過程中的狀態。

此屬性繼承自 CIM_EnabledLogicalElement。

未知 （0）

已開啟 （2）

已 停用 （3）

關機 （4）

無變更 （5）

離線 （6）

測試 （7）

延遲 （8）

靜止 （9）

重新啟動 （10）

重設 （11）

不適用 （12）

DMTF 保留 （13 65535）

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