部署與管理適用於網路環境的本機說明安裝

2025-06-25

您可以使用Microsoft說明查看器，在本機計算機上安裝、檢視及管理Microsoft產品和技術的本機檔安裝。這些技術包括 Visual Studio、.NET、語言參考、SQL Server 和 Windows 開發。

在本文中，您將瞭解如何使用說明查看器，針對具有或沒有因特網存取的網路環境部署和管理本機說明安裝。本機說明內容是以每台設備為基礎設定。根據預設，用戶必須具有系統管理員許可權，才能更新其本機說明安裝。

如果您的網路環境允許用戶端存取因特網，您可以使用 說明內容管理員 可執行檔從因特網部署本機說明內容。如需 HlpCtntMgr.exe命令列語法 的詳細資訊，請參閱說明內容管理員的命令列引數。

如需建立內容、建立內部網路服務端點和類似活動類型的相關信息，請參閱說明查看器 SDK。

如果您在網路環境中沒有網際網路存取權，說明查看器可以從內部網路或網路共用部署本地說明內容。您也可以使用登錄機碼覆寫來停用 Visual Studio IDE 說明選項，例如：

在線與離線說明
IDE 第一次啟動時安裝內容
指定內部網路內容服務
管理內容

從網際網路部署在地說明內容

您可以使用 說明內容管理員 （HlpCtntMgr.exe）將本機說明內容從因特網部署到用戶端電腦。使用下列語法：

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

如需 HlpCtntMgr.exe命令列語法 的詳細資訊，請參閱說明內容管理員的命令列參數。

要求：

用戶端電腦必須能夠存取因特網。
使用者必須具備系統管理員許可權，才能在安裝本機說明內容之後進行更新、新增或移除。

警示：

說明的預設來源仍將是網路上的資源。

範例

下列範例會將Visual Studio的英文內容安裝到客戶端電腦。

從因特網安裝英文內容

選擇 [開始] ，然後選擇 [ 執行]。
輸入下列命令：

C:\Program Files (x86)\Microsoft Help Viewer\v2.3\hlpctntmgr.exe /operation install /catalogname VisualStudio15 /locale en-us
按 Enter 鍵。

在用戶端電腦上部署預安裝的本機說明內容

您可以將一組內容從在線安裝到一部計算機，然後將該安裝的內容集複製到其他計算機。

要求：

您安裝一組內容的電腦必須能夠存取因特網。
使用者必須擁有系統管理員許可權，才能在安裝本機說明內容之後更新、新增或移除。

小提示

如果使用者沒有系統管理員許可權，建議您停用 [說明查看器] 中的 [ 管理內容 ] 索引卷標。如需詳細資訊，請參閱覆蓋說明檢視器的預設值。

警示：

說明的預設來源仍會是網路上的資源。

建立內容集

您必須先卸載目標計算機上的所有本機 Visual Studio 內容，才能建立基底內容集。

卸載本機說明

在 [說明查看器] 中，選擇 [ 管理內容] 索引標籤 。
流覽至 Visual Studio 檔集。
選擇每個子專案旁的 [移除]。
選擇 [更新 ] 以卸載。
流覽至 %ProgramData%\Microsoft\HelpLibrary2\Catalogs\VisualStudio15 ，並確認檔夾只包含 檔案catalogType.xml。

拿掉所有先前安裝的本機 Visual Studio 說明內容之後，您就可以下載基底內容集。

下載內容

在 [說明查看器] 中，選擇 [ 管理內容] 索引標籤 。
在 [建議的檔 ] 或 [ 可用的檔] 底覽至您要下載的檔集，然後選擇 [ 新增]。
選擇 [更新]。

接下來，您必須封裝內容，以便將其部署至用戶端電腦。

封裝內容

建立資料夾以將內容複製到，以供稍後部署使用。例如： C：\VSHelp。
使用系統管理員許可權開啟 cmd.exe 。
流覽至您在步驟 1 中建立的資料夾。
輸入下列命令：

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

例如：Xcopy %ProgramData%\Microsoft\HelpLibrary2 c:\VSHelp\ /y /e /k /o

部署內容

建立網路共用，並將說明內容複製到該位置。

例如，將 C：\VSHelp 中的內容複製到 \\myserver\VSHelp。

建立 .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%)

在您要安裝說明內容的本機計算機上執行 .bat 檔案。