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

Aplica-se ao: 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

Os exemplos neste artigo usam o FQDN do servidor que hospeda a função provedor de SMS. Se você acessar o serviço de administração remotamente por meio de um CMG, use o ponto de extremidade CMG em vez do FQDN do Provedor de SMS. Para obter mais informações, consulte Enable internet access.

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 para o serviço Web

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

Importante

Os nomes de classe do serviço de administração são sensíveis a minúsculas. Certifique-se de usar a capitalização adequada. 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-RestMethodWindows PowerShell .

Por exemplo:

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

Este 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 detalha valores mais específicos:

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

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

Chamar o PowerShell de uma sequência de tarefas

Você pode usar o cmdlet Invoke-RestMethod em um script do PowerShell a partir da etapa executar a sequência de tarefas 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 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 é Power BI Desktop?

  1. Na 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 Windows Autenticação.

  4. Na janela Navegador, selecione os itens a usar no painel Power BI ou relatório.

Captura de tela da janela Navegador no Power BI Desktop

Consultas de exemplo

Obter 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)

Exemplos de classe do dispositivo v1

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

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

  • Execute 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 CMPivot:

    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 URI de exemplo 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 leva o parâmetro chamado Type with value 1 .

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

Próximas etapas

Propriedades personalizadas para dispositivos