Was ist der Verwaltungsdienst im Configuration Manager?

Gilt für: Configuration Manager (Current Branch)

Der SMS-Anbieter bietet API-Interoperabilitätszugriff über HTTPS, den sogenannten Verwaltungsdienst. Der Verwaltungsdienst ist eine REST-API (Representational State Transfer), die auf dem Open Data (OData) v4-Protokoll basiert.

Der Verwaltungsdienst verfügt derzeit über zwei Ebenen oder Routen:

  • WMI > SQL-Code für den Verwaltungsdienst>:https://<SMSProviderFQDN>/AdminService/wmi/<ClassName>

    Die WMI-Route unterstützt sowohl GET- als auch POST-Befehle für über 700 Klassen.

  • Verwaltungsdienst > OData/SQL: https://<SMSProviderFQDN>/AdminService/v1.0/<ClassName>

    Diese versionierte Route (v1.0) unterstützt neue Configuration Manager-Funktionen.

Der <ClassName> Wert ist ein gültiger Configuration Manager-Klassenname. Bei den Klassennamen des Verwaltungsdiensts muss die Groß-/Kleinschreibung beachtet werden. Achten Sie darauf, die richtige Groß-/Kleinschreibung zu verwenden. Beispiel: SMS_Site.

Szenarien

Configuration Manager verwendet den Verwaltungsdienst nativ für die folgenden Funktionen:

Darüber hinaus können Sie mit dem Administrationsservice individuelle Lösungen entwickeln, zum Beispiel:

  • Ersetzen eines benutzerdefinierten Webdiensts für den Zugriff auf Informationen von der Website.

  • In PowerShell-Skripts, die Sie direkt über die Configuration Manager-Konsole ausführen. Weitere Informationen finden Sie unter Erstellen und Ausführen von PowerShell-Skripts über die Configuration Manager-Konsole.

  • Ein PowerShell-Skript in einer Tasksequenz. Mit dieser Aktion können Sie auf Informationen von der Website zugreifen, ohne dass ein benutzerdefinierter Webdienst als Schnittstelle mit dem WMI-Anbieter fungieren muss. Weitere Informationen finden Sie unter Tasksequenzschritte – PowerShell-Skript ausführen.

  • Greifen Sie über die OData-Connectoroption auf Websitedaten aus Power BI zu.

Voraussetzungen

Konfigurieren Sie die folgenden Voraussetzungen auf dem Server, der die SMS-Anbieterrolle hostet:

  • Aktivieren Sie in Version 2006 und früher die Windows-Serverrolle Web Server (IIS). Ab Version 2010 ist diese Rolle nicht mehr erforderlich.

  • Ab Version 2107 erfordert der SMS-Anbieter .NET Version 4.6.2, und Version 4.8 wird empfohlen. In Version 2103 und früher erfordert diese Rolle .NET 4.5 oder höher. Weitere Informationen finden Sie unter "Voraussetzungen für Standort und Standortsystem".

  • Möglicherweise müssen Sie die sichere HTTPS-Kommunikation mit einem vertrauenswürdigen Zertifikat aktivieren. Weitere Informationen finden Sie unter Aktivieren der sicheren HTTPS-Kommunikation.

Um auf den Verwaltungsdienst zugreifen zu können, muss Ihr Benutzerkonto ein Administrator im Configuration Manager sein. Wenn Sie über ein Cloudverwaltungsgateway auf den Verwaltungsdienst zugreifen, benötigen Sie ein Konto in Microsoft Entra ID.

Weitere Informationen zur Skalierbarkeit des SMS-Anbieters und des Verwaltungsdiensts finden Sie unter Größen- und Skalierungsnummern.

Hinweis

Bei jedem Computer mit der Configuration Manager-Konsole, der einen Proxyserver verwendet, kann die Konsole keine Verbindung mit dem Verwaltungsdienst herstellen. Wenn Sie beispielsweise versuchen, auf die Sicherheitsknoten zuzugreifen, werden möglicherweise Fehler angezeigt, dass der Verwaltungsdienst nicht aktiviert oder verfügbar ist. Die SmsAdminUI.log Datei zeigt Fehler an wie z. B.: Failed to get a response for OData query.

Um dieses Problem zu umgehen, entfernen Sie entweder die Proxykonfiguration vom Computer, oder nehmen Sie die folgende Konfigurationsänderung vor:

  1. Bearbeiten Sie die folgende XML-Datei manuell: C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe.config

  2. Konfigurieren Sie das <defaultproxy> Verhalten mit einer der folgenden Optionen:

    1. Set enabled="false"
    2. Fügen Sie den FQDN des SMS-Anbieters zur <bypasslist>.

    Weitere Informationen finden Sie unter <defaultProxy> Element (Netzwerkeinstellungen).

Nächste Schritte