Qu’est-ce que le service d’administration dans Configuration Manager ?

S’applique à : Configuration Manager (branche actuelle)

Le fournisseur SMS fournit un accès à l’interopérabilité des API via HTTPS, appelé service d’administration. Le service d’administration est une API REST (Representational State Transfer) basée sur le protocole Open Data (OData) v4.

Le service d’administration a actuellement deux couches ou routes :

• Service > d’administration WMI > SQL : https://<SMSProviderFQDN>/AdminService/wmi/<ClassName>

  L’itinéraire WMI prend en charge les commandes GET et POST vers plus de 700 classes.

• Service d’administration > OData/SQL : https://<SMSProviderFQDN>/AdminService/v1.0/<ClassName>

  Cet itinéraire versionné (v1.0) prend en charge les nouvelles fonctionnalités de Configuration Manager.

La <ClassName> valeur est un nom de classe Configuration Manager valide. Les noms des classes de service d’administration ne respectent pas la casse. Assurez-vous d’utiliser la bonne casse. Par exemple : SMS_Site.

Scénarios

Configuration Manager utilise en mode natif le service d’administration pour les fonctionnalités suivantes :

• Approbation des applications par email

• Afficher les consoles récemment connectées

• Nœud Sécuritéde la console

• Attachement de client Microsoft Intune

• Hub communauté

• Gestion des extensions de console

De plus, vous pouvez développer des solutions personnalisées avec le service d’administration, par exemple :

• Remplacez un service web personnalisé pour accéder aux informations du site.

• Dans les scripts PowerShell que vous exécutez directement à partir de la console Configuration Manager. Pour plus d’informations, voir Créer et exécuter des scripts PowerShell à partir de la console Configuration Manager.

• Script PowerShell dans une séquence de tâches. Cette action vous permet d’accéder aux informations du site sans avoir besoin d’un service web personnalisé pour s’interfacer avec le fournisseur WMI. Pour plus dʼinformations, consultez Étapes de séquence de tâches : exécuter le script PowerShell.

• Accédez aux données de site à partir de Power BI à l’aide de l’option de connecteur OData.

Configuration requise

Configurez les conditions préalables suivantes sur le serveur qui héberge le rôle Fournisseur SMS :

• Dans la version 2006 et antérieure, activez le rôle serveur Windows Web Server (IIS). À compter de la version 2010, ce rôle n’est plus nécessaire.

• À compter de la version 2107, le fournisseur SMS nécessite .NET version 4.6.2, et la version 4.8 est recommandée. Dans la version 2103 et les versions antérieures, ce rôle nécessite .NET 4.5 ou une version ultérieure. Pour plus d’informations, Conditions préalables relatives au site et au système de site.

• Vous devrez peut-être activer la communication HTTPS sécurisée avec un certificat approuvé. Pour plus d’informations, voir Activer la communication sécurisée HTTPS.

Pour accéder au service d’administration, votre compte d’utilisateur doit être un utilisateur administratif dans Configuration Manager. Si vous accédez au service d’administration via une passerelle de gestion cloud, vous devez disposer d’un compte dans Microsoft Entra ID.

Pour plus d’informations sur l’évolutivité du fournisseur SMS et du service d’administration, voir Taille et mise à l’échelle des nombres.

Remarque

Pour tout ordinateur avec la console Configuration Manager, si elle utilise un serveur proxy, la console ne parvient pas à se connecter au service d’administration. Par exemple, lorsque vous essayez d’accéder aux nœuds de sécurité , vous pouvez voir des erreurs indiquant que le service d’administration n’est pas activé ou disponible. Le fichier SmsAdminUI.log affiche des erreurs telles que : Failed to get a response for OData query.

Pour contourner ce problème, supprimez la configuration proxy de l’ordinateur ou modifiez la configuration suivante :

1. Modifiez manuellement le fichier XML suivant : C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe.config

2. Configurez le <defaultproxy> comportement avec l’une des options suivantes :

   1. L’ensemble enabled="false"
   2. Ajoutez le FQDN du fournisseur SMS au <bypasslist>fichier .

   Pour plus d’informations, consultez <defaultProxy> Élément (Paramètres réseau).

Étapes suivantes

Comment configurer le service d’administration