Использование службы администрирования в Configuration Manager

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

Configuration Manager использует REST API службы администрирования в нескольких собственных сценариях. Службу администрирования можно также использовать для собственных пользовательских сценариев.

Примечание.

В примерах, приведенных в этой статье, используется полное доменное имя сервера, на котором размещена роль поставщика SMS. При удаленном доступе к службе администрирования через шлюз управления облачными клиентами используйте конечную точку CMG вместо полного доменного имени поставщика 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 из последовательности задач

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

Дополнительные сведения см. в разделе Шаги последовательности задач — выполнение скрипта PowerShell.

Power BI Desktop

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

  1. В Power BI Desktop на ленте выберите Получить данные и выберите веб-канал OData.

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

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

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

Снимок экрана: окно навигатора в Power BI Desktop

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

Получение дополнительных сведений о конкретном устройстве

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

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

Примеры классов устройств версии 1

  • Получение всех устройств: 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}

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

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