O que é o serviço de administração no Configuration Manager?

Aplica-se a: Configuration Manager (branch atual)

O provedor SMS fornece acesso de interoperabilidade de API por HTTPS, chamado de serviço de administração. O serviço de administração é uma API REST (transferência de estado representacional) baseada no protocolo OData (Open Data) v4.

No momento, o serviço de administração tem duas camadas ou rotas:

  • Serviço de > administração WMI > SQL: https://<SMSProviderFQDN>/AdminService/wmi/<ClassName>

    A rota WMI dá suporte a comandos GET e POST para mais de 700 classes.

  • Serviço > de administração OData/SQL: https://<SMSProviderFQDN>/AdminService/v1.0/<ClassName>

    Esta rota com controle de versão (v1.0) dá suporte à nova funcionalidade do Configuration Manager.

O <ClassName> valor é um nome de classe válido do Configuration Manager. Os nomes de classe de serviço de administração diferenciam maiúsculas de minúsculas. Use as letras maiúsculas adequadas. Por exemplo, SMS_Site.

Cenários

O Configuration Manager usa nativamente o serviço de administração para os seguintes recursos:

Além disso, você pode desenvolver soluções personalizadas com o serviço de administração, por exemplo:

Pré-requisitos

Configure os seguintes pré-requisitos no servidor que hospeda a função de Provedor de SMS:

  • Na versão 2006 e anterior, habilite a função de servidor Web do Windows (IIS). A partir da versão 2010, essa função não é mais necessária.

  • A partir da versão 2107, o provedor SMS requer o .NET versão 4.6.2, e a versão 4.8 é recomendada. Na versão 2103 e anteriores, essa função requer o .NET 4.5 ou posterior. Para obter mais informações, Pré-requisitos do site e do sistema de sites.

  • Talvez seja necessário habilitar a comunicação HTTPS segura com um certificado confiável. Para obter mais informações, consulte Habilitar comunicação HTTPS segura.

Para acessar o serviço de administração, sua conta de usuário precisa ser um usuário administrativo no Configuration Manager. Se você acessar o serviço de administração por meio de um gateway de gerenciamento de nuvem, precisará ter uma conta no Microsoft Entra ID.

Para obter mais informações sobre a escalabilidade do provedor de SMS e do serviço de administração, consulte Números de tamanho e escala.

Observação

Para qualquer computador com o console do Configuration Manager, se estiver usando um servidor proxy, o console não se conectará ao serviço de administração. Por exemplo, ao tentar acessar os nós de segurança , você pode ver erros indicando que o serviço de administração não está habilitado ou disponível. O arquivo SmsAdminUI.log mostra erros como, Failed to get a response for OData query.

Para contornar esse problema, remova a configuração de proxy do computador ou faça a seguinte alteração de configuração:

  1. Edite manualmente o seguinte arquivo XML: C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe.config

  2. Configure o <defaultproxy> comportamento com uma das seguintes opções:

    1. Defina enabled="false"
    2. Adicione o FQDN do provedor SMS ao <bypasslist>.

    Para obter mais informações, consulte <defaultProxy> Elemento (Configurações de Rede).

Próximas etapas