Qu’est-ce que le service d’administration dans Configuration Manager ?
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 :
Nœud Sécuritéde la console
attachement de locataire Microsoft Intune
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 du site.
Dans les scripts PowerShell que vous exécutez directement à partir de la console Configuration Manager. Pour plus d’informations, consultez Créer et exécuter des scripts PowerShell à partir de la console Configuration Manager.
Un 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 un script PowerShell.
Accédez aux données de site à partir de Power BI à l’aide de l’option de connecteur OData.
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 :
Modifiez manuellement le fichier XML suivant :
C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe.config
Configurez le
<defaultproxy>
comportement avec l’une des options suivantes :- Ensemble
enabled="false"
- Ajoutez le nom de domaine complet du fournisseur SMS au
<bypasslist>
.
Pour plus d’informations, consultez
<defaultProxy>
Élément (Paramètres réseau) .- Ensemble