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

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

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

Примечание.

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

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

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

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

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

Важно!

Имена классов службы администрирования чувствительны к регистру. Убедитесь, что вы правильно написаны прописными буквами. Например, SMS_Site.

Веб-браузер

Вы можете легко запросить эту службу с помощью веб-браузера. Если в качестве URL-адреса браузера указан универсальный код ресурса (URI) запроса, служба администрирования обрабатывает запрос 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)

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

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

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

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

  • Last updated on