Co to jest usługa administracyjna w programie Configuration Manager?

Dotyczy: programu Configuration Manager (bieżąca gałąź)

Dostawca SMS zapewnia dostęp do współdziałania interfejsu API za pośrednictwem protokołu HTTPS, nazywany usługą administracyjną. Usługa administracji jest interfejsem API REST (Representational State Transfer) opartym na protokole Open Data (OData) v4.

Usługa administracji ma obecnie dwie warstwy czyli trasy:

  • Usługa > administracyjna WMI > SQL: https://<SMSProviderFQDN>/AdminService/wmi/<ClassName>

    Trasa WMI obsługuje zarówno polecenia GET, jak i POST do ponad 700 klas.

  • Usługa > administracji OData/SQL: https://<SMSProviderFQDN>/AdminService/v1.0/<ClassName>

    Ta trasa w wersji (wersja 1.0) obsługuje nowe funkcje programu Configuration Manager.

Wartość <ClassName> jest prawidłową nazwą klasy programu Configuration Manager. W nazwach klas usług administracji jest uwzględniana wielkość liter. Pamiętaj, aby prawidłowo pisać wielkimi literami. Na przykład SMS_Site.

Scenariusze

Program Configuration Manager natywnie używa usługi administracji dla następujących funkcji:

Ponadto za pomocą usługi administracyjnej można opracowywać niestandardowe rozwiązania, na przykład:

Wymagania wstępne

Skonfiguruj następujące wymagania wstępne na serwerze hostującym rolę dostawcy SMS:

  • W wersji 2006 i starszych włącz rolę serwera systemu Windows Serwer sieci Web (IIS). Począwszy od wersji 2010, ta rola nie jest już wymagana.

  • Począwszy od wersji 2107, dostawca SMS wymaga platformy .NET w wersji 4.6.2, a zalecana jest wersja 4.8. W wersji 2103 i starszych ta rola wymaga oprogramowania .NET 4.5 lub nowszego. Aby uzyskać więcej informacji, zobacz wymagania wstępne dotyczące lokacji i systemu lokacji.

  • Może być konieczne włączenie bezpiecznej komunikacji HTTPS z zaufanym certyfikatem. Aby uzyskać więcej informacji, zobacz Włączanie bezpiecznej komunikacji HTTPS.

Aby uzyskać dostęp do usługi administracyjnej, Twoje konto użytkownika musi być użytkownikiem administracyjnym w programie Configuration Manager. Jeśli uzyskujesz dostęp do usługi administracji za pośrednictwem bramy zarządzania chmurą, musisz mieć konto w usłudze Microsoft Entra ID.

Aby uzyskać więcej informacji na temat skalowalności dostawcy SMS i usługi administracyjnej, zobacz Rozmiar i skalowanie liczb.

Uwaga

Dla dowolnego komputera z konsolą programu Configuration Manager, jeśli korzysta ona z serwera proxy, konsola nie może nawiązać połączenia z usługą administracji. Na przykład podczas próby uzyskania dostępu do węzłów zabezpieczeń mogą zostać wyświetlone błędy informujące o tym, że usługa administracyjna nie jest włączona lub dostępna. Plik SmsAdminUI.log wyświetla błędy, takie jak: Failed to get a response for OData query.

Aby obejść ten problem, usuń konfigurację serwera proxy z komputera lub wprowadź następujące zmiany w konfiguracji:

  1. Ręcznie edytuj następujący plik XML: C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe.config

  2. Skonfiguruj zachowanie <defaultproxy> przy użyciu jednej z następujących opcji:

    1. Zestaw enabled="false"
    2. Dodaj nazwę FQDN dostawcy wiadomości SMS do pola <bypasslist>

    Aby uzyskać więcej informacji, zobacz <defaultProxy> Element (ustawienia sieciowe).

Następne kroki