Como utilizar o serviço de administração no Gestor de Configuração

Artigo
08/13/2021

Aplica-se a: Configuration Manager (ramo atual)

O Gestor de Configuração utiliza o serviço de administração REST API em vários cenários nativos. Também pode usar o serviço de administração para os seus cenários personalizados.

Nota

Os exemplos deste artigo utilizam todos o FQDN do servidor que acolhe a função de Fornecedor de SMS. Se aceder remotamente ao serviço de administração através de um CMG, utilize o ponto final cmg em vez do Fornecedor de SMS FQDN. Para obter mais informações, consulte Ativar o acesso à Internet.

Consulta direta

Existem várias formas de consultar diretamente o serviço de administração:

Browser
PowerShell
Uma ferramenta de terceiros para enviar pedidos HTTPS GET ou PUT para o serviço web

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

Importante

Os nomes da classe de serviço da administração são sensíveis a casos. Certifique-se de que utiliza a capitalização adequada. Por exemplo, SMS_Site.

Browser

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

PowerShell

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

Por exemplo:

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

Este comando devolve a seguinte saída:

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

O exemplo a seguir resume-se a 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

Ligue para o PowerShell a partir de uma sequência de tarefas

Pode utilizar o cmdlet Invoke-RestMethod num script PowerShell a partir do passo da sequência de tarefas do Script De Execução PowerShell. Esta ação permite-lhe consultar o serviço de administração durante uma sequência de tarefas.

Para obter mais informações, consulte os passos da sequência de tarefas - Executar PowerShell Script.

Power BI Desktop

Pode utilizar Power BI Desktop para consultar dados no Gestor de Configuração através do serviço de administração. Para mais informações, veja o que é Power BI Desktop?

Na Power BI Desktop, na fita, selecione Obter Dados e selecione o feed OData.
Para a URL, especifique a rota de serviço da administração. Por exemplo, https://smsprovider.contoso.com/AdminService/wmi/
Escolha Windows Autenticação.
Na janela Navigator, selecione os itens a utilizar no seu painel de Power BI ou reporte.

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

Obtenha todos os dispositivos: https://<ProviderFQDN>/AdminService/v1.0/Device
Obter um único dispositivo: https://<ProviderFQDN>/AdminService/v1.0/Device(<ResourceID>)

Executar CMPivot num dispositivo:

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

Consulte o resultado do trabalho da CMPivot:

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

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

Filtrar os resultados com partidas

Este exemplo URI só mostra coleções cujos nomes começam All por.

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 toma o parâmetro denominado Tipo com valor 1 .

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

Passos seguintes

Propriedades personalizadas para dispositivos

Partilhar via