Configuration Manager 內容限定符

發行項
07/04/2024

在 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 值，您的應用程式會修改月臺控制檔案的全域複本，而無法防止應用程式覆寫彼此的數據。