Uso del servicio de administración en Configuration Manager

  • Artículo

Se aplica a: Configuration Manager (rama actual)

Configuration Manager usa la API REST del servicio de administración en varios escenarios nativos. También puede usar el servicio de administración para sus propios escenarios personalizados.

Nota:

Los ejemplos de este artículo usan el FQDN del servidor que hospeda el rol proveedor de SMS. Si accede al servicio de administración de forma remota a través de un CMG, use el punto de conexión de CMG en lugar del FQDN del proveedor de SMS. Para obtener más información, vea Habilitar el acceso a Internet.

Consulta directa

Hay varias maneras de consultar directamente el servicio de administración:

  • Explorador web
  • PowerShell
  • Una herramienta de terceros para enviar solicitudes HTTPS GET o PUT al servicio web

En las secciones siguientes se tratan los dos primeros métodos.

Importante

Los nombres de clase del servicio de administración distinguen mayúsculas de minúsculas. Asegúrese de usar la mayúscula adecuada. Por ejemplo, SMS_Site.

Explorador web

Puede usar un explorador web para consultar fácilmente el servicio de administración. Cuando se especifica un URI de consulta como dirección URL del explorador, el servicio de administración procesa la solicitud GET y devuelve el resultado en formato JSON. Es posible que algunos exploradores web no muestren el resultado en un formato fácil de leer.

PowerShell

Realice llamadas directas a este servicio con el cmdlet Invoke-RestMethod de Windows PowerShell.

Por ejemplo:

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

Este comando devuelve la siguiente salida:

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

En el ejemplo siguiente se exploran en profundidad los valores más específicos:

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

La salida de este comando es la versión específica del sitio: 5.00.8968.1000

Llamada a PowerShell desde una secuencia de tareas

Puede usar el cmdlet Invoke-RestMethod en un script de PowerShell desde el paso de secuencia de tareas Ejecutar script de PowerShell . Esta acción le permite consultar el servicio de administración durante una secuencia de tareas.

Para obtener más información, consulte Pasos de secuencia de tareas: ejecución de script de PowerShell.

Power BI Desktop

Puede usar Power BI Desktop para consultar datos en Configuration Manager a través del servicio de administración. Para obtener más información, consulte ¿Qué es Power BI Desktop?

  1. En Power BI Desktop, en la cinta de opciones, seleccione Obtener datos y seleccione Fuente de OData.

  2. Para la dirección URL, especifique la ruta del servicio de administración. Por ejemplo: https://smsprovider.contoso.com/AdminService/wmi/

  3. Elija Autenticación de Windows.

  4. En la ventana Navegador , seleccione los elementos que se van a usar en el panel o informe de Power BI.

Captura de pantalla de la ventana Navegador en Power BI Desktop

Consultas de ejemplo

Obtener más detalles sobre un dispositivo específico

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

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

Ejemplos de clase de dispositivo v1

  • Obtener todos los dispositivos: https://<ProviderFQDN>/AdminService/v1.0/Device

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

  • Ejecute CMPivot en un dispositivo:

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

  • Consulte el resultado del trabajo de CMPivot:

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

  • Vea a qué colecciones pertenece un dispositivo: https://<ProviderFQDN>/AdminService/v1.0/Device(16777219)/ResourceCollectionMembership?$expand=Collection&$select=Collection

Filtrar los resultados con startswith

Este URI de ejemplo solo muestra colecciones cuyos nombres comienzan por All.

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

Ejecución de un método WMI estático

En este ejemplo se invoca el método GetAdminExtendedData en el SMS_AdminClass que toma el parámetro denominado Type con el valor 1.

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

Pasos siguientes

Propiedades personalizadas para dispositivos