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

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

Le fournisseur SMS fournit l’accès à l’interopérabilité de l’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 possède 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 pour plus de 700 classes.

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

    Cet itinéraire avec version (version 1.0) prend en charge les nouvelles fonctionnalités configuration manager.

La <ClassName> valeur est un nom de classe Configuration Manager valide. Les noms de classe de service d’administration sont sensibles à la cas. Veillez à utiliser la bonne majuscule. Par exemple : SMS_Site.

Scénarios

Configuration Manager utilise en 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 :

  • Remplacez un service web personnalisé pour accéder aux informations à partir 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 à partir du site sans qu’un service web personnalisé soit mis en interface avec le fournisseur WMI. Pour plus d’informations, voir Étapes de la séquence de tâches - Exécuter le script PowerShell.

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

Conditions préalables

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

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

  • À compter de la version 2107, le fournisseur SMS requiert .NET version 4.6.2 et la version 4.8 est recommandée. Dans les versions 2103 et antérieures, ce rôle requiert .NET 4.5 ou version ultérieure. Pour plus d’informations, conditions préalables 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, voir 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 avoir un compte dans Azure Active Directory (Azure AD).

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

Notes

Pour n’importe quel 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 nodes de sécurité, des erreurs peuvent s’être produit lorsque 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. Set enabled="false"
    2. Ajoutez le FQDN du fournisseur DE SMS au <bypasslist> .

    Pour plus d’informations, <defaultProxy> voir Element (Network Paramètres).

Prochaines étapes