Utiliser l’outil de connexion de service pour Configuration Manager

  • Article

S’applique à : Configuration Manager (branche actuelle)

Utilisez l’outil de connexion de service lorsque votre point de connexion de service est en mode hors connexion. Vous pouvez également l’utiliser lorsque vos serveurs de système de site Configuration Manager ne sont pas connectés à Internet. L’outil peut vous aider à maintenir votre site à jour avec les dernières mises à jour de Configuration Manager.

Lorsque vous exécutez l’outil, il se connecte au service cloud Configuration Manager, charge les informations d’utilisation de votre hiérarchie et télécharge les mises à jour. Le chargement des données d’utilisation est nécessaire pour permettre au service cloud de fournir les mises à jour appropriées pour votre environnement.

Configuration requise

  • Le site dispose d’un point de connexion de service et vous le configurez pour une connexion hors connexion à la demande.

  • Exécutez l’outil à partir d’une invite de commandes en tant qu’administrateur. Il n’y a pas d’interface utilisateur.

  • Vous exécutez l’outil à partir du point de connexion de service et d’un ordinateur qui peut se connecter à Internet. Chacun de ces ordinateurs doit avoir un système d’exploitation x64 bits et avoir les composants suivants :

    • Les fichiers Visual C++ Redistributable x86 et x64. Par défaut, Configuration Manager installe la version x64 sur l’ordinateur qui héberge le point de connexion de service. Cet outil nécessite le package redistribuable Microsoft Visual C++ 2015-2019 (14.28.29914.0) ou version ultérieure sur l’ordinateur à partir duquel vous l’exécutez. Pour télécharger ce composant, consultez Les derniers téléchargements pris en charge par Microsoft Visual Visual C++ Redistributable.

      Remarque

      En cas de mise à niveau à partir d’une version non prise en charge de Configuration Manager antérieure à la version 2107, l’outil nécessite le packate redistributalbe Visual C++ 2013 (12.0.40660.0), qui est disponible à partir du même lien.

    • Cet outil nécessite .NET version 4.6.2 et la version 4.8 est recommandée. Pour plus d’informations, consultez Prérequis pour le site et le système de site.

    • À compter de la version 2309, cet outil nécessite l’installation du pilote ODBC 18 pour SQL Server (x64). Pour télécharger ce composant, consultez Télécharger le pilote ODBC pour SQL Server.

  • Le compte que vous utilisez pour exécuter l’outil a besoin des autorisations suivantes :

    • Administrateur local sur l’ordinateur qui héberge le point de connexion de service

    • Autorisations de lecture sur la base de données du site

  • Vous avez besoin d’une méthode pour transférer les fichiers entre l’ordinateur disposant d’un accès à Internet et le point de connexion de service. Par exemple, un lecteur USB avec suffisamment d’espace libre pour stocker les fichiers et les mises à jour.

Aperçu

  1. Préparer : exécutez l’outil sur le point de connexion de service. Il place vos données d’utilisation dans un fichier .cab à l’emplacement que vous spécifiez. Copiez le fichier de données sur l’ordinateur avec une connexion Internet.

  2. Connexion : exécutez l’outil sur l’ordinateur avec une connexion Internet. Il charge vos données d’utilisation, puis télécharge les mises à jour de Configuration Manager. Copiez les mises à jour téléchargées sur le point de connexion de service.

    Vous pouvez charger plusieurs fichiers de données à la fois, chacun provenant d’une hiérarchie différente. Vous pouvez également spécifier un serveur proxy et un utilisateur pour le serveur proxy.

  3. Importer : exécutez l’outil sur le point de connexion de service. Il importe les mises à jour et les ajoute à votre site. Vous pouvez ensuite afficher et installer ces mises à jour dans la console Configuration Manager.

Charger plusieurs fichiers de données

  • Placez tous les fichiers de données exportés de hiérarchies distinctes dans le même dossier. Donnez un nom unique à chaque fichier. Si nécessaire, vous pouvez les renommer manuellement.

  • Lorsque vous exécutez l’outil pour charger des données sur Microsoft, vous spécifiez le dossier qui contient les fichiers de données.

  • Lorsque vous exécutez l’outil pour importer des données, l’outil importe uniquement les données de cette hiérarchie.

Spécifier un serveur proxy

Si l’ordinateur disposant d’une connexion Internet nécessite un serveur proxy, l’outil prend en charge une configuration proxy de base. Utilisez les paramètres facultatifs -proxyserveruri et -proxyusername. Pour plus d’informations, consultez Paramètres de ligne de commande.

Spécifier le type de mises à jour à télécharger

L’outil prend en charge les options permettant de contrôler les fichiers que vous téléchargez. Par défaut, l’outil télécharge uniquement la dernière mise à jour disponible qui s’applique à la version de votre site. Il ne télécharge pas les correctifs logiciels.

Pour modifier ce comportement, utilisez l’un des paramètres suivants pour modifier les fichiers téléchargés :

  • -downloadall : téléchargez toutes les mises à jour, y compris les mises à jour et les correctifs logiciels, quelle que soit la version de votre site.

  • -downloadhotfix : téléchargez tous les correctifs logiciels, quelle que soit la version de votre site.

  • -downloadsiteversion : télécharge les mises à jour et les correctifs logiciels avec une version ultérieure à la version de votre site.

    Importante

    En raison d’un problème connu dans Configuration Manager version 2002, le comportement par défaut ne fonctionne pas comme prévu. Effectuez une mise à jour vers la version 2006 ou utilisez le paramètre -downloadsiteversion pour télécharger les mises à jour nécessaires pour la version 2002.

Pour plus d’informations, consultez Paramètres de ligne de commande.

Conseil

L’outil détermine la version de votre site à partir du fichier de données. Pour vérifier la version, recherchez dans le fichier .cab le fichier texte nommé avec la version du site.

Utiliser l’outil

L’outil de connexion de service se trouve sur le support d’installation de Configuration Manager au chemin d’accès suivant : SMSSETUP\TOOLS\ServiceConnectionTool\ServiceConnectionTool.exe. Utilisez toujours l’outil de connexion de service qui correspond à la version de Configuration Manager que vous utilisez. Tous ces fichiers doivent se trouver dans le même dossier pour que l’outil de connexion de service fonctionne.

Copiez le dossier ServiceConnectionTool avec tout son contenu sur l’ordinateur disposant d’une connexion Internet.

Dans cette procédure, les exemples de ligne de commande utilisent les noms de fichiers et les emplacements de dossiers suivants. Vous n’avez pas besoin d’utiliser ces chemins et noms de fichiers. Vous pouvez utiliser des alternatives qui correspondent à votre environnement et à vos préférences.

  • Chemin d’accès aux fichiers sources du support d’installation de Configuration Manager sur le point de connexion de service : C:\Source

  • Chemin d’accès à un lecteur USB où vous stockez les données à transférer entre les ordinateurs : D:\USB\

  • Nom du fichier de données que vous exportez à partir du site : UsageData.cab

  • Nom du dossier vide où l’outil stocke les mises à jour téléchargées pour Configuration Manager : UpdatePacks

Préparation

  1. Sur l’ordinateur qui héberge le point de connexion de service, ouvrez une invite de commandes en tant qu’administrateur, puis accédez à l’emplacement de l’outil dans le répertoire. Par exemple :

    cd C:\Source\SMSSETUP\TOOLS\ServiceConnectionTool\

  2. Exécutez la commande suivante pour préparer le fichier de données :

    ServiceConnectionTool.exe -prepare -usagedatadest D:\USB\UsageData.cab

    Remarque

    Si vous souhaitez charger des fichiers de données à partir de plusieurs hiérarchies en même temps, attribuez un nom unique à chaque fichier de données. Si nécessaire, vous pouvez renommer les fichiers ultérieurement.

    Les données contenues dans le fichier sont basées sur le niveau de données de diagnostic et d’utilisation que vous configurez pour le site. Pour plus d’informations, consultez Vue d’ensemble des données de diagnostic et d’utilisation. Vous pouvez utiliser l’outil pour exporter les données vers un fichier CSV afin d’afficher le contenu. Pour plus d’informations, consultez -export.

  3. Une fois que l’outil a terminé d’exporter les données d’utilisation, copiez le fichier de données sur un ordinateur qui a accès à Internet.

Se connecter

  1. Sur l’ordinateur disposant d’un accès à Internet, ouvrez une invite de commandes en tant qu’administrateur et accédez au répertoire à l’emplacement de l’outil. Cet emplacement est une copie de l’intégralité du dossier ServiceConnectionTool . Par exemple :

    cd D:\USB\ServiceConnectionTool\

  2. Exécutez la commande suivante pour charger le fichier de données et télécharger les mises à jour de Configuration Manager :

    ServiceConnectionTool.exe -connect -usagedatasrc D:\USB -updatepackdest D:\USB\UpdatePacks

    Pour plus d’exemples, consultez Paramètres de ligne de commande.

    Remarque

    Lorsque vous exécutez cette ligne de commande, l’erreur suivante peut s’afficher :

    Exception non prise en charge : System.UnauthorizedAccessException : l’accès au chemin « C :\Users\jqpublic\AppData\Local\Temp\extractmanifestcab\95F8A562.sql » est refusé.

    Vous pouvez ignorer cette erreur en toute sécurité. Fermez la fenêtre d’erreur pour continuer.

  3. Une fois que l’outil a terminé le téléchargement des mises à jour, copiez-les sur le point de connexion de service.

Importation

  1. Sur l’ordinateur qui héberge le point de connexion de service, ouvrez une invite de commandes en tant qu’administrateur, puis accédez à l’emplacement de l’outil dans le répertoire. Par exemple :

    cd C:\Source\SMSSETUP\TOOLS\ServiceConnectionTool\

  2. Exécutez la commande suivante pour importer les mises à jour :

    ServiceConnectionTool.exe -import -updatepacksrc D:\USB\UpdatePacks

  3. Une fois l’importation terminée, fermez l’invite de commandes. Il importe uniquement les mises à jour pour la hiérarchie applicable.

  4. Dans la console Configuration Manager, accédez à l’espace de travail Administration , puis sélectionnez le nœud Mises à jour et maintenance . Les mises à jour importées peuvent désormais être installées. Pour plus d’informations, consultez Installer des mises à jour dans la console.

Fichiers journaux

  • ServiceConnectionTool.log : chaque fois que vous exécutez l’outil de connexion de service, il écrit dans ce fichier journal. Le chemin d’accès du fichier journal est toujours le même emplacement que l’outil. Ce fichier journal fournit des détails simples sur l’utilisation de l’outil en fonction des paramètres que vous utilisez. Chaque fois que vous exécutez l’outil, l’outil remplace n’importe quel fichier journal existant.

  • ConfigMgrSetup.log : pendant la phase Connexion , l’outil écrit dans ce fichier journal à la racine du lecteur système. Ce fichier journal fournit des informations plus détaillées. Par exemple, les fichiers téléchargés par l’outil et si les vérifications de hachage réussissent.

Paramètres de ligne de commande

Cette section répertorie par ordre alphabétique tous les paramètres disponibles pour l’outil de connexion de service.

-relier

Utilisez pendant la phase Connexion sur l’ordinateur disposant d’un accès à Internet. Il se connecte au service cloud Configuration Manager pour charger le fichier de données et télécharger les mises à jour.

Elle nécessite les paramètres suivants :

  • -usagedatasrc : emplacement du fichier de données à charger
  • -updatepackdest : chemin d’accès pour les mises à jour téléchargées

Vous pouvez également utiliser les paramètres facultatifs suivants :

  • -proxyserveruri : nom de domaine complet du serveur proxy
  • -proxyusername : nom d’utilisateur pour le serveur proxy
  • -downloadall : téléchargez tout, y compris les mises à jour et les correctifs logiciels, quelle que soit la version de votre site.
  • -downloadhotfix : téléchargez tous les correctifs logiciels, quelle que soit la version de votre site.
  • -downloadsiteversion : téléchargez les mises à jour et les correctifs logiciels qui ont une version ultérieure à la version de votre site.

Exemple de connexion sans serveur proxy

ServiceConnectionTool.exe -connect -usagedatasrc D:\USB\ -updatepackdest D:\USB\UpdatePacks

Exemple de connexion avec un serveur proxy

ServiceConnectionTool.exe -connect -usagedatasrc D:\USB\Usagedata.cab -updatepackdest D:\USB\UpdatePacks -proxyserveruri itproxy.contoso.com -proxyusername jqpublic

Exemple de connexion pour télécharger uniquement les mises à jour applicables à la version du site

ServiceConnectionTool.exe -connect -downloadsiteversion -usagedatasrc D:\USB -updatepackdest D:\USB\UpdatePacks

-dest

Paramètre obligatoire avec le paramètre -export pour spécifier le chemin d’accès et le nom du fichier CSV à exporter. Pour plus d’informations, consultez -export.

-downloadall

Un paramètre facultatif avec le paramètre -connect pour tout télécharger, y compris les mises à jour et les correctifs logiciels, quelle que soit la version de votre site. Pour plus d’informations, consultez -connect.

-downloadhotfix

Paramètre facultatif avec le paramètre -connect pour télécharger uniquement tous les correctifs logiciels, quelle que soit la version de votre site. Pour plus d’informations, consultez -connect.

-downloadsiteversion

Paramètre facultatif avec le paramètre -connect pour télécharger uniquement les mises à jour et les correctifs logiciels qui ont une version ultérieure à la version de votre site. Pour plus d’informations, consultez -connect.

-exportation

Utilisez pendant la phase de préparation pour exporter les données d’utilisation vers un fichier CSV. Exécutez-le en tant qu’administrateur sur le point de connexion de service. Cette action vous permet de passer en revue le contenu des données d’utilisation avant de les charger sur Microsoft. Le paramètre -dest doit spécifier l’emplacement du fichier CSV.

Exemple d’exportation

-export -dest D:\USB\usagedata.csv

-importation

Utilisez pendant la phase d’importation sur le point de connexion de service pour importer les mises à jour sur le site. Le paramètre -updatepacksrc doit spécifier l’emplacement des mises à jour téléchargées.

Exemple d’importation

ServiceConnectionTool.exe -import -updatepacksrc D:\USB\UpdatePacks

-préparer

Utilisez pendant la phase de préparation sur le point de connexion de service pour exporter les données d’utilisation à partir du site. Il nécessite le paramètre -usagedatadest pour spécifier l’emplacement du fichier de données exporté.

Exemple de préparation

ServiceConnectionTool.exe -prepare -usagedatadest D:\USB\UsageData.cab

-proxyserveruri

Paramètre facultatif avec le paramètre -connect pour spécifier le nom de domaine complet de votre serveur proxy. Pour plus d’informations, consultez -connect.

-proxyusername

Paramètre facultatif avec le paramètre -connect pour spécifier le nom d’utilisateur à authentifier auprès de votre serveur proxy. Pour plus d’informations, consultez -connect.

-updatepackdest

Paramètre obligatoire avec le paramètre -connect pour spécifier un chemin d’accès pour les mises à jour téléchargées. Pour plus d’informations, consultez -connect.

-updatepacksrc

Paramètre obligatoire avec le paramètre -import pour spécifier le chemin des mises à jour téléchargées. Pour plus d’informations, consultez -import.

-usagedatadest

Paramètre obligatoire avec le paramètre -prepare pour spécifier un chemin d’accès et un nom de fichier du fichier de données exporté. Pour plus d’informations, consultez -prepare.

Étapes suivantes

Installer les mises à jour dans la console

Comment afficher les données de diagnostic et d’utilisation