共用方式為

CIM_ServiceAccessPoint類別

  • 發行項

CIM_ServiceAccessPoint代表利用或叫用服務的能力。 存取點表示服務可供其他實體使用。

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

語法

[UMLPackagePath("CIM::Core::Service"), Abstract, Version("2.10.0"), AMENDMENT]
class CIM_ServiceAccessPoint : CIM_EnabledLogicalElement
{
  string   InstanceID;
  string   Caption;
  string   Description;
  string   ElementName;
  datetime InstallDate;
  uint16   OperationalStatus[];
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 5;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   TransitioningToState = 12;
  uint16   AvailableRequestedStates[];
  string   Name;
  string   SystemCreationClassName;
  string   SystemName;
  string   CreationClassName;
};

成員

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

方法

CIM_ServiceAccessPoint 類別具有這些方法。

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

屬性

CIM_ServiceAccessPoint 類別具有這些屬性。

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
已保留。

CreationClassName

數據類型： 字串

存取類型：唯讀

限定符： 金鑰、 MaxLen （256）

指出在建立實例時所使用的類別或子類別的名稱。 搭配這個類別的其他索引鍵屬性使用時，這個屬性允許唯一識別此類別及其子類別的所有實例。

說明

數據類型： 字串

存取類型：唯讀

提供物件的文字描述。

此屬性繼承自 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
已保留。

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”）

指出項目的啟用和停用狀態。 它也可以指出這些要求狀態之間的轉換。 例如，關閉 （value=4） 和 starting （value=10） 是啟用和停用之間的暫時性狀態。

此屬性繼承自 CIM_EnabledLogicalElement。

值 意義
Unknown
0
其他
1
已啟用
2
 元素是或可能執行命令、會處理任何已排入佇列的命令，以及將新要求排入佇列。
停用
3
 專案不會執行命令，而且會卸除任何新的要求。
關閉
4
 元素正在進入 「已停用」狀態。
不適用
5
 項目不支援啟用或停用。
已啟用但離線
6
 元素可能正在完成命令，而且將會卸除任何新的要求。
在測試中
7
 項目處於測試狀態。
遞延
8
 元素可能正在完成命令，但會將任何新的要求排入佇列。
靜止
9
 元素已啟用，但處於受限制模式。 項目的行為類似於 Enabled 狀態 （2），但它只會處理一組受限制的命令。 所有其他要求都會排入佇列。
正在啟動
10
 元素正在進入 Enabled 狀態 （2） 的過程中。 新的要求會排入佇列。
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_ManagedElement。

名稱

數據類型： 字串

存取類型：唯讀

限定符：MaxLen （256），機碼，覆寫 （“Name”）

唯一識別服務存取點 （SAP），並提供受控功能指示。 在物件的 Description 屬性中會更詳細地描述這項功能。

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 為 5 （「無變更」）。 如需 RequestedState 列舉中值的說明，請參閱 EnabledState 屬性描述。 請注意，RequestedState 中有兩個新值會以 EnabledState 的狀態為基礎。 這些是「重新啟動」（10）和「重設」（11）。 重新啟動是指執行「關機」，然後移至「已啟用」狀態。 [重設] 表示元素會先是 “Disabled”，然後是 “Enabled”。 也應該注意要求「關機」和「已停用」之間的差異。 關閉要求有條不紊地轉換至 [已停用] 狀態，且可能涉及移除電源，以完全清除任何現有的狀態。 Disabled 狀態會要求立即停用元素，使其不會執行或接受任何命令或處理要求。 此屬性會設定為方法調用的結果（例如 CIM_Service 上的 StartService 或 StopService），也可以在子類別中覆寫並定義為 WRITEable。 方法方法會被視為優於 WRITEable 屬性，因為它允許明確叫用作業和傳回結果碼。 CIM_EnabledLogicalElement的特定實例可能不支援 RequestStateChange。 如果發生這種情況，則會使用值 12 （「不適用」）。

此屬性繼承自 CIM_EnabledLogicalElement。

未知 （0）

已開啟 （2）

已 停用 （3）

關機 （4）

無變更 （5）

離線 （6）

測試 （7）

延遲 （8）

靜止 （9）

重新啟動 （10）

重設 （11）

不適用 （12）

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。

SystemCreationClassName

數據類型： 字串

存取類型：唯讀

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

範圍系統的 CreationClassName。

SystemName

數據類型： 字串

存取類型：唯讀

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

範圍系統的名稱。

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

另請參閱

CIM_EnabledLogicalElement