裝置的自訂屬性

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

後續步驟

如何使用系統管理服務

建立集合

如何管理用戶端

  • 上次更新時間：