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

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 nuove funzionalità di Configuration Manager.

Il <ClassName> valore è un nome di classe 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:

• Email l'approvazione delle app

• Visualizzare le console connesse di recente

• Nodo Sicurezzadella console

• collegamento tenant Microsoft Intune

• Hub della community

• Gestione delle estensioni della console

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

• Sostituire un servizio Web personalizzato per accedere alle informazioni dal sito.

• Negli script di PowerShell eseguiti direttamente dalla console di Configuration Manager. Per altre informazioni, vedere Creare ed eseguire script di PowerShell dalla console di Configuration Manager.

• Script di PowerShell in una sequenza di attività. Questa azione consente di accedere alle informazioni dal sito senza richiedere un servizio Web personalizzato per l'interfaccia con il provider WMI. Per altre informazioni, vedere Passaggi della sequenza di attività - Eseguire script di PowerShell.

• Accedere ai dati del sito da Power BI usando l'opzione del connettore OData.

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 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. Impostare 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