Configuration Manager'da yönetim hizmetini kullanma

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

Configuration ManagerConfiguration Manager, çeşitli yerel senaryolarda REST API yönetim hizmetini kullanır. Ayrıca, kendi özel senaryolarınız için de yönetim hizmetini kullanabilirsiniz.

Not

Bu makaledeki örneklerin tümünde SMS Sağlayıcısı rolünü barındıran sunucunun FQDN değeri kullanılır. Yönetim hizmetine CMG aracılığıyla uzaktan erişiyorsanız, SMS Sağlayıcısı FQDN'si yerine CMG uç noktasını kullanın. Daha fazla bilgi için bkz: İnternet erişimini etkinleştirme.

Doğrudan sorgu

Yönetim hizmetini doğrudan sorgulayabilmeniz için çeşitli yollar vardır:

  • Web tarayıcısı
  • PowerShell
  • Web hizmetine HTTPS GET veya PUT istekleri göndermek için üçüncü taraf bir araç

Sonraki bölümlerde ilk iki yöntem ele alınmaktadır.

Önemli

Yönetim hizmeti sınıfı adları büyük/küçük harf duyarlıdır. Doğru büyük harf kullandığınızdan emin olun. Örneğin, SMS_Site.

Web tarayıcısı

Yönetim hizmetini kolayca sorgulamak için bir web tarayıcısı kullanabilirsiniz. Tarayıcının URL'si olarak bir sorgu URI'si belirttiğinizde, yönetim hizmeti GET isteğini işler ve sonucu JSON biçiminde döndürür. Bazı web tarayıcıları sonucu kolay okunabilir bir biçimde görüntülemeyebilir.

PowerShell

Bu hizmete doğrudan çağrılar yapmak için Windows PowerShellWindows PowerShell cmdlet'i Invoke-RestMethod.

Örneğin:

Invoke-RestMethod -Method 'Get' -Uri "https://SMSProviderFQDN/AdminService/wmi/SMS_Site" -UseDefaultCredentials

Bu komut aşağıdaki çıktıyı döndürür:

@odata.context                                                value
--------------                                                -----
https://SMSProviderFQDN/AdminService/wmi/$metadata#SMS_Site   {@{@odata.etag=FC1; __LAZYPROPERTIES=System.Objec...

Aşağıdaki örnekte daha belirli değerlerin detayına gidilir:

((Invoke-RestMethod -Method 'Get' -Uri "https://SMSProviderFQDN/AdminService/wmi/SMS_Site" -UseDefaultCredentials).value).Version

Bu komutun çıktısı, sitenin belirli sürümüdür: 5.00.8968.1000

Görev dizisinden PowerShell'i çağırma

Invoke-RestMethod cmdlet'ini PowerShell Betiğini Çalıştır görev dizisi adımındaki bir PowerShell betiğinde kullanabilirsiniz. Bu eylem, bir görev dizisi sırasında yönetim hizmetini sorgulamanıza olanak tanır.

Daha fazla bilgi için bkz. Görev dizisi adımları - PowerShell Betiğini Çalıştırma.

Power BI Desktop

Power BI Desktop kullanarak yönetim hizmeti aracılığıyla Configuration Manager'da verileri sorgulayabilirsiniz. Daha fazla bilgi için bkz. Power BI Desktop nedir?

  1. TPower BI DesktopPower BI Desktop bölümünde, şeritte Veri Al'ı ve OData akışını seçin.

  2. URL için, yönetim hizmeti yolunu belirtin. Örneğin, https://smsprovider.contoso.com/AdminService/wmi/

  3. Windows Kimlik Doğrulaması'nı seçin.

  4. Gezgin penceresinde, Power BI panonuzda veya raporunuzda kullanmak istediğiniz öğeleri seçin.

Power BI Desktop'de Gezgin penceresinin ekran görüntüsü

Örnek sorgular

Belirli bir cihaz hakkında daha fazla ayrıntı edinme

https://<ProviderFQDN>/AdminService/wmi/SMS_R_System(<ResourceID>)

Örneğin: https://smsprovider.contoso.com/AdminService/wmi/SMS_R_System(16777219)

v1 Cihaz sınıfı örnekleri

  • Tüm cihazları edinin: https://<ProviderFQDN>/AdminService/v1.0/Device

  • Tek bir cihaz edinin: https://<ProviderFQDN>/AdminService/v1.0/Device(<ResourceID>)

  • CMPivot'u bir cihazda çalıştırma:

    Verb: POST
URI: https://<ProviderFQDN>/AdminService/v1.0/Device(<ResourceID>)/AdminService.RunCMPivot
Body: {"InputQuery":"<CMPivot query to run>"}

  • CMPivot iş sonucuna bakın:

    Verb: GET
URI: https://<ProviderFQDN>/AdminService/v1.0/Device(<ResourceID>)/AdminService.CMPivotResult(OperationId=<Operation ID of the CM Pivot job>)

  • Bir cihazın hangi koleksiyonlarda yer aldığını görün: https://<ProviderFQDN>/AdminService/v1.0/Device(16777219)/ResourceCollectionMembership?$expand=Collection&$select=Collection

Sonuçları startswith ile filtreleme

Bu örnek URI'de yalnızca adları ile başlayan Allkoleksiyonlar gösterilir.

https://<ProviderFQDN>/AdminService/wmi/SMS_Collection?$filter=startswith(Name,'All') eq true

Statik WMI yöntemi çalıştırma

Bu örnek, Type adlı parametreyi value 1ile alan SMS_AdminClass GetAdminExtendedData yöntemini çağırır.

Verb: Post
URI: https://<ProviderFQDN>/AdminService/wmi/SMS_Admin.GetAdminExtendedData
Body: {"Type":1}

Sonraki adımlar

Cihazlar için özel özellikler

  • Last updated on