Condividi tramite

Che cos'è il servizio di amministrazione in Configuration Manager?

  • Articolo

Si applica a: Configuration Manager (Current Branch)

Il provider SMS fornisce l'accesso all'interoperabilità API tramite HTTPS, denominato servizio di amministrazione. Il servizio di amministrazione è un'API REST (Representational State Transfer) basata sul protocollo Open Data (OData) v4.

Il servizio di amministrazione dispone attualmente di due livelli o route:

  • SQL WMI > del servizio > di amministrazione:https://<SMSProviderFQDN>/AdminService/wmi/<ClassName>

    La route WMI supporta i comandi GET e POST a oltre 700 classi.

  • OData/SQL del servizio > di amministrazione: https://<SMSProviderFQDN>/AdminService/v1.0/<ClassName>

    Questa route con versione (v1.0) supporta le nuove funzionalità di Configuration Manager.

Il <ClassName> valore è un nome di classe di Configuration Manager valido. I nomi delle classi del servizio di amministrazione fanno distinzione tra maiuscole e minuscole. Assicurarsi di usare la maiuscola appropriata. Ad esempio, SMS_Site.

Scenari

Configuration Manager usa in modo nativo il servizio di amministrazione per le funzionalità seguenti:

È anche possibile sviluppare soluzioni personalizzate con il servizio di amministrazione, ad esempio:

Prerequisiti

Configurare i prerequisiti seguenti nel server che ospita il ruolo del provider SMS:

  • Nella versione 2006 e versioni precedenti abilitare il server Web (IIS) del ruolo server Windows. A partire dalla versione 2010, questo ruolo non è più necessario.

  • A partire dalla versione 2107, il provider SMS richiede .NET versione 4.6.2 e la versione 4.8 è consigliata. Nella versione 2103 e versioni precedenti, questo ruolo richiede .NET 4.5 o versione successiva. Per altre informazioni, vedere Prerequisiti del sito e del sistema del sito.

  • Potrebbe essere necessario abilitare la comunicazione HTTPS sicura con un certificato attendibile. Per altre informazioni, vedere Abilitare la comunicazione HTTPS sicura.

Per accedere al servizio di amministrazione, l'account utente deve essere un utente amministratore in Configuration Manager. Se si accede al servizio di amministrazione tramite un gateway di gestione cloud, è necessario avere un account in Microsoft Entra ID.

Per altre informazioni sulla scalabilità del provider SMS e del servizio di amministrazione, vedere Dimensioni e numeri di scalabilità.

Nota

Per qualsiasi computer con la console di Configuration Manager, se usa un server proxy, la console non riesce a connettersi al servizio di amministrazione. Ad esempio, quando si tenta di accedere ai nodi di sicurezza , è possibile che vengano visualizzati errori che indicano che il servizio di amministrazione non è abilitato o disponibile. Il file SmsAdminUI.log mostra errori come, ad esempio, Failed to get a response for OData query.

Per risolvere questo problema, rimuovere la configurazione del proxy dal computer o apportare la modifica della configurazione seguente:

  1. Modificare manualmente il file XML seguente: C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe.config

  2. Configurare il <defaultproxy> comportamento con una delle opzioni seguenti:

    1. Mettere enabled="false"
    2. Aggiungere il nome di dominio completo del provider SMS a <bypasslist>.

    Per altre informazioni, vedere <defaultProxy> Element (Network Settings).

Passaggi successivi

Come configurare il servizio di amministrazione