Configuration Manager內容限定詞

發行項
04/04/2023

在Configuration Manager中，會使用內容物件來提供其他資訊給 SMS 提供者。一般而言，您會使用內容限定詞來提供 SMS 提供者內容資訊，例如應用程式的名稱。當您連線到 SMS 提供者和個別的 SMS 提供者物件時，可以使用內容限定詞。

Managed 程式碼

使用受控 SMS 提供者程式庫時，您可以使用 ConnectionManagerBase.CoNtext 屬性來指定內容限定詞。如需詳細資訊，請參閱如何使用 Managed 程式碼新增Configuration Manager內容限定詞。

VBScript

使用 VBScript 時，您可以使用 SWBemNamedValue 介面集合，將內容限定詞指定為具名值物件的集合。如需詳細資訊，請參閱如何使用 WMI 新增Configuration Manager內容限定詞。

內容限定詞

下表包含 SMS 提供者所使用 (具名值) 內容限定詞。大部分的限定詞，例如 SessionHandle ，只會與 SMS 提供者的特定功能區域搭配使用，但 LocaleID 、 MachineName 和 ApplicationName 適用于您的應用程式。

內容限定詞	描述
`ApplicationName`	識別進行呼叫的應用程式。
`ContextHandle`	識別 SMS 提供者儲存快取內容限定詞的位置。
`InstanceCount`	限制從 ExecQuery 和 CreateInstanceEnum傳回的實例數目。
`LimitToCollectionIDs`	將資源查詢的結果限制為具名集合的成員。
`LocaleID`	識別要使用的字碼頁。
`MachineName`	識別執行應用程式的電腦。
`QueryQualifiers`	當您對受保護的物件執行查詢時，會傳回 SecurityVerbs 位旗標。
`SessionHandle`	識別要Configuration Manager之月臺控制檔案的應用程式複本。

ApplicationName

內容 ApplicationName 限定詞是識別發出呼叫之應用程式名稱的字串值。您應該為應用程式指定 ApplicationName ，因為它用於稽核。如果您未提供應用程式的名稱，則會使用 [未知] 值。當您呼叫任何引發狀態訊息方法時，必須提供 ApplicationName 值，例如 SMS_StatusMessage：：RaiseErrorStatusMsg，否則呼叫將會失敗。

CoNtextHandle

內容 ContextHandle 限定詞是字串值，可識別 SMS 提供者儲存快取內容限定詞的位置。 Managed SMS 提供者會管理資料傳輸。使用 VBScript 時，您可以使用下列步驟來減少透過網路傳遞的資料量。

建立 SWBemNamedValue 值集。
將限定詞新增至內容物件。如需詳細資訊，請參閱如何使用 WMI 新增Configuration Manager內容限定詞。
呼叫 GetCoNtextHandle 方法以快取伺服器上的限定詞。當您呼叫GetCoNtextHandle時，SMS 提供者會快取您傳遞為ExecMethod參數的內容物件。
從內容物件中移除所有限定詞。
將限定 ContextHandle 符和值新增至內容物件。
對 IWbemServices的所有呼叫傳遞內容物件。

您必須先呼叫 ClearCoNtextHandle 方法來移除快取的限定詞，然後才結束應用程式。您可以視需要建立任意數量 ContextHandle 的值，每個值都會為您的應用程式提供不同的資訊。

注意事項

快取內容限定詞之後，您可以將具有不同值的相同內容限定詞新增至內容物件，以覆寫快取的值。

InstanceCount

內容 InstanceCount 限定詞是整數值，用來限制從 ExecQuery 和 CreateInstanceEnum 方法傳回的實例數目。您將設定 InstanceCount 為等於您想要從查詢或列舉值傳回的實例數目上限。例如，設定為 InstanceCount 10 會傳回最多 10 個實例。

LimitToCollectionIDs

內容 LimitToCollectionIDs 限定詞是包含值清單的 CollectionID 字串陣列。目前，您只能指定一個 CollectionID 值。您可以使用此限定詞，將資源查詢的結果限制為具名集合的成員。資源查詢是一種查詢，其中包含衍生自 SMS_Resource 或 SMS_Group的類別。

使用者必須具有資源所屬集合的實例讀取資源許可權。當使用者沒有集合的類別讀取資源許可權時，您必須使用集合限制;否則，不會傳回任何資料。對於 Service Pack 1 和更新版本的 SMS 2.0，此限制僅適用于衍生自 SMS_Group 的類別。

查詢集合時，您無法使用此限定詞。

LocaleID

內容 LocaleID 限定詞是接受十六進位值或 MS\x 格式十進位值的字串值，其中 x 是地區設定識別碼。例如，您可以輸入英文 LocaleID 值 ms\0x0409 或 ms\1033。 SMS 提供者只接受 LocaleID 使用Microsoft格式的值。您可以在 Microsoft指派的地區設定識別碼中找到清單 locale IDs 。

如果您需要非美國地區設定安裝時，您可以從SMS_Identification Server WMI ClassLocaleID 屬性取得它。

MachineName

內容 MachineName 限定詞是字串值，可識別執行應用程式的電腦。您應該為應用程式指定 MachineName ，因為它用於稽核。如果您未提供電腦名稱稱，則會使用 [未知] 值。當您呼叫任何引發狀態訊息方法時，必須提供 MachineName 值，例如 SMS_StatusMessage：：RaiseRawStatusMsg，否則呼叫將會失敗。

QueryQualifiers

內容 QueryQualifiers 限定詞是布林值，當您對安全物件執行查詢時，可用來傳回 SecurityVerbs 位旗標，例如 SMS_Site 或 SMS_Package。請注意，在查詢不安全的物件時使用 QueryQualifiers 會產生錯誤。根據預設，查詢不會傳回 SecurityVerbs 旗標。如果您想要傳回旗標，您必須建立此限定詞，並將其值設定為 true 。 [未建立 QueryQualifiers ] 與將其值設定為 false 相同。

SessionHandle

內容 SessionHandle 限定詞是以 GetSessionHandle 方法的 out 參數傳回的字串值。字串是唯一的 GUID，可識別要Configuration Manager之月臺控制檔案的應用程式複本。您應該使用此機制來修改月臺控制檔案，並減少與其他同時修改月臺控制檔案之應用程式的資料衝突。如果您未提供 SessionHandle 值，您的應用程式會修改月臺控制檔案的全域複本，而無法防止應用程式覆寫彼此的資料。