Cihazlar için özel özellikler

Makale
04/04/2023

Uygulama hedefi: Configuration Manager (güncel dalı)

Birçok müşterinin Configuration Manager dışında olan ancak dağıtım hedefleme, toplama oluşturma ve raporlama için yararlı olan başka verileri vardır. Bu veriler genellikle doğası gereği teknik değildir, istemcide bulunamaz ve tek bir dış kaynaktan gelir. Örneğin, aşağıdaki cihaz özniteliklerinden bazılarına sahip merkezi bir BT Altyapı Kitaplığı (ITIL) sistemi veya varlık veritabanı:

Fiziksel konum
Kuruluş önceliği
Kategori
Maliyet merkezi
Bölüm

Sürüm 2107'den başlayarak, bu verileri cihazlarda ayarlamak için yönetim hizmetini kullanabilirsiniz . Site, özelliğin adını ve değerini site veritabanında Cihaz Özel Özellikleri sınıfı olarak depolar. Daha sonra Configuration Manager'deki özel özellikleri raporlamak veya koleksiyonlar oluşturmak için kullanabilirsiniz.

Sürüm 2111'den başlayarak, Configuration Manager konsolunda bu özel özellikleri oluşturabilir ve düzenleyebilirsiniz. Bu yeni kullanıcı arabirimi, bu özellikleri görüntülemeyi ve düzenlemeyi kolaylaştırır.

Not

Özel özellik değerleri için unicode karakterler kullanabilirsiniz, ancak özellik adlarını kullanamazsınız. Daha fazla bilgi için bkz. Configuration Manager'de Unicode ve ASCII desteği.

Önkoşullar

API çağrıları yapan hesap, hedef cihazı içeren bir koleksiyonda aşağıdaki izinleri gerektirir:

Özellikleri ayarlamak için: Kaynağı Değiştir
Özellikleri görüntülemek için: Kaynağı Okuma
Özellikleri kaldırmak için: Kaynağı Sil

Kullanıcı arabirimi aracılığıyla özellikleri ayarlama

Sürüm 2111 veya üzeri için geçerlidir

Configuration Manager konsolunda Varlıklar ve Uyumluluk çalışma alanına gidin ve Cihazlar düğümünü seçin.
Bir cihaz seçin ve şeritte Özellikler'i seçin
Özel Özellikler sekmesine geçin.
Yeni bir özel özellik oluşturmak için altın yıldız simgesini seçin. Özelliği için bir ad sağlayın ve bu cihaz için bir değer ayarlayın. Özellikleri kaydetmek için Tamam'ı seçin.

Birden çok değer içeren bir cihazda Özel Özellikler sekmesi.

API aracılığıyla özellikleri ayarlama

Sürüm 2107 veya üzeri için geçerlidir

Bir cihazda özellikleri ayarlamak için SetExtensionData API'sini kullanın. JSON gövdesiyle URI'ye https://<SMSProviderFQDN>/AdminService/v1.0/Device(<DeviceResourceID>)/AdminService.SetExtensionData POST çağrısı yapın. Kaynak kimliği, örneğin 16777345bir tamsayı değeridir.

Bu JSON örneği, cihazın varlık etiketi ve konumu için iki ad-değer çifti ayarlar:

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

Özellikleri görüntüleme

Özel özelliklerinizi görüntülemek için GetExtensionData API'sini kullanın.

Özellikleri tek bir cihazda görüntülemek için URI'ye https://<SMSProviderFQDN>/AdminService/v1.0/Device(<DeviceResourceID>)/AdminService.GetExtensionDatabir GET çağrısı yapın.

Tüm cihazlardaki özellikleri görüntülemek için URI'ye https://<SMSProviderFQDN>/AdminService/v1.0/Device/AdminService.GetExtensionDatabir GET çağrısı yapın. Bu çağrı, okuma izniniz olan cihazlardan özellik değerlerini döndürür.

Özellikleri kaldırma

Tüm cihazlardan özellik değerlerini kaldırmak için, cihaz kimliği olmadan DeleteExtensionData API'sini kullanın. Yalnızca belirli bir cihazdan özellikleri kaldırmak için bir cihaz kaynak kimliği ekleyin. URI'ye https://<SMSProviderFQDN>/AdminService/v1.0/Device/AdminService.DeleteExtensionDataPOST çağrısı yapın.

Koleksiyon oluşturma

Özel özellikleri temel alan bir sorgu kuralıyla koleksiyon oluşturmak için aşağıdaki adımları kullanın:

Configuration Manager konsolunda Koleksiyon oluşturun.
Üyelik Kuralları sayfasındaki Kural Ekle listesinde Sorgu kuralı'nı seçin.
Sorgu Kuralı Özellikler penceresi sorgu için bir Ad belirtin. Ardından Sorgu Deyimini Düzenle'yi seçin.
Sorgu Deyimi Özellikler penceresi Ölçüt sekmesine geçin. Ardından yeni ölçüt eklemek için altın yıldız* () simgesini seçin.
Ölçüt Özellikler penceresi aşağıdaki değerleri seçin:
- Öznitelik sınıfı: Cihaz Özel Özellikleri
- Öznitelik: PropertyName
Bir İşleç seçin ve ardından özelliğin adını Değer olarak belirtin.

Bu noktada Ölçüt Özellikler penceresi aşağıdaki görüntüye benzer olmalıdır:

Ölçütü kaydetmek için Tamam'ı seçin.
PropertyValue özniteliği için ölçüt eklemek için adımları yineleyin.

Bu noktada, koleksiyon Sorgu Deyimi Özellikler penceresi aşağıdaki görüntüye benzer görünmelidir:
Tüm özellik pencerelerini kapatmak için Tamam'ı seçin. Ardından, koleksiyonu oluşturmak için sihirbazı tamamlayın.

Örnek WQL deyimi

Aşağıdaki örnek sorguyu da kullanabilirsiniz. Sorgu deyimi özellikleri penceresinde Sorgu Dilini Göster'i seçerek sorgu deyimini yapıştırın.

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"

Not

Artımlı koleksiyon güncelleştirmeleriyle özel özellikler WQL deyimlerini kullanmak için güncelleştirme paketi veya üzeriyle Configuration Manager sürüm 2107'yi kullanın.