Использование службы администрирования в Диспетчер конфигурации

Относится к: Configuration Manager (Current Branch)

Диспетчер конфигурации использует службу администрирования REST API в нескольких сценариях. Вы также можете использовать службу администрирования для собственных пользовательских сценариев.

Примечание

В примерах этой статьи используется FQDN сервера, на котором размещена роль поставщика SMS. При удаленном доступе к службе администрирования с помощью CMG используйте конечную точку CMG вместо FQDN поставщика SMS. Дополнительные сведения см. в дополнительных сведениях: Включить доступ к Интернету.

Прямой запрос

Существует несколько способов непосредственного запроса службы администрирования:

  • Веб-браузер
  • PowerShell
  • Сторонний инструмент для отправки запросов HTTPS GET или PUT в веб-службу

Следующие разделы охватывают первые два метода.

Важно!

Имена классов служб администрирования являются конфиденциальными к делу. Убедитесь, что используйте надлежащую капитализацию. Например, SMS_Site.

Веб-браузер

С помощью веб-браузера можно запросить службу администрирования. При указании URI запроса в качестве URL-адреса браузера служба администрирования обрабатывает запрос GET и возвращает результат в формате JSON. Некоторые веб-браузеры могут не отображать результат в удобном для чтения формате.

PowerShell

Делайте прямые вызовы в эту службу с Windows PowerShell invoke-RestMethod.

Например:

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

Эта команда возвращает следующий вывод:

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

В следующем примере сверлены более конкретные значения:

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

Выход этой команды — это конкретная версия сайта: 5.00.8968.1000

Вызов PowerShell из последовательности задач

В скрипте PowerShell можно использовать комлет Invoke-RestMethod из последовательности последовательность задач Run PowerShell Script. Это действие позволяет запрашивать службу администрирования во время выполнения последовательности задач.

Дополнительные сведения см. в дополнительных действиях по последовательности задач - Run PowerShell Script.

Power BI Desktop

Вы можете использовать Power BI Desktop для запроса данных в Configuration Manager с помощью службы администрирования. Дополнительные сведения см. в Power BI Desktop?

  1. В Power BI Desktop в ленте выберите Get Data и выберите канал OData.

  2. Для URL-адреса укажите маршрут службы администрирования. Пример: https://smsprovider.contoso.com/AdminService/wmi/

  3. Выберите Windows проверку подлинности.

  4. В окне Navigator выберите элементы, которые можно использовать в панели мониторинга Power BI отчете.

Снимок экрана окна Navigator в Power BI Desktop

Примеры запросов

Дополнительные сведения о конкретном устройстве

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

Пример: https://smsprovider.contoso.com/AdminService/wmi/SMS_R_System(16777219)

примеры классов v1 Device

  • Получите все устройства: https://<ProviderFQDN>/AdminService/v1.0/Device

  • Получить одно устройство: https://<ProviderFQDN>/AdminService/v1.0/Device(<ResourceID>)

  • Запустите CMPivot на устройстве:

    Verb: POST
    URI: https://<ProviderFQDN>/AdminService/v1.0/Device(<ResourceID>)/AdminService.RunCMPivot
    Body: {"InputQuery":"<CMPivot query to run>"}
    
  • См. результат задания CMPivot:

    Verb: GET
    URI: https://<ProviderFQDN>/AdminService/v1.0/Device(<ResourceID>)/AdminService.CMPivotResult(OperationId=<Operation ID of the CM Pivot job>)
    
  • Узнайте, какие коллекции принадлежат устройству: https://<ProviderFQDN>/AdminService/v1.0/Device(16777219)/ResourceCollectionMembership?$expand=Collection&$select=Collection

Фильтрация результатов с помощью startswith

В этом примере URI показаны только коллекции, имена которых начинаются с All .

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

Запуск статического метода WMI

В этом примере вызывается метод GetAdminExtendedData на SMS_AdminClass, который принимает параметр Type со значением 1 .

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

Дальнейшие действия

Настраиваемые свойства для устройств