Help Content Manager 的命令列引數

您可以指定如何部署和管理本機說明內容使用說明內容處理常式 (HlpCtntmgr.exe) 命令列引數。 您必須具有系統管理員使用權限才能執行這個命令列工具的指令碼,因此,您無法執行這些指令碼做為服務。 您可以使用此工具來執行下列工作:

  • 移除本機說明內容。

  • 移動本機說明內容存放區中。

  • 無聲地加入,更新,移除或移動本機說明內容。

語法:

HlpCtntmgr.exe /operation Value /catalogname CatalogName /locale Locale /sourceuri InstallationPoint

例如:

hlpctntmgr.exe /operation install /catalogname VisualStudio11 /locale en-us /sourceuri d:\productDocumentation\HelpContentSetup.msha

參數和引數

下表定義您可以針對說明內容處理常式的命令列工具所使用的參數和引數:

參數

是否為必要項?

引數

/作業

  • 安裝--從指定的安裝來源將書籤加入至本機內容存放區中。

    這個參數必須有/booklist 引數, /sourceURI 引數或兩者。 如果您沒有指定/sourceURI 引數, Visual Studio 預設 URI 做為安裝來源。 如果您沒有指定/booklist 引數,網址為/sourceUri 中的所有要安裝的書籍。

  • 解除安裝--移除您從本機內容存放區的指定部分。

    這個參數必須有/booklist 引數或 /sourceURI 引數。 如果您指定/sourceURI 引數,就會移除所有書籍,而/booklist 引數則會被忽略。

  • 移動--移至本機存放區您指定的路徑。 預設的本機存放區路徑以協助設定是設定於 %PROGRAMDATA%

    這個參數需要/locationPath 和/catalogName 引數。 錯誤訊息要記錄至事件記錄檔,如果您指定了無效的路徑,或如果磁碟機不包含足夠的空間保留內容。

  • 重新整理--更新已變更的主題連結,自動從安裝或最新更新。

    這個參數需要/sourceURI 引數。

/目錄名稱。

指定內容的目錄名稱。

/locale

指定可用來檢視和管理說明檢視器的目前執行個體的內容之產品的地區設定。 例如,您可以將英文版聯集狀態指定 EN-US 。

如果您不指定地區設定,使用作業系統的地區設定。 如果該地區設定無法判斷,使用 EN-US 。

如果您沒有指定有效的地區設定,就會將錯誤訊息記錄至事件記錄檔。

/e

如果目前的使用者具有管理認證,提高說明內容管理員的系統管理員權限。

/sourceURI

指定內容安裝的 URL (服務 API) 或內容安裝檔 (.msha) 路徑。 URL 可以指向清單 (最上層節點) 或取得產品書籍 (分葉層級節點) 會在 Visual Studio 2010 樣式端點。 您不需要包含正斜線 (/) 在 URL 結尾。 如果包含尾端斜線,它會適當地處理。

錯誤訊息會記錄在事件記錄檔,如果指定找不到,不是有效的,也無法存取的檔案,或是使用網際網路連線沒有可供或被中斷,當內容的處理時間。

/vendor

指定要移除的產品 (例如內容指定廠商 Microsoft)。 這個參數的預設引數為 Microsoft。

/productName

指定將移除其中書籍的產品名稱。 可在內容隨附的 helpcontentsetup.msha 或 books.html 檔中識別產品名稱。 您只能從單一產品移除書籍一次。 從多個產品移除書籍,您必須執行多個安裝。

/booklist

指定要處理的書籍名稱,以空格分隔。 值在安裝媒體上必須符合書籍名稱清單。

如果您未指定這個引數,指定產品的任何建議的書籍在/sourceURI 安裝,如果安裝在來源 Visual Studio 2012 格式。

如果書籍的名稱包含一或多個空格,請將其周圍加上雙引號 ("),讓清單適當分隔。

錯誤訊息就會記錄,如果您指定了無法使用或無法到達的 /sourceURI。

/skuId

指定產品的庫存品 (SKU) 從的安裝來源的,並篩選/SourceURI 參數識別的書籍。

/membership

  • 最小--安裝最小的根據以/skuId 參數,請指定的 SKU 的說明內容。 SKU 以及內容集合之間的對應在服務 API 中公開。

  • 建議—安裝一組使用/skuId 引數,您指定的 SKU 的建議的書籍。 安裝來源是服務 API 或 .MSHA。

  • 完整--安裝整組使用/skuId 引數,您指定的 SKU 的書籍。 安裝來源是服務 API 或 .MSHA。

/locationpath

針對本機說明內容指定預設資料夾。 您必須使用這個參數只安裝或捲動內容。 如果您指定這個參數,您必須同時指定/silent 參數。

/silent

安裝或移除說明內容,而不需要提示使用者或顯示任何 UI,包括在狀態告知區域中的圖示。 輸出記錄至 %Temp% 目錄的檔案。

重要事項重要事項
若要以無訊息模式安裝內容,您必須使用數位簽章的 .cab 檔案,不是 .mshc 檔。

/launchingApp

在說明檢視器中啟動,而不用父應用程式時,會定義應用程式和目錄的內容。 這個參數的引數為 CompanyName、 ProductName和 VersionNumber (例如, /launchingApp Microsoft,VisualStudio,11.0)。

/wait 秒

暫停安裝,解除安裝,並重新整理作業。 如果目錄作業已在進行中,處理序會等候給定秒數之後繼續。 使用 0 會無限期等待。

/?

列出參數及其描述的命令列工具說明內容處理常式。

Hh496811.collapse_all(zh-tw,VS.110).gif結束代碼

當您執行以說明內容處理常式的命令列工具在無訊息模式下時,會傳回下列結束代碼:

        Success = 0,

        FailureToElevate = 100
        InvalidCmdArgs = 101,
        FailOnFetchingOnlineContent = 110,
        FailOnFetchingContentFromDisk = 120,
        FailOnFetchingInstalledBooks = 130,
        NoBooksToUninstall = 200,
        NoBooksToInstall = 300,
        FailOnUninstall = 400,
        FailOnInstall = 500,
        FailOnMove = 600,
        FailOnUpdate = 700,
        FailOnRefresh = 800,
        Cancelled = 900,
        Others = 999,
        ContentManagementDisabled = 1200,
        OnlineHelpPreferenceDisabled = 1201
        UpdateAlreadyRunning = 1300 – (Signals that the update didn't run because another was in progress.)

請參閱

概念

說明檢視器 2.0 系統管理員指南

Help Content Manager 覆寫設定