Como usar o serviço de administração no Configuration Manager

Aplica-se a: Configuration Manager (branch atual)

O Configuration Manager usa a API REST do serviço de administração em vários cenários nativos. Você também pode usar o serviço de administração para seus próprios cenários personalizados.

Observação

Todos os exemplos neste artigo usam o FQDN do servidor que hospeda a função de provedor de SMS. Se você acessar o serviço de administração remotamente por meio de um CMG, use o ponto de extremidade do CMG em vez do FQDN do provedor de SMS. Para obter mais informações, consulte Habilitar acesso à Internet.

Consulta direta

Há várias maneiras de consultar diretamente o serviço de administração:

  • Navegador da Web
  • PowerShell
  • Uma ferramenta de terceiros para enviar solicitações HTTPS, GET ou PUT ao serviço Web

As próximas seções abordam os dois primeiros métodos.

Importante

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.

Navegador da Web

Você pode usar um navegador da Web para consultar facilmente o serviço de administração. Quando você especifica um URI de consulta como a URL do navegador, o serviço de administração processa a solicitação GET e retorna o resultado no formato JSON. Alguns navegadores da Web podem não exibir o resultado em um formato fácil de ler.

PowerShell

Faça chamadas diretas para esse serviço com o cmdlet Invoke-RestMethod do Windows PowerShell.

Por exemplo:

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

Esse comando retorna a seguinte saída:

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

O exemplo a seguir faz drill down para valores mais específicos:

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

A saída desse comando é a versão específica do site: 5.00.8968.1000

Chamar o PowerShell a partir de uma sequência de tarefas

Você pode usar o cmdlet Invoke-RestMethod em um script do PowerShell da etapa de sequência de tarefas Executar Script do PowerShell . Essa ação permite consultar o serviço de administração durante uma sequência de tarefas.

Para obter mais informações, consulte Etapas de sequência de tarefas - Executar script do PowerShell.

Power BI Desktop

Você pode usar o Power BI Desktop para consultar dados no Configuration Manager por meio do serviço de administração. Para obter mais informações, consulte O que é o Power BI Desktop?

  1. No Power BI Desktop, na faixa de opções, selecione Obter Dados e selecione Feed OData.

  2. Para a URL, especifique a rota do serviço de administração. Por exemplo, https://smsprovider.contoso.com/AdminService/wmi/

  3. Escolha a Autenticação do Windows.

  4. Na janela Navegador, selecione os itens a serem usados no relatório ou no dashboard do Power BI.

Captura de tela da janela do Navegador no Power BI Desktop

Consultas de exemplo

Obtenha mais detalhes sobre um dispositivo específico

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

Por exemplo: https://smsprovider.contoso.com/AdminService/wmi/SMS_R_System(16777219)

v1 Exemplos de classe de dispositivo

  • Obter todos os dispositivos: https://<ProviderFQDN>/AdminService/v1.0/Device

  • Obtenha um único dispositivo: https://<ProviderFQDN>/AdminService/v1.0/Device(<ResourceID>)

  • Execute o CMPivot em um dispositivo:

    Verb: POST
URI: https://<ProviderFQDN>/AdminService/v1.0/Device(<ResourceID>)/AdminService.RunCMPivot
Body: {"InputQuery":"<CMPivot query to run>"}

  • Consulte o resultado do trabalho CMPirot:

    Verb: GET
URI: https://<ProviderFQDN>/AdminService/v1.0/Device(<ResourceID>)/AdminService.CMPivotResult(OperationId=<Operation ID of the CM Pivot job>)

  • Veja a quais coleções um dispositivo pertence: https://<ProviderFQDN>/AdminService/v1.0/Device(16777219)/ResourceCollectionMembership?$expand=Collection&$select=Collection

Filtrar resultados com startswith

Este exemplo de URI mostra apenas coleções cujos nomes começam com All.

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

Executar um método WMI estático

Este exemplo invoca o método GetAdminExtendedData no SMS_AdminClass que usa o parâmetro chamado Type com valor 1.

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

Próximas etapas

Propriedades personalizadas para dispositivos

  • Last updated on