Was ist der Verwaltungsdienst in Configuration Manager?

  • Artikel

Gilt für: Configuration Manager (Current Branch)

Der SMS-Anbieter bietet API-Interoperabilitätszugriff über HTTPS, der als Verwaltungsdienst bezeichnet wird. 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:

  • Verwaltungsdienst > WMI > SQL: 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 Funktionalität.

Der <ClassName> Wert ist ein gültiger Configuration Manager Klassennamen. Bei den Namen der Verwaltungsdienstklassen wird die Groß-/Kleinschreibung beachtet. Stellen Sie sicher, dass Sie die richtige Groß-/Kleinschreibung verwenden. Beispiel: SMS_Site.

Szenarien

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

Darüber hinaus können Sie mit dem Verwaltungsdienst benutzerdefinierte Lösungen entwickeln, z. B.:

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 Webserver (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 hierzu 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.

Für den Zugriff auf den Verwaltungsdienst muss Ihr Benutzerkonto ein Administrator in Configuration Manager sein. Wenn Sie über ein Cloudverwaltungsgateway auf den Verwaltungsdienst zugreifen, benötigen Sie ein Konto in Azure Active Directory (Azure AD).

Weitere Informationen zur Skalierbarkeit des SMS-Anbieters und des Verwaltungsdiensts finden Sie unter Größe und Skalierung von Nummern.

Hinweis

Wenn ein Computer mit der Configuration Manager-Konsole 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. In der Datei SmsAdminUI.log werden z. B. Folgende Fehler angezeigt: 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 zu hinzu <bypasslist>.

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

Nächste Schritte

Einrichten des Verwaltungsdiensts