說明檢視器 2.0 系統管理員指南
說明檢視器 2.0 可讓您處理網路環境的本機說明安裝具有或不具有網路存取權。 本機說明內容中設定每個機器基礎。 根據預設,使用者必須擁有系統管理員權限才能更新其本機說明安裝。
如果您的網路環境可讓用戶端存取這個網際網路,請說明檢視器 2.0 可讓您使用命令列部署指令碼從網際網路的本機說明內容。
如果您的網路環境中不允許用戶端存取這個網際網路,說明檢視器 2.0 可以從內部網路或網路共用的本機說明內容。 您也可以停用 Visual Studio IDE 說明選項,例如線上/離線說明,內容安裝在 IDE 中的第一個啟動,指定內部網路內容服務和管理的內容,請使用登錄機碼會覆寫。
基本語法如下:
<路徑> \ HlpCtntmgr.exe /operation <引數> /catalogname <名稱> /locale <地區設定> /sourceuri <.msha 路徑或 URL。>
如需 HlpCtntMgr.exe 命令列語法的詳細資訊,請參閱:Help Content Manager 的命令列引數。
如需建立內容的詳細資訊,建立內部 Web 服務端點和類似的活動類型,請參閱說明檢視器 2.0 SDK。
部署來自網際網路的本機說明內容。
您可以使用 MSDN 內容服務套件部署來自網際網路的本機說明內容至用戶端電腦。 使用下列語法:
\ <路徑> \ v2.0 \ HlpCtntmgr.exe /operation <名稱> /catalogname <目錄名稱> /locale <地區設定>
如需 HlpCtntMgr.exe 命令列語法的詳細資訊,請參閱:Help Content Manager 的命令列引數。
需求:
用戶端電腦必須能夠存取網際網路。
在安裝之後,使用者必須擁有系統管理員權限才能更新,加入或移除本機說明內容。
警告:
說明的預設來源還是會是線上。
提示
您可以修改 HKEY_LOCAL_MACHINE\Software\Microsoft\VSWinExpress\11.0\help\UseOnlineHelp 登錄機碼變更說明的預設來源。如需詳細資訊,請參閱Help Content Manager 覆寫設定。
將提示用戶端安裝在 Visual Studio 中第一個啟動的基本的說明內容。 您可以修改 HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\\VisualStudio\11.0\Help\DisableFirstRunHelpSelection 登錄機碼停用這項提示。
範例
下列範例 Visual Studio 2012 安裝英文內容至用戶端電腦。
安裝來自網際網路的英文內容。
選取 [啟動],然後選取 [執行]。
輸入下列:
C:\Program Files (x86)\Microsoft Help Viewer\v2.0\hlpctntmgr.exe /operation install /catalogname VisualStudio11 /locale en-us
請按 ENTER 鍵。
部署至用戶端電腦上的預先安裝本機說明內容。
您可以安裝一組來自線上內容到一部電腦上,然後複製到已安裝的一組內容到其他電腦。
需求:
您安裝的內容寫入至的電腦必須能夠存取網際網路。
在安裝之後,使用者必須擁有系統管理員權限才能更新,加入或移除本機說明內容。
提示
如果使用者沒有系統管理員權限,建議您停用在說明檢視器 2.0 的流程內容索引標籤。如需詳細資訊,請參閱Help Content Manager 覆寫設定。
警告:
如果使用者沒有系統管理員權限,建議您停用在說明檢視器 2.0 的流程內容索引標籤。 如需詳細資訊,請參閱Help Content Manager 覆寫設定。
說明的預設來源還是會是線上。
將提示用戶端安裝在 Visual Studio 中第一個啟動的基本的說明內容。 如需詳細資訊,請參閱Help Content Manager 覆寫設定。
建立內容集合
在建立執行個體的內容之前,您必須先解除安裝在目標電腦上的所有本機 Visual Studio 內容。
解除安裝本機說明
在說明檢視器中,選取管理內容 索引標籤。
在 [可用的文件] 下,巡覽至 Visual Studio 文件集。
選取在每個子項目旁邊的[移除] 。
選取 [開始] 來移除
瀏覽至 n: \ProgramData\Microsoft\HelpLibrary2\Catalogs\VisualStudio11 並驗證資料夾只包含檔案 catalogType.xml。
一旦移除了所有先前安裝的本機 Visual Studio 說明內容,您可以下載此基底內容集合。
若要下載內容
在說明檢視器中,選取管理內容 索引標籤。
在 [可用的文件] 下,巡覽至您要下載然後選取 [新增] 的文件集。
選取 [開始]。
接著,您需要包裝內容,以便在用戶端電腦上部署。
若要封裝內容
建立資料夾的內容複製到稍後的部署。
例如:c:\VS11Help (英文)。
開啟具有系統管理員使用權限的 cmd.exe。
巡覽至您在步驟 1. 步驟所建立的資料夾。
輸入下列:
Xcopy %SYSTEMDRIVE%\ProgramData\Microsoft\HelpLibrary2 <foldername>\ /y /e /k /o
例如:Xcopy %SYSTEMDRIVE%\ProgramData\Microsoft\HelpLibrary2 c:\VS11Help\ /y /e /k /o
部署內容
若要部署內容
建立網路共用資料夾並複製說明內容至該位置。
例如,複製在 c:\VS11Help to \\myserver\VS11Help 的內容。
建立包含說明內容的部署指令碼的 .bat 檔。
例如:
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%) REM - get processor type and create/run registry update file IF "%PROCESSOR_ARCHITECTURE%"=="AMD64" GOTO AMD64 @echo Architecture type is x86 ECHO Windows Registry Editor Version 5.00 > x86.reg ECHO [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Help\v2.0\Catalogs] >> x86.reg ECHO "ContentStore"="%SYSTEMDRIVE%\\ProgramData\\Microsoft\\HelpLibrary2\\Catalogs\\" >> x86.reg ECHO [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Help\v2.0\Catalogs\VisualStudio11] >> x86.reg ECHO "LocationPath"="%SYSTEMDRIVE%\\ProgramData\\Microsoft\\HelpLibrary2\\Catalogs\\VisualStudio11\\" >> x86.reg ECHO "FirstTimeRun"="False" >> x86.reg ECHO [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Help\v2.0\Catalogs\VisualStudio11\en-US] >> x86.reg ECHO "ContentStore"="%SYSTEMDRIVE%\\ProgramData\\Microsoft\\HelpLibrary2\\Catalogs\\VisualStudio11\\" >> x86.reg ECHO "catalogName"="Visual Studio version Help Documentation" >> x86.reg ECHO [HKEY_LOCAL_MACHINE\Software\Microsoft\VSWinExpress\11.0\help] >> x86.reg ECHO "UseOnlineHelp"=dword:00000000 >> x86.reg regedit.exe /s x86.reg if ERRORLEVEL 1 ECHO *** ERROR inserting the x86 reg (%ERRORLEVEL%) GOTO CONTINUE :AMD64 @echo Architecture type is AMD64 ECHO Windows Registry Editor Version 5.00 > x64.reg ECHO [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Help\v2.0\Catalogs] >> x64.reg ECHO "ContentStore"="%SYSTEMDRIVE%\\ProgramData\\Microsoft\\HelpLibrary2\\Catalogs\\" >> x64.reg ECHO [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Help\v2.0\Catalogs\VisualStudio11] >> x64.reg ECHO "LocationPath"="%SYSTEMDRIVE%\\ProgramData\\Microsoft\\HelpLibrary2\\Catalogs\\VisualStudio11\\" >> x64.reg ECHO "FirstTimeRun"="False" >> x64.reg ECHO [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Help\v2.0\Catalogs\VisualStudio11\en-US] >> x64.reg ECHO "ContentStore"="%SYSTEMDRIVE%\\ProgramData\\Microsoft\\HelpLibrary2\\Catalogs\\VisualStudio11\\en-US\\" >> x64.reg ECHO "catalogName"="Visual Studio version Help Documentation" >> x64.reg ECHO [HKEY_LOCAL_MACHINE\Software\Wow6432Node\Microsoft\VSWinExpress\11.0\help] >> x64.reg ECHO "UseOnlineHelp"=dword:00000000 >> x64.reg regedit.exe /s x64.reg if ERRORLEVEL 1 ECHO *** ERROR inserting the x64 reg (%ERRORLEVEL%) :CONTINUE
在安裝說明內容的本機電腦執行該 bat 檔。