裝置的自訂屬性

  • 發行項

適用於：Configuration Manager (目前的分支)

許多客戶具有Configuration Manager以外的其他資料，但適用于部署目標、集合建置和報告。 此資料在本質上通常是非技術性的，無法在用戶端上探索，而且來自單一外部來源。 例如，中央 IT 基礎結構程式庫 (ITIL) 系統或資產資料庫，其具有下列一些裝置屬性：

  • 實體位置
  • 組織優先順序
  • 類別
  • 成本中心
  • 部門

從 2107 版開始，您可以 使用系統管理服務 在裝置上設定此資料。 月臺會將屬性的名稱及其值儲存在月臺資料庫中，做為 裝置自訂屬性 類別。 然後，您可以使用 Configuration Manager 中的自訂屬性來報告或建立集合。

從 2111 版開始，您可以在 Configuration Manager 主控台中建立和編輯這些自訂屬性。 這個新的使用者介面可讓您更輕鬆地檢視和編輯這些屬性。

注意事項

您可以將 Unicode 字元用於自訂屬性 值，但不能使用屬性 名稱。 如需詳細資訊，請參閱Configuration Manager 中的 Unicode 和 ASCII 支援。

先決條件

進行 API 呼叫的帳戶需要包含目標裝置之集合的下列許可權：

  • 若要設定屬性： 修改資源
  • 若要檢視屬性： 讀取資源
  • 若要移除屬性： 刪除資源

透過 UI 設定屬性

適用于 2111 版或更新版本

  1. 在Configuration Manager主控台中，移至 [資產與相容性] 工作區，然後選取 [裝置]節點。

  2. 選取裝置，然後在功能區中選取 [ 屬性]

  3. 切換至 [ 自訂屬性] 索引卷 標。

  4. 選取金色星號圖示 以建立新的自訂屬性。 提供屬性的名稱，並設定此裝置的值。 選取 [確定 ] 以儲存屬性。

具有多個值之裝置上的 [自訂屬性] 索引標籤。

透過 API 設定屬性

適用于 2107 版或更新版本

若要在裝置上設定屬性，請使用 SetExtensionData API。 使用 JSON 主體對 URI https://<SMSProviderFQDN>/AdminService/v1.0/Device(<DeviceResourceID>)/AdminService.SetExtensionData 進行 POST 呼叫。 資源識別碼是整數值，例如 16777345 。

此 JSON 範例會設定裝置資產標籤和位置的兩個名稱/值組：

{
  "ExtensionData": {
    "AssetTag":"0580255",
    "Location":"Dublin"
  }
}

檢視屬性

使用 GetExtensionData API 來檢視您的自訂屬性。

若要檢視 單 一裝置上的屬性，請對 URI https://<SMSProviderFQDN>/AdminService/v1.0/Device(<DeviceResourceID>)/AdminService.GetExtensionData 進行 GET 呼叫。

若要檢視 所有 裝置上的屬性，請對 URI https://<SMSProviderFQDN>/AdminService/v1.0/Device/AdminService.GetExtensionData 進行 GET 呼叫。 此呼叫會從您具有讀取權限的裝置傳回屬性值。

移除屬性

若要從所有裝置移除屬性值，請使用不含裝置識別碼 的 DeleteExtensionData API。 包含裝置資源識別碼，只移除特定裝置的屬性。 對 URI https://<SMSProviderFQDN>/AdminService/v1.0/Device/AdminService.DeleteExtensionData 進行 POST 呼叫。

建立集合

使用下列步驟，根據自訂屬性建立具有查詢規則的集合：

  1. 在Configuration Manager主控台中，建立集合。

  2. 在 [成員資格規則] 頁面的 [ 新增規則] 清單中，選取 [查詢規則]。

  3. 在 [查詢規則] 屬性視窗中，指定查詢的[名稱]。 然後選取 [編輯查詢語句]。

  4. 在 [查詢語句] 屬性視窗中，切換至 [準則] 索引標籤。然後選取 () * 的黃金星號，以新增準則。

  5. 在 [準則屬性視窗中，選取下列值：

    • 屬性類別： 裝置自訂屬性
    • 屬性： PropertyName

  6. 選取 [ 運算子 ]，然後將屬性的名稱指定為 [值]。

    此時，準則屬性視窗看起來應該類似下圖：

    裝置自訂屬性 PropertyName 的準則屬性視窗。

    選取 [確定 ] 以儲存準則。

  7. 重複步驟以新增 PropertyValue 屬性的準則。

    此時，集合查詢語句屬性視窗看起來應該類似下圖：

    查詢語句屬性視窗兩個裝置自訂屬性準則。

  8. 選取 [確定 ] 以關閉所有屬性視窗。 然後完成精靈以建立集合。

範例 WQL 語句

您也可以使用下列範例查詢。 在 [查詢語句屬性] 視窗中，選取 [顯示查詢語言 ] 以貼上查詢語句。

select SMS_R_SYSTEM.ResourceID,SMS_R_SYSTEM.ResourceType,SMS_R_SYSTEM.Name,SMS_R_SYSTEM.SMSUniqueIdentifier,SMS_R_SYSTEM.ResourceDomainORWorkgroup,SMS_R_SYSTEM.Client 
from SMS_R_System inner join SMS_G_System_ExtensionData on SMS_G_System_ExtensionData.ResourceId = SMS_R_System.ResourceId 
where SMS_G_System_ExtensionData.PropertyName = "AssetTag" and SMS_G_System_ExtensionData.PropertyValue = "0580255"

注意事項

若要搭配增量集合更新使用自訂屬性 WQL 語句，請使用 Configuration Manager 2107 版搭配更新彙總套件或更新版本。

後續步驟

如何使用系統管理服務

建立集合

如何管理用戶端