Qual è il servizio di amministrazione in Configuration Manager?

Si applica a: Configuration Manager (Current Branch)

Il provider SMS fornisce l'accesso all'interoperabilità delle 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 ha attualmente due livelli o percorsi:

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

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

• Servizio > di amministrazione OData/SQL: 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 le maiuscole corrette. Ad esempio, SMS_Site.

Scenari

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

• Approvazione delle app tramite Email

• Visualizzare le console connesse di recente

• Nodo di sicurezzadella console

• Collegamento tenant di Microsoft Intune

• Hub della community

• Gestione delle estensioni della console

Inoltre, è possibile sviluppare soluzioni personalizzate con il servizio di amministrazione, ad esempio:

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

• In PowerShell gli script eseguiti direttamente dalla console di Configuration Manager. Per altre informazioni, vedi 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 l'interfaccia di un servizio Web personalizzato con il provider WMI. Per altre informazioni, vedere Passaggi della sequenza di attività - Eseguire lo script di PowerShell.

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

Prerequisiti

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

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

• A partire dalla versione 2107, il provider SMS richiede .NET versione 4.6.2, ed è consigliata la versione 4.8. Nella versione 2103 e precedenti, questo ruolo richiede .NET 4.5 o versione successiva. Per altre informazioni, sito e prerequisiti di 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 disporre di un account in Microsoft Entra ID.

Per ulteriori informazioni sulla scalabilità del provider SMS e del servizio di amministrazione, vedere Numeri di dimensioni e 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 include errori quali: Failed to get a response for OData query.

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

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

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

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

   Per ulteriori informazioni, consultate <defaultProxy> Elemento (Impostazioni di rete).

Passaggi successivi

Come configurare il servizio di amministrazione