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

  • Article

S’applique à : Gestionnaire de Configuration (branche actuelle)

Le fournisseur SMS fournit un accès d’interopérabilité d’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 itinéraires :

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

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

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

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

La <ClassName> valeur est un nom de classe Configuration Manager valide. Les noms de classe de service d’administration respectent la casse. Veillez à utiliser la mise en majuscule appropriée. Par exemple : SMS_Site.

Scénarios

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

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

Conditions préalables

Configurez les prérequis suivants sur le serveur qui héberge le rôle Fournisseur SMS :

  • Dans les versions 2006 et antérieures, activez le rôle serveur Windows Serveur Web (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 les versions 2103 et antérieures, ce rôle nécessite .NET 4.5 ou une version ultérieure. Pour plus d’informations, consultez Prérequis pour le site et le système de site.

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

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 Azure Active Directory (Azure AD).

Pour plus d’informations sur la scalabilité du fournisseur SMS et du service d’administration, consultez Taille et numéros d’échelle.

Remarque

Pour toute machine disposant de 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 du 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. Ensemble enabled="false"
    2. Ajoutez le nom de domaine complet du fournisseur SMS au <bypasslist>.

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

Prochaines étapes

Comment configurer le service d’administration