共用方式為


裝置的自訂屬性

適用於: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 版搭配更新彙總套件或更新版本。

後續步驟

如何使用系統管理服務

建立集合

如何管理用戶端