Déployer et gérer des installations d’Aide locales pour les environnements réseau
Vous pouvez utiliser Microsoft Help Viewer pour installer, afficher et gérer les installations de documentation locale pour les produits et technologies Microsoft sur des ordinateurs locaux. Ces technologies incluent Visual Studio, .NET, les informations de référence du langage, SQL Server et Développement Windows.
Dans cet article, vous allez apprendre à utiliser Help Viewer 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 locale est configuré sur la base de l’ordinateur. Par défaut, les utilisateurs doivent disposer des 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 déployer le contenu de l’aide locale depuis Internet à l’aide de l’exécutable Help Content Manager. Pour plus d’informations sur la syntaxe de ligne de commande de HlpCtntMgr.exe, consultez les Arguments de ligne de commande pour Help Content Manager.
Pour obtenir des informations sur la création de contenu, la création d’un point de terminaison de service intranet et les types d’activités similaires, consultez Help Viewer SDK.
Si votre environnement réseau n’offre pas de connectivité Internet, Help Viewer peut déployer le contenu de l’aide locale à 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 aide hors connexion
Installation du contenu au premier démarrage de l’IDE
Spécification d’un service de contenu intranet
Gestion du contenu
Déployer le contenu de l’aide locale à partir d’Internet
Vous pouvez utiliser Help Content Manager (HlpCtntMgr.exe) pour déployer le contenu de l’aide locale depuis 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 la syntaxe de ligne de commande de HlpCtntMgr.exe, consultez les Arguments de ligne de commande pour Help Content Manager.
Conditions requises :
Les ordinateurs clients doivent avoir accès à Internet.
Les utilisateurs doivent disposer des droits d’administrateur pour mettre à jour, ajouter ou supprimer le contenu d’aide locale une fois celui-ci installé.
Avertissements :
- La source par défaut de l’aide sera toujours en ligne.
Exemple
L’exemple suivant installe le contenu en anglais pour Visual Studio sur un ordinateur client.
Pour installer le contenu en anglais à partir d’Internet
Choisissez Démarrer, puis Exécuter.
Tapez la commande suivante :
C:\Program Files (x86)\Microsoft Help Viewer\v2.3\hlpctntmgr.exe /operation install /catalogname VisualStudio15 /locale en-usAppuyez sur Entrée.
Déployer le contenu de l’aide locale préinstallé sur les ordinateurs clients
Vous pouvez installer un ensemble de contenu à partir d’une source en ligne sur un ordinateur, puis copier cet ensemble de contenu installé sur d’autres ordinateurs.
Conditions requises :
L’ordinateur sur lequel vous installez l’ensemble du contenu doit avoir accès à Internet.
Les utilisateurs doivent disposer des droits d’administrateur pour mettre à jour, ajouter ou supprimer le contenu d’aide locale une fois celui-ci installé.
Conseil
Si les utilisateurs ne disposent pas de droits d’administrateur, nous vous recommandons de désactiver l’onglet Gérer le contenu dans Help Viewer. Pour plus d’informations, consultez Remplacer les paramètres Help Viewer par défaut .
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 Help Viewer, choisissez l’onglet Gérer le contenu.
Accédez à l’ensemble de documents Visual Studio.
Choisissez Supprimer à côté 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 Help Viewer, choisissez l’onglet Gérer le contenu.
Sous Documentation recommandée ou Documentation disponible, accédez aux ensembles de documents à télécharger, puis choisissez Ajouter.
Choisissez Mettre à jour.
Vous devez ensuite créer un package du contenu pour qu’il puisse être déployé sur les ordinateurs clients.
Pour créer un package du contenu
Créez un répertoire pour copier le contenu en vue d’un déploiement ultérieur. Par exemple : C:\VSHelp.
Ouvrez cmd.exe avec des autorisations d’administrateur.
Accédez au dossier créé à l’étape 1.
Tapez la commande suivante :
Xcopy %ProgramData%\Microsoft\HelpLibrary2 \<*foldername*>\ /y /e /k /oPar 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 à cet emplacement.
Par exemple, copiez le contenu de C:\VSHelp dans \\myserver\VSHelp.
Créez un fichier .bat qui va contenir le script de déploiement du contenu d’aide. Comme le client est susceptible de ne pas pouvoir lire les fichiers en cours de suppression dans le cadre de l’émission, vous devez désactiver le client avant d’émettre 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 où le contenu d’aide doit être installé.