Distribuire e gestire le installazioni della Guida locale per gli ambienti di rete
È possibile usare Microsoft Help Viewer per installare, visualizzare e gestire le installazioni della documentazione locale per prodotti e tecnologie Microsoft nei computer locali. Queste tecnologie includono Visual Studio, .NET, informazioni di riferimento sul linguaggio, SQL Server e sviluppo di Windows.
Questo articolo illustra come usare Help Viewer per distribuire e gestire le installazioni della Guida locali per gli ambienti di rete con o senza accesso a Internet. Il contenuto della Guida locale viene configurato per ogni singolo computer. Per impostazione predefinita, gli utenti devono disporre dei diritti di amministratore per aggiornare l'installazione della Guida locale.
Se l'ambiente di rete consente ai client di accedere a Internet, è possibile usare l'eseguibile di Gestione contenuto della Guida per distribuire contenuto della Guida locale da Internet. Per altre informazioni sulla sintassi della riga di comando di HlpCtntMgr.exe, vedere Argomenti della riga di comando per Gestione contenuto della Guida.
Per informazioni sulla creazione del contenuto, sulla creazione di un endpoint servizio Intranet e tipi di attività simili, vedere Help Viewer SDK.
Se nell'ambiente di rete non si ha l'accesso a Internet, Help Viewer può distribuire il contenuto della Guida locale dalla Intranet o da una condivisione di rete. È anche possibile disabilitare le opzioni della Guida dell'IDE di Visual Studio tramite override di chiavi del Registro di sistema per le funzionalità, ad esempio:
Guida online o offline
installazione del contenuto al primo avvio dell'IDE
Specifica di un servizio contenuto nella rete Intranet
Gestione del contenuto
Distribuire il contenuto della Guida locale da Internet
È possibile usare Gestione contenuto della Guida (HlpCtntMgr.exe) per distribuire il contenuto della Guida locale da Internet ai computer client. Usare la sintassi seguente:
\\%ProgramFiles(x86)%\Microsoft Help Viewer\v2.3\HlpCtntmgr.exe /operation \<*name*> /catalogname \<*catalog name*> /locale \<*locale*>
Per altre informazioni sulla sintassi della riga di comando di HlpCtntMgr.exe, vedere Argomenti della riga di comando per Gestione contenuto della Guida.
Requisiti:
I computer client devono avere accesso a Internet.
Gli utenti devono disporre dei diritti di amministratore per aggiornare, aggiungere o rimuovere il contenuto della Guida locale dopo l'installazione.
Avvertenze:
- L'origine predefinita per la Guida sarà ancora online.
Esempio
L'esempio seguente installa il contenuto in lingua inglese per Visual Studio in un computer client.
Per installare il contenuto in lingua inglese da Internet
Scegliere Start e quindi Esegui.
Digitare il comando seguente:
C:\Program Files (x86)\Microsoft Help Viewer\v2.3\hlpctntmgr.exe /operation install /catalogname VisualStudio15 /locale en-usPremere INVIO.
Distribuire il contenuto della Guida locale preinstallato nei computer client
È possibile installare un set di contenuti online in un computer e quindi copiarlo in altri computer.
Requisiti:
Il computer in cui si installa il set del contenuto deve avere accesso a Internet.
Gli utenti devono disporre dei diritti di amministratore per aggiornare, aggiungere o rimuovere il contenuto della Guida locale dopo l'installazione.
Suggerimento
Se gli utenti non dispongono dei diritti di amministratore, si consiglia di disabilitare la scheda Gestisci contenuto nel visualizzatore della Guida. Per altre informazioni, vedere Eseguire l'override delle impostazioni predefinite del Visualizzatore della Guida.
Avvertenze:
- L'origine predefinita per la Guida sarà ancora online.
Creare il set di contenuti
Prima di poter creare il set di contenuti di base, è necessario disinstallare tutto il contenuto di Visual Studio locali dal computer di destinazione.
Per disinstallare la Guida locale
In Help Viewer scegliere la scheda Gestisci contenuto.
Passare al set di documenti di Visual Studio.
Scegliere Rimuovi accanto a ogni elemento secondario.
Scegliere Aggiorna per disinstallare.
Passare a %ProgramData%\Microsoft\HelpLibrary2\Catalogs\VisualStudio15 e verificare che la cartella contenga solo il file catalogType.xml.
Dopo aver rimosso tutto il contenuto della Guida locale di Visual Studio installato in precedenza, si è pronti per scaricare il set di contenuti di base.
Per scaricare il contenuto
In Help Viewer scegliere la scheda Gestisci contenuto.
In Documentazione consigliata o Documentazione disponibile passare ai set di documentazione che si vuole scaricare e quindi scegliere Aggiungi.
Scegliere Update (Aggiorna).
Ora è necessario creare un pacchetto del contenuto per poterlo distribuire ai computer client.
Per creare un pacchetto del contenuto
Creare una cartella in cui copiare il contenuto da distribuire. Ad esempio: C:\VSHelp.
Aprire cmd.exe con le autorizzazioni di amministratore.
Passare alla cartella creata nel passaggio 1.
Digitare il comando seguente:
Xcopy %ProgramData%\Microsoft\HelpLibrary2 \<*foldername*>\ /y /e /k /oAd esempio:
Xcopy %ProgramData%\Microsoft\HelpLibrary2 c:\VSHelp\ /y /e /k /o
Distribuire il contenuto
Creare una condivisione di rete e copiare il contenuto della Guida in tale posizione.
Ad esempio, copiare il contenuto in C:\VSHelp in \\myserver\VSHelp.
Creare un file con estensione bat che dovrà contenere lo script di distribuzione per il contenuto della Guida. Poiché potrebbe verificarsi un blocco di lettura nel client per qualsiasi file da eliminare durante il push, è necessario arrestare il client prima del push degli aggiornamenti. Ad esempio:
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%)Eseguire il file con estensione bat nei computer locali in cui si vuole installare il contenuto della Guida.