Verwenden des Verwaltungsdiensts im Configuration Manager

Gilt für: Configuration Manager (Current Branch)

Configuration Manager verwendet die Verwaltungsdienst-REST-API in mehreren systemeigenen Szenarien. Sie können den Verwaltungsdienst auch für Ihre eigenen benutzerdefinierten Szenarien verwenden.

Hinweis

Alle Beispiele in diesem Artikel verwenden den FQDN des Servers, auf dem die Rolle des SMS-Anbieters gehostet wird. Wenn Sie über eine CMG remote auf den Verwaltungsdienst zugreifen, verwenden Sie den CMG-Endpunkt anstelle des FQDN des SMS-Anbieters. Weitere Informationen finden Sie unter Aktivieren des Internetzugriffs.

Direkte Abfrage

Es gibt mehrere Möglichkeiten, den Verwaltungsdienst direkt abzufragen:

  • Webbrowser
  • PowerShell
  • Ein Drittanbietertool zum Senden von HTTPS-, GET- oder PUT-Anforderungen an den Webdienst

In den nächsten Abschnitten werden die ersten beiden Methoden behandelt.

Wichtig

Bei den Klassennamen des Verwaltungsdiensts muss die Groß-/Kleinschreibung beachtet werden. Achten Sie darauf, die richtige Groß-/Kleinschreibung zu verwenden. Beispiel: SMS_Site.

Webbrowser

Sie können einen Webbrowser verwenden, um den Verwaltungsdienst einfach abzufragen. Wenn Sie einen Abfrage-URI als URL des Browsers angeben, verarbeitet der Verwaltungsdienst die GET-Anforderung und gibt das Ergebnis im JSON-Format zurück. In einigen Webbrowsern wird das Ergebnis möglicherweise nicht in einem einfach lesbaren Format angezeigt.

PowerShell

Direkte Aufrufe an diesen Dienst mit dem Windows PowerShell-Cmdlet Invoke-RestMethod.

Zum Beispiel:

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

Dieser Befehl gibt die folgende Ausgabe zurück:

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

Im folgenden Beispiel werden die spezifischen Werte aufgeschlüsselt:

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

Die Ausgabe dieses Befehls entspricht der spezifischen Version der Website: 5.00.8968.1000

Aufrufen von PowerShell aus einer Tasksequenz

Sie können das Cmdlet "Invoke-RestMethod" in einem PowerShell-Skript aus dem Tasksequenzschritt "PowerShell-Skript ausführen " verwenden. Mit dieser Aktion können Sie den Verwaltungsdienst während einer Tasksequenz abfragen.

Weitere Informationen finden Sie unter Tasksequenzschritte – PowerShell-Skript ausführen.

Power BI Desktop

Sie können Power BI Desktop verwenden, um Daten im Configuration Manager über den Verwaltungsdienst abzufragen. Weitere Informationen finden Sie unter Was ist Power BI Desktop?

  1. Wählen Sie in Power BI Desktop im Menüband die Option "Daten abrufen" und dann "OData-Feed" aus.

  2. Geben Sie für die URL die Route des Verwaltungsdiensts an. Beispiel: https://smsprovider.contoso.com/AdminService/wmi/

  3. Wählen Sie Windows-Authentifizierung aus.

  4. Wählen Sie im Fenster "Navigator" die Elemente aus, die in Ihrem Power BI-Dashboard oder -Bericht verwendet werden sollen.

Screenshot des Fensters

Beispielabfragen

Abrufen weiterer Details zu einem bestimmten Gerät

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

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

v1 Beispiele für Geräteklassen

  • Alle Geräte abrufen: https://<ProviderFQDN>/AdminService/v1.0/Device

  • Einzelnes Gerät abrufen: https://<ProviderFQDN>/AdminService/v1.0/Device(<ResourceID>)

  • Ausführen von CMPivot auf einem Gerät:

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

  • Siehe CMPivot-Auftragsergebnis:

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

  • Sehen Sie sich an, zu welchen Sammlungen ein Gerät gehört: https://<ProviderFQDN>/AdminService/v1.0/Device(16777219)/ResourceCollectionMembership?$expand=Collection&$select=Collection

Filtern von Ergebnissen mit startswith

Diese Beispiel-URI zeigt nur Sammlungen, deren Namen mit Allbeginnen.

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

Ausführen einer statischen WMI-Methode

In diesem Beispiel wird die GetAdminExtendedData-Methode auf der SMS_AdminClass aufgerufen, die den Parameter Type mit dem Wert 1annimmt.

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

Nächste Schritte

Benutzerdefinierte Eigenschaften für Geräte

  • Last updated on