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
參數和引數
下表定義您可以針對說明內容處理常式的命令列工具所使用的參數和引數:
參數 |
是否為必要項? |
引數 |
---|---|---|
/作業 |
是 |
|
/目錄名稱。 |
是 |
指定內容的目錄名稱。 |
/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 |
否 |
|
/locationpath |
否 |
針對本機說明內容指定預設資料夾。 您必須使用這個參數只安裝或捲動內容。 如果您指定這個參數,您必須同時指定/silent 參數。 |
/silent |
否 |
安裝或移除說明內容,而不需要提示使用者或顯示任何 UI,包括在狀態告知區域中的圖示。 輸出記錄至 %Temp% 目錄的檔案。
重要事項
若要以無訊息模式安裝內容,您必須使用數位簽章的 .cab 檔案,不是 .mshc 檔。
|
/launchingApp |
否 |
在說明檢視器中啟動,而不用父應用程式時,會定義應用程式和目錄的內容。 這個參數的引數為 CompanyName、 ProductName和 VersionNumber (例如, /launchingApp Microsoft,VisualStudio,11.0)。 |
/wait 秒 |
否 |
暫停安裝,解除安裝,並重新整理作業。 如果目錄作業已在進行中,處理序會等候給定秒數之後繼續。 使用 0 會無限期等待。 |
/? |
否 |
列出參數及其描述的命令列工具說明內容處理常式。 |
結束代碼
當您執行以說明內容處理常式的命令列工具在無訊息模式下時,會傳回下列結束代碼:
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.)