Configuration Manager'da yönetim hizmetini kullanma

Makale
04/04/2023

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

Configuration Manager çeşitli yerel senaryolarda yönetim hizmeti REST API'sini kullanır. Kendi özel senaryolarınız için yönetim hizmetini de kullanabilirsiniz.

Not

Bu makaledeki örneklerin tümü SMS Sağlayıcısı rolünü barındıran sunucunun FQDN'sini kullanır. Yönetim hizmetine bir CMG aracılığıyla uzaktan erişiyorsanız SMS Sağlayıcısı FQDN'sinin 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 sorgulamanın birkaç yolu 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ınıyor.

Önemli

Yönetim hizmeti sınıf adları büyük/küçük harfe duyarlıdır. Uygun büyük/küçük harf kullanımını 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 okunması kolay bir biçimde görüntülemeyebilir.

PowerShell

Windows PowerShell cmdlet Invoke-RestMethod ile bu hizmete doğrudan çağrılar yapın.

Örneğin:

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

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

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

Aşağıdaki örnek, daha belirli değerlerin detayına iner:

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

Bu komutun çıkışı, sitenin belirli bir sürümüdür: 5.00.8968.1000

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

PowerShell Betiğini Çalıştır görev dizisi adımından bir PowerShell betiğinde Invoke-RestMethod cmdlet'ini 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

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

Power BI Desktop şeritte Veri Al'ı ve ardından OData akışı'nı seçin.
URL için yönetim hizmeti yolunu belirtin. Örneğin, https://smsprovider.contoso.com/AdminService/wmi/
Windows Kimlik Doğrulaması'nı seçin.
Gezgin penceresinde Power BI panonuzda veya raporunuzda kullanılacak öğeleri seçin.

Örnek sorgular

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

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ırın:

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

Bkz. CMPivot iş sonucu:

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

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

Şununla sonuçları filtrele: startswith

Bu örnek URI yalnızca adları ile Allbaşlayan koleksiyonları gösterir.

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

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

Bu örnek, değeriyle 1Type adlı parametreyi alan SMS_AdminClassGetAdminExtendedData 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

Aracılığıyla paylaş