Come usare il servizio di amministrazione in Configuration Manager

Si applica a: Configuration Manager (Current Branch)

Configuration Manager usa l'API REST del servizio di amministrazione in diversi scenari nativi. È anche possibile usare il servizio di amministrazione per scenari personalizzati.

Nota

Tutti gli esempi in questo articolo usano il nome di dominio completo del server che ospita il ruolo del provider SMS. Se si accede al servizio di amministrazione in remoto tramite un gateway di gestione cloud, usare l'endpoint CMG anziché il nome di dominio completo del provider SMS. Per ulteriori informazioni, vedere Abilitare l'accesso a Internet.

Query diretta

È possibile eseguire query direttamente sul servizio di amministrazione in diversi modi:

  • Web browser
  • PowerShell
  • Strumento di terze parti per inviare richieste HTTPS, GET o PUT al servizio Web

Nelle sezioni seguenti vengono descritti i primi due metodi.

Importante

I nomi delle classi del servizio di amministrazione fanno distinzione tra maiuscole e minuscole. Assicurarsi di usare le maiuscole corrette. Ad esempio, SMS_Site.

Web browser

È possibile usare un Web browser per eseguire query sul servizio di amministrazione. Quando si specifica un URI di query come URL del browser, il servizio di amministrazione elabora la richiesta GET e restituisce il risultato in formato JSON. Alcuni Web browser potrebbero non visualizzare il risultato in un formato di facile lettura.

PowerShell

Effettuare chiamate dirette a questo servizio con il cmdlet di Windows PowerShell Invoke-RestMethod.

Ad esempio:

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

Questo comando restituisce l'output seguente:

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

L'esempio seguente esegue il drill-down a valori più specifici:

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

L'output di questo comando è la versione specifica del sito: 5.00.8968.1000

Chiamare PowerShell da una sequenza di attività

È possibile usare il cmdlet Invoke-RestMethod in uno script di PowerShell dal passaggio Esegui sequenza di attività script PowerShell . Questa azione consente di eseguire query sul servizio di amministrazione durante una sequenza di attività.

Per altre informazioni, vedere Passaggi della sequenza di attività - Eseguire lo script di PowerShell.

Power BI Desktop

Puoi usare Power BI Desktop per eseguire query sui dati in Configuration Manager tramite il servizio di amministrazione. Per altre informazioni, vedere Che cos'è Power BI Desktop?

  1. In Power BI Desktop, sulla barra multifunzione selezionare Recupera dati e selezionare feed OData.

  2. Per l'URL, specificare la route del servizio di amministrazione. Ad esempio, https://smsprovider.contoso.com/AdminService/wmi/

  3. Scegliere Autenticazione di Windows.

  4. Nella finestra Strumento di navigazione selezionare gli elementi da usare nel dashboard o nel report di Power BI.

Screenshot della finestra Strumento di navigazione in Power BI Desktop

Query di esempio

Ottieni altri dettagli su un dispositivo specifico

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

Ad esempio: https://smsprovider.contoso.com/AdminService/wmi/SMS_R_System(16777219)

Esempi di classi di dispositivi v1

  • Ottieni tutti i dispositivi: https://<ProviderFQDN>/AdminService/v1.0/Device

  • Ottieni un singolo dispositivo: https://<ProviderFQDN>/AdminService/v1.0/Device(<ResourceID>)

  • Eseguire CMPivot in un dispositivo:

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

  • Vedere il risultato del processo CMPivot:

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

  • Vedere a quali raccolte appartiene un dispositivo: https://<ProviderFQDN>/AdminService/v1.0/Device(16777219)/ResourceCollectionMembership?$expand=Collection&$select=Collection

Filtrare i risultati con startswith

Questo URI di esempio mostra solo le raccolte il cui nome inizia con All.

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

Eseguire un metodo WMI statico

In questo esempio viene richiamato il metodo GetAdminExtendedData sul SMS_AdminClass che accetta il parametro denominato Type con valore 1.

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

Passaggi successivi

Proprietà personalizzate per i dispositivi

  • Last updated on