Déployer et gérer des installations d’aide locale pour les environnements réseau

2025-06-27

Vous pouvez utiliser Microsoft Help Viewer pour installer, afficher et gérer les installations de documentation locale pour les produits et technologies Microsoft sur les ordinateurs locaux. Ces technologies incluent Visual Studio, .NET, référence de langage, SQL Server et développement Windows.

Dans cet article, vous allez apprendre à utiliser la Visionneuse d’aide pour déployer et gérer les installations d’aide locales pour les environnements réseau avec ou sans accès à Internet. Le contenu d’aide local est configuré par ordinateur. Par défaut, les utilisateurs doivent disposer de droits d’administrateur pour mettre à jour leur installation d’aide locale.

Si votre environnement réseau permet aux clients d’accéder à Internet, vous pouvez utiliser l’exécutable Help Content Manager pour déployer le contenu d’aide local à partir d’Internet. Pour plus d’informations sur HlpCtntMgr.exe syntaxe de ligne de commande, consultez les arguments de ligne de commande pour le Gestionnaire de contenu d’aide.

Pour plus d’informations sur la création de contenu, la création d’un point de terminaison de service intranet et des types d’activités similaires, consultez le Kit de développement logiciel (SDK) Help Viewer.

Si vous n’avez pas d’accès Internet dans votre environnement réseau, l’Observateur d’aide peut déployer du contenu d’aide local à partir de l’intranet ou d’un partage réseau. Vous pouvez également désactiver des options de l’aide de l’IDE de Visual Studio en utilisant des substitutions de clé de Registre pour les fonctionnalités suivantes :

aide en ligne et hors connexion
installation de contenu lors du premier lancement de l’IDE
spécification d’un service de contenu intranet
gestion du contenu

Déployer du contenu d’aide local à partir d’Internet

Vous pouvez utiliser Help Content Manager (HlpCtntMgr.exe) pour déployer du contenu d’aide local à partir d’Internet sur des ordinateurs clients. Utilisez la syntaxe suivante :

\\%ProgramFiles(x86)%\Microsoft Help Viewer\v2.3\HlpCtntmgr.exe /operation \<*name*> /catalogname \<*catalog name*> /locale \<*locale*>

Pour plus d’informations sur HlpCtntMgr.exe syntaxe de ligne de commande, consultez les arguments de ligne de commande pour le Gestionnaire de contenu d’aide.

Exigences:

Les ordinateurs clients doivent avoir accès à Internet.
Les utilisateurs doivent disposer de droits d’administrateur pour mettre à jour, ajouter ou supprimer le contenu d’aide local une fois qu’il a été installé.

Avertissements :

La source par défaut de l’aide sera toujours en ligne.

Exemple :

L’exemple suivant installe du contenu anglais pour Visual Studio sur un ordinateur client.

Pour installer le contenu anglais à partir d’Internet

Choisissez Démarrer , puis Exécutez.
Tapez la commande suivante :

C:\Program Files (x86)\Microsoft Help Viewer\v2.3\hlpctntmgr.exe /operation install /catalogname VisualStudio15 /locale en-us
Appuyez sur Entrée.

Déployer le contenu d’aide local préinstallé sur les ordinateurs clients

Vous pouvez installer un ensemble de contenu en ligne vers un ordinateur, puis copier cet ensemble de contenu installé sur d’autres ordinateurs.

Exigences:

L’ordinateur sur lequel vous installez le jeu de contenu doit avoir accès à Internet.
Les utilisateurs doivent disposer de droits d’administrateur pour mettre à jour, ajouter ou supprimer le contenu d’aide local une fois qu’il a été installé.

Conseil / Astuce

Si les utilisateurs n’ont pas de droits d’administrateur, il est recommandé de désactiver l’onglet Gérer le contenu dans la Visionneuse d’aide. Pour plus d’informations, consultez Remplacer les valeurs par défaut de la Visionneuse d’aide.

Avertissements :

La source par défaut de l’aide sera toujours en ligne.

Créer l'ensemble de contenu

Avant de pouvoir créer l’ensemble de contenu de base, vous devez d’abord désinstaller tout le contenu local de Visual Studio sur l’ordinateur cible.

Pour désinstaller l’aide locale

Dans la Visionneuse d’aide, choisissez l’onglet Gérer le contenu .
Accédez à l’ensemble de documents Visual Studio.
Choisissez Supprimer en regard de chaque sous-élément.
Choisissez Mettre à jour pour désinstaller l’aide locale.
Accédez à %ProgramData%\Microsoft\HelpLibrary2\Catalogs\VisualStudio15 et vérifiez que le dossier contient uniquement le fichier catalogType.xml.

Une fois que vous avez supprimé tout le contenu local installé précédemment à l’aide de Visual Studio, vous êtes prêt à télécharger l’ensemble de contenu de base.

Pour télécharger le contenu

Dans la Visionneuse d’aide, choisissez l’onglet Gérer le contenu .
Sous Documentation recommandée ou Documentation disponible, accédez aux ensembles de documentation que vous souhaitez télécharger, puis choisissez Ajouter.
Choisissez Mettre à jour.

Ensuite, vous devez empaqueter le contenu afin qu’il puisse être déployé sur les ordinateurs clients.

Pour empaqueter le contenu

Créez un dossier dans lequel copier le contenu pour un déploiement ultérieur. Par exemple : C :\VSHelp.
Ouvrez cmd.exe avec des autorisations d’administrateur.
Accédez au dossier que vous avez créé à l’étape 1.
Tapez la commande suivante :

Xcopy %ProgramData%\Microsoft\HelpLibrary2 \<*foldername*>\ /y /e /k /o

Par exemple : Xcopy %ProgramData%\Microsoft\HelpLibrary2 c:\VSHelp\ /y /e /k /o

Déployer le contenu

Créez un partage réseau et copiez le contenu d’aide vers cet emplacement.

Par exemple, copiez le contenu en C :\VSHelp vers \\myserver\VSHelp.
Créez un fichier .bat pour contenir le script de déploiement pour le contenu d’aide. Étant donné que le client peut avoir un verrou de lecture sur l’un des fichiers supprimés dans le cadre de l’envoi (push), vous devez arrêter le client avant d’envoyer des mises à jour. Par exemple:
```
REM - copy pre-ripped content to ProgramData
Xcopy %~dp0HelpLibrary2 %SYSTEMDRIVE%\ProgramData\Microsoft\HelpLibrary2\ /y /e /k /o
if ERRORLEVEL 1 ECHO *** ERROR COPYING Help Library files to ProgramData (%ERRORLEVEL%)
```
Exécutez le fichier .bat sur les machines locales sur lesquelles vous souhaitez installer le contenu de l’aide.