標準限定詞

發行項
05/12/2022

所有符合 CIM 標準的實作都必須處理一組標準限定詞。任何特定物件都不會列出所有限定詞。延伸模組類別通常會提供額外的限定詞，以協助布建類別實例和其他作業。

提供者必須負責強制執行限定詞。 WMI 不會強制執行限定詞，而是只使用這些限定詞來通知使用者如何使用屬性。

注意

WMI 符合 CIM 2.5 規格。

限定詞有下列限制：

並非所有標準限定詞都可以一起使用。
並非所有限定詞都可以套用至所有建構，例如關聯或參考。這些限制會在 [套用至] 清單中加以識別。
對於特定建構，例如關聯或參考，可以進一步限制使用法律限定詞，因為某些限定詞互斥，使用一個限定詞可能表示另一個限定詞的值有一些限制等等。記錄這些使用規則。
法律限定詞是由屬性、方法、實例或子類別等實體所繼承，而不是由關聯或參考所繼承。例如，套用至屬性的 MaxLen 限定詞不會由參考繼承。

下列列出 WMI 標準限定詞。

抽象

資料類型： 布林值

適用于：類別、關聯、指示

指出類別是否為抽象，而且只做為新類別的基底。預設值為 FALSE。您無法建立抽象類別的實例。缺少這個限定詞表示類別不是抽象的;因此，所有抽象類別都需要此限定詞。

骨料

資料類型： 布林值

適用于：參考

指出參考是否為匯總關聯之父元件。預設值為 FALSE。

使用方式：匯總和匯總限定詞會一起使用匯總限定關聯， 而 Aggregate 會指定父系參考。

聚集

資料類型： 布林值

適用于：關聯

指出關聯是否為匯總。預設值為 FALSE。搭配匯總使用。所有匯總關聯都需要此限定詞。

別名

資料類型：字串

適用于：屬性、參考、方法

架構中屬性或方法的替代名稱。預設值為 Null。

ArrayType

資料類型：字串

適用于：屬性、參數

限定陣列的類型。

有效值為：

包 (預設)
索引
排序

使用方式：將此類型的限定詞套用至使用括弧語法) 所定義的陣列 (的屬性和參數。

點陣圖

資料類型： 字串陣列

適用于：屬性、方法、參數

位位置的對應，其中每個顯著位置可以是「開啟」或「關閉」。每個「on」位都會對應至 BitValues 陣列中的對應值。如果有多個位「開啟」， 則會指出 BitValues 陣列中的多個並行值。預設值為 Null。

如需詳細資訊，請參閱 BitMap 和 BitValues。

BitValues

資料類型： 字串陣列

適用于：屬性、方法、參數

將位位置值轉譯成相關聯的字串。預設值為 Null。

如需詳細資訊，請參閱 BitMap 和 BitValues。

構造函數

資料類型： 布林值

適用于：方法

指出方法是否建立實例。這些方法不會限制在單一實例或單一類別上運作。例如，建構函式可以建立關聯實例，以及定義建構函式之類別的實例。

建構函式限定詞僅供資訊使用，而且不預期它由物件管理員處理。建立物件時，物件管理員不需要呼叫建構函式方法。此外，呼叫建構函式時，物件管理員不需要叫用針對原始類別的任何父類別所定義的建構函式方法。預設值為 FALSE。

CreateBy

資料類型：字串

適用于：類別

建立這個類別實例的方法名稱。此值為「PutInstance」或另一個建立實例的方法名稱。預設值為 Null。

使用方式：只有在 SupportsCreate 限定詞存在時，才能使用此限定詞。

DeleteBy

資料類型：字串

適用于：類別

刪除這個類別實例的方法名稱。此值為「DeleteInstance」，或另一個刪除實例的方法名稱。預設值為 Null。

使用方式：只有在 SupportsDelete 限定詞存在時，才能使用此限定詞。

描述

資料類型：字串

適用于：任何

具名專案的描述。預設值為 Null。

析構函數

資料類型： 布林值

適用于：方法

指出方法是否刪除實例。使用 解構函 式辨識符號的方法會刪除套用解構函式 (實例) ，而且不會限制在單一實例或類別上作用。例如，解構函式可能會刪除關聯實例，以及定義解構函式的類別實例。

解構函式辨識符號僅供資訊使用，而且不預期物件管理員會對其採取動作。刪除實例時，物件管理員不需要呼叫具有 解構函 式限定詞的方法。此外，呼叫解構函式時，物件管理員不需要叫用針對原始類別的任何父類別所定義的任何解構函式方法。預設值為 FALSE。

DisplayName

資料類型：字串

適用于：任何

UI 中顯示的名稱，而不是專案的實際名稱。預設值為 Null。

EmbeddedInstance

資料類型：字串

適用于：任何

限定字串類型專案包含內嵌實例。限定詞值會指定與擁有限定專案之類別相同命名空間中的 CIM 類別名稱。內嵌實例是指定類別的實例，包括其子類別的實例。預設值為 Null。

表

資料類型： 布林值

適用于：任何

指出屬性是否代表非負整數，這可能會增加或減少，但永遠不會超過最大值。預設值為 FALSE。

屬性的最大值不能大於 2^n - 1。 N 可以是 8、16、32 或 64，視套用這個限定詞之屬性的資料類型而定。只要模型化的資訊大於或等於該最大值，量測計的值就會有其最大值。如果模型化的資訊後續會減少到最大值以下，量測計也會減少。此限定詞僅適用于具有不帶正負號整數資料類型的屬性。

資料類型： 布林值

適用于：參數

指出參數是否用來將值傳遞至方法。預設值為 TRUE。

In、Out

資料類型： 布林值

適用于：參數

指出參數是否為輸入和輸出參數。

關鍵

資料類型： 布林值

適用于：屬性、參考

指出屬性是否為命名空間控制碼的一部分。如果多個屬性具有 Key 限定詞，則所有這類屬性會共同形成索引鍵 (複合索引鍵) 。一起使用時，索引鍵屬性必須為每個類別實例提供唯一的參考。如果這個限定詞放在屬性上，則只 允許 TRUE 值 。

懶惰

適用于：屬性

表示屬性需要大量資源才能傳回，而且需要大量的處理器時間和記憶體。 WMI 不會嘗試傳回以延遲限定詞標示的屬性，以改善查詢的效能。

MappingStrings

資料類型： 字串陣列

適用于：類別、屬性、關聯、指示、參考

一組值，指出位置的路徑，您可以在其中找到屬性、類別、關聯、指示或參考的詳細資訊。對應字串可以是目錄路徑、URL、登錄機碼、包含檔案、CIM 類別的參考或其他格式。預設值為 Null。

麥克斯

資料類型： int

適用于：參考

指定參考可以針對關聯中每個其他參考值集擁有的值數目上限。預設值為 Null。例如，如果關聯將 A 實例關聯至 B 實例，而且每個 B 實例最多必須有一個 A 實例，則 A 的參考應該最多隻能有一個限定詞。

MaxLen

資料類型： int

適用于：屬性、方法、參數

字串資料項目) 字元的最大長度 (，並表示支援固定長度陣列。

如果遇到固定長度陣列， MaxLen 限定詞會包含剖析期間找到的固定長度。如果遇到可變長度陣列，則不會使用此限定詞。 MaxLen 可用來建議應該儲存在陣列中的元素數目上限。覆寫預設值時，可以指定任何不帶正負號的整數值 (uint32) 。 Null值 (預設) 表示不限長度。

MaxValue

資料類型： int

適用于：屬性、方法、參數

物件的最大值。預設值為 Null。

最小值

資料類型： int

適用于：參考

參考的最小基數 (指定參考可以針對關聯) 中每個參考值集擁有的最小值。預設值是 0。

例如，如果關聯將 A 實例關聯至 B 實例，而且每個 B 實例至少必須有一個 A 實例，則 A 的參考至少應有一個限定詞。

MinValue

資料類型： int

適用于：屬性、方法、參數

表示物件的最小值。預設值為 Null。

ModelCorrespondence

資料類型： 字串陣列

適用于：屬性

一組值，表示物件屬性與 CIM 架構中其他屬性之間的對應。預設值為 Null。

物件屬性是使用下列語法來識別。

"_" "."

外地

資料類型：字串

適用于：參考

實例的位置，其 < 值為namespacetype> ：// <namespacehandle> 預設值為Null。

使用方式：此限定詞無法與 NonlocalType 限定詞搭配使用。

NonlocalType

資料類型：字串

適用于：參考

實例的位置類型。其值為 < namespacetype > 。預設值為 Null。

使用方式：此限定詞無法與 非本機 限定詞搭配使用。

NullValue

資料類型：字串

適用于：屬性

值，指出相關聯的屬性為 Null ， (屬性沒有有效或有意義的值) 。預設值為 Null。

用來定義 Null 值的慣例和限制與 適用于 ValueMap 限定詞的慣例和限制相同。請注意，無法覆寫此限定詞。不允許子類別傳回與父類別不同的 Null 值並不合理。

Out

資料類型： 布林值

適用于：參數

指出參數是否從方法傳回值。預設值為 FALSE。

覆蓋

資料類型：字串

適用于：屬性、方法、參考

父類別或次級建構 (屬性、方法或參考) ，由衍生類別中相同名稱的屬性、方法或參考所覆寫。預設值為 Null。

其格式為：

[ <class> .] <次級建構>

如果省略類別名稱，覆寫會套用至類別階層中父類別的次級建構。

使用方式：覆寫限定詞只能參考以相同中繼模型為基礎的建構。不允許在覆寫作業期間變更建構名稱或簽章。

OverrideValue

適用于：類別

指出子類別上的屬性值是否覆寫父類別中的值。功能含意在於，如果您對父類別執行查詢，而且您的 WHERE 子句包含這個屬性，父系必須傳回具有覆寫值的實例。因此，Windows Management 會調整傳送至父類別之查詢的WHERE子句，以排除此屬性的參考。

傳播

資料類型：字串

適用于：屬性

正在傳播的索引鍵名稱。預設值為 Null。

使用此限定詞會假設參考上只有一個弱式限定詞存在，且該參考具有包含類別做為其目標。關聯的屬性必須與弱式關聯另一端類別中限定詞所命名的屬性具有相同的值。其格式為：

[ <class> .] <次級建構>

使用方式：使用傳播限定詞時，必須以TRUE值指定金鑰限定詞。

讀

資料類型： 布林值

適用于：屬性

指出屬性是否可讀取。預設值為 TRUE。

必填

資料類型： 布林值

適用于：屬性

指出屬性是否需要非 Null 值。預設值為 FALSE。

修訂

資料類型：字串

適用于：類別、關聯、指示、架構

架構物件的次要修訂編號。預設值為 Null。

使用方式 ：版本限定 符必須存在，才能在使用修訂限定詞時提供主要版本號碼。

模式

資料類型：字串

適用于：屬性、方法

定義功能之架構的名稱。預設值為 Null。

源

資料類型：字串

適用于：類別、關聯、指示、參考

實例的位置。預設值為 Null。

限定詞的值是 <namespacetype> ：// <namespacehandle> 。

使用方式：來源限定詞無法與 SourceType 限定詞搭配使用。

SourceType

資料類型：字串

適用于：類別、關聯、指示、參考

實例的位置類型。這個限定詞的值是 <namespacetype> 。預設值為 Null。

使用方式： SourceType 限定詞無法與來源限定詞搭配使用。

SupportsCreate

資料類型： 布林值

適用于：類別

指出類別是否支援建立實例。預設值為 FALSE。

SupportsDelete

資料類型： 布林值

適用于：類別

指出類別是否支援刪除實例。預設值為 FALSE。

SupportsUpdate

資料類型： 布林值

適用于：類別

指出類別是否支援修改 (更新實例) 。預設值為 FALSE。

終端

資料類型： 布林值

適用于：類別

指出類別是否可以有子類別。預設值為 FALSE。

如果宣告子類別，編譯器會產生錯誤。

使用方式：此限定詞無法與抽象限定詞共存。如果同時指定終端機和抽象限定詞，編譯器會產生錯誤。

單位

資料類型：字串

適用于：屬性、方法、參數

表示相關聯資料項目的單位類型。預設值為 Null。

例如，size 資料項目可能會有 Units的「bytes」值。

ValueMap

資料類型： 字串陣列

適用于：屬性、方法、參數

屬性、方法傳回型別或方法參數的允許值集。預設值為 Null。

使用方式：此限定詞可以單獨使用或與值限定詞搭配使用。與 Values 限定詞搭配使用時， ValueMap 陣列中的值位置會提供 Values 陣列中對應專案的位置。只搭配字串和整數值使用 ValueMap 限定詞。在值對應陣列中代表整數值的語法是 [+|=]digit[*digit]。內容、最大位數和表示的值會受限於相關聯屬性的類型。例如，uint8 可能不會帶正負號、必須小於四位數，而且必須代表小於 256 的值。

值

資料類型： 字串陣列

適用于：屬性、方法、參數

將整數值轉譯成相關聯的字串的一組值。預設值為 Null。

這個屬性也會指定要對應至列舉屬性的字串值陣列。這個限定詞可以套用至整數屬性或字串屬性，而對應可以是隱含或明確。如果對應是隱含的，則整數或字串屬性值代表 Values 陣列中的序數位置。如果對應明確，屬性必須是整數，而且有效的屬性值會列在 ValueMap 限定詞所定義的陣列中。如需詳細資訊，請參閱值對應。

如果 ValueMap 限定詞不存在， 則 Values 陣列會使用相關聯屬性、方法傳回型別或方法參數中的值， (以零相對) 編制索引。如果 ValueMap 限定詞存在，值索引是由值對應中屬性值的位置所定義。

版本

資料類型：字串

適用于：類別、架構、關聯、指示

架構物件的主要版本號碼。預設值為 Null。變更變更介面的架構時，版本號碼會遞增。

弱

資料類型： 布林值

適用于：參考

指出參考類別的索引鍵是否包含關聯中其他參與者的索引鍵。預設值為 FALSE。

當參考類別的身分識別取決於關聯中其他參與者的身分識別時，就會使用這個限定詞。任何指定類別的參考不能超過一個。關聯中的其他類別必須定義索引鍵。關聯中其他類別的索引鍵會在參考類別中重複，並以傳播限定詞標記。

寫

資料類型： 布林值

適用于：屬性

表示應用程式或腳本可以變更屬性值。執行應用程式的帳戶必須能夠存取包含類別實例的命名空間。提供者實作也可以限制提供者資料的存取。 TRUE值表示屬性可供 WMI 和提供者存取的取用者讀取和寫入。預設值為 FALSE。

缺少寫入限定詞的屬性可能仍然可以寫入。提供者實作可能會允許變更提供者類別中的任何屬性，不論寫入限定詞是否存在。

WriteAtCreate

資料類型： 布林值

適用于：屬性

指出屬性是否可在實例建立時寫入。此限定詞可與 WriteAtCreate 限定詞搭配使用。預設值為 FALSE。

WriteAtUpdate

資料類型： 布林值

適用于：屬性

指出屬性是否可在實例更新時寫入。此限定詞可與 WriteAtCreate 限定詞搭配使用。預設值為 FALSE。

範例

如需擷取限定詞的詳細資訊，請參閱 TechNet 資源庫中的 Get-WmiClassMethodsAndWritableWmiProperties PowerShell 程式碼範例。

規格需求

需求	值
最低支援的用戶端	Windows Vista
最低支援的伺服器	Windows Server 2008

另請參閱

WMI 限定詞
新增限定詞