Что такое служба администрирования в Configuration Manager?

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

Поставщик SMS предоставляет доступ к взаимодействию API по протоколу HTTPS, который называется службой администрирования. Служба администрирования представляет собой API передачи репрезентативного состояния (REST), основанный на протоколе Open Data (OData) версии 4.

В настоящее время служба администрирования имеет два уровня или маршрута:

  • Служба > администрирования WMI > SQL: https://<SMSProviderFQDN>/AdminService/wmi/<ClassName>

    Маршрут WMI поддерживает команды GET и POST для более чем 700 классов.

  • Служба > администрирования OData/SQL: https://<SMSProviderFQDN>/AdminService/v1.0/<ClassName>

    Этот маршрут с управлением версиями (версия 1.0) поддерживает новые функции Configuration Manager.

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

Сценарии

Configuration Manager изначально использует службу администрирования для следующих функций:

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

  • Замените настраиваемую веб-службу для доступа к информации с сайта.

  • В PowerShell сценарии, запускаемые непосредственно из консоли Configuration Manager. Дополнительные сведения см. в статье Создание и запуск сценариев PowerShell с консоли Configuration Manager.

  • Сценарий PowerShell в последовательности задач. Это действие позволяет получить доступ к сведениям с сайта без необходимости использования настраиваемой веб-службы для взаимодействия с поставщиком WMI. Дополнительные сведения см. в статье Последовательность задач: выполнение сценария PowerShell.

  • Доступ к данным сайта из Power BI с помощью параметра соединителя OData.

Предварительные условия

Настройте следующие необходимые компоненты для сервера, на котором размещена роль поставщика SMS:

  • В версии 2006 и более ранних версиях включите роль сервера Windows Web Server (IIS). Начиная с версии 2010 эта роль больше не требуется.

  • Начиная с версии 2107, поставщик SMS требует .NET версии 4.6.2, при этом рекомендуется версия 4.8. В версии 2103 и более ранних версиях для этой роли требуется .NET 4.5 или более поздней версии. Дополнительные сведения см. в статье " Требования к сайту и системе сайта".

  • Возможно, вам потребуется включить безопасное соединение HTTPS с доверенным сертификатом. Дополнительные сведения см. в статье Включение безопасного соединения HTTPS.

Чтобы получить доступ к службе администрирования, ваша учетная запись пользователя должна быть администратором в Configuration Manager. Если вы получаете доступ к службе администрирования через шлюз облачного управления, вам необходима учетная запись в Microsoft Entra ID.

Подробнее о масштабируемости SMS-провайдера и службы администрирования см. в разделе Размер и масштабирование номеров.

Примечание.

На любом компьютере с консолью Configuration Manager, если используется прокси-сервер, консоли не удается подключиться к службе администрирования. Например, при попытке доступа к узлам безопасности могут возникать ошибки о том, что служба администрирования не включена или недоступна. В файле SmsAdminUI.log отображаются такие ошибки, как: Failed to get a response for OData query.

Чтобы обойти эту проблему, удалите конфигурацию прокси-сервера с компьютера или внесите следующие изменения в конфигурацию:

  1. Вручную отредактируйте следующий XML-файл: C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe.config

  2. Настройте <defaultproxy> поведение с помощью одного из следующих параметров:

    1. Установите enabled="false"
    2. Добавьте полное доменное имя поставщика SMS в <bypasslist>.

    Дополнительные сведения см. в разделе<defaultProxy> Элемент (Параметры сети).

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