도움말 콘텐츠 관리자에 대한 명령줄 인수Command-Line Arguments for the Help Content Manager

도움말 콘텐츠 관리자(HlpCtntMgr.exe)의 명령줄 인수를 사용하여 로컬 도움말 콘텐츠를 배포하고 관리하는 방법을 지정할 수 있습니다.You can specify how to deploy and manage local Help content by using command-line arguments for Help Content Manager (HlpCtntMgr.exe). 관리자 권한으로 이 명령줄 도구에 대한 스크립트를 실행해야 하며 이러한 스크립트를 서비스로 실행할 수는 없습니다.You must run scripts for this command-line tool with administrator permissions, and you can't run these scripts as a service. 이 도구를 사용하여 다음과 같은 작업을 수행할 수 있습니다.You can perform the following tasks by using this tool:

  • 디스크 또는 클라우드에서 로컬 도움말 콘텐츠를 추가하거나 업데이트합니다.Add or update local Help content from a disk or the cloud.

  • 로컬 도움말 콘텐츠를 제거합니다.Remove local Help content.

  • 로컬 도움말 콘텐츠 저장소를 이동합니다.Move the local Help content store.

  • 로컬 도움말 콘텐츠를 자동으로 추가, 업데이트, 제거 또는 이동합니다.Add, update, remove, or move local Help content silently.

구문:Syntax:

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

예:For example:

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

스위치 및 인수Switches and Arguments

다음 표에는 도움말 콘텐츠 관리자용 명령줄 도구에 사용할 수 있는 스위치와 인수가 정의되어 있습니다.The following table defines the switches and arguments that you can use for the command-line tool for Help Content Manager:

전환Switch 필수 여부Required? 인수Arguments
/operation/operation Yes - Install--지정된 설치 소스의 책을 로컬 콘텐츠 저장소에 추가합니다.- Install--Adds books from the specified installation source to the local content store.
이 스위치에는 /booklist 인수 또는 /sourceURI 인수가 필요하거나 두 인수가 모두 필요합니다.This switch requires the /booklist argument, the /sourceURI argument, or both. /sourceURI 인수를 지정하지 않는 경우 기본 Visual Studio URI가 설치 소스로 사용됩니다.If you don't specify the /sourceURI argument, the default Visual Studio URI is used as the installation source. /booklist 인수를 지정하지 않는 경우 /sourceUri의 모든 책이 설치됩니다.If you don't specify the /booklist argument, all books on the /sourceUri are installed.
- Uninstall--지정하는 책을 로컬 콘텐츠 저장소에서 제거합니다.- Uninstall--Removes the books that you specify from the local content store.
이 스위치에는 /booklist 인수 또는 /sourceURI 인수가 필요합니다.This switch requires the /booklist argument or the /sourceURI argument. /sourceURI 인수를 지정하는 경우 모든 책이 제거되고 /booklist 인수가 무시됩니다.If you specify the /sourceURI argument, all books are removed, and the /booklist argument is ignored.
- Move--지정하는 경로로 로컬 저장소를 이동합니다.- Move--Moves the local store to the path that you specify. 기본 로컬 저장소 경로는 %ProgramData% 아래에 디렉터리로 설정됩니다.The default local store path is set as a directory under %ProgramData%
이 스위치에는 /locationPath 및 /catalogName 인수가 필요합니다.This switch requires the /locationPath and /catalogName arguments. 잘못된 경로를 지정하거나 드라이브에 콘텐츠를 저장할 충분한 여유 공간이 없는 경우 오류 메시지가 이벤트 로그에 기록됩니다.Error messages will be logged in the event log if you specify a path that isn't valid or if the drive doesn't contain enough free space to hold the content.
- Refresh--설치된 이후 변경되었거나 최근에 업데이트된 항목을 업데이트합니다.- Refresh--Updates topics that have changed since they were installed or most recently updated.
이 스위치에는 /sourceURI 인수가 필요합니다.This switch requires the /sourceURI argument.
/catalogName/catalogName Yes 콘텐츠 카탈로그의 이름을 지정합니다.Specifies the name of the content catalog.
/locale/locale 아니요No 도움말 뷰어의 현재 인스턴스에 대한 콘텐츠를 보고 관리하는 데 사용되는 제품 로캘을 지정합니다.Specifies the product locale that's used to view and manage content for the current instance of the Help viewer. 예를 들어 영어-미국의 경우 EN-US를 지정합니다.For example, you specify EN-US for English-United States.

로캘을 지정하지 않는 경우 운영 체제의 로캘이 사용됩니다.If you don't specify a locale, the locale of the operating system is used. 로캘을 확인할 수 없는 경우에는 EN-US가 사용됩니다.If that locale can't be determined, EN-US is used.

잘못된 로캘을 지정하면 오류 메시지가 이벤트 로그에 기록됩니다.If you specify a locale that isn't valid, an error message is logged in the event log.
/e/e 아니요No 현재 사용자에게 관리자 자격 증명이 있는 경우 도움말 콘텐츠 관리자를 관리자 권한으로 승격합니다.Elevates the Help Content Manager to Administrative priviledges if the current user has administrative credentials.
/sourceURI/sourceURI 아니요No 콘텐츠가 설치되는 URL(서비스 API) 또는 콘텐츠 설치 파일(.msha)의 경로를 지정합니다.Specifies the URL from which content is installed (Service API) or the path to the content installation file (.msha). URL은 Visual Studio 2010 스타일 끝점에서 제품 그룹(최상위 노드) 또는 제품 책(리프 수준 노드)을 가리킬 수 있습니다.The URL can point to the Product Group (top-level node) or to the Product Books (leaf-level node) in a Visual Studio 2010 style endpoint. URL 끝에 슬래시(/)를 포함할 필요가 없습니다.You don't need to include a slash (/) at the end of the URL. 끝에 슬래시를 포함하는 경우 적절하게 처리됩니다.If you do include a trailing slash, it will be handled appropriately.

찾을 수 없거나, 잘못되거나, 액세스할 수 없는 파일을 지정하는 경우나 콘텐츠를 관리하는 동안 인터넷 연결을 사용할 수 없거나 중단된 경우 오류 메시지가 이벤트 로그에 기록됩니다.An error message is logged in the event log if you specify a file that isn't found, isn't valid, or isn't accessible or if a connection to the Internet isn't available or is interrupted while content is being managed.
/vendor/vendor 아니요No 제거될 제품 콘텐츠의 공급업체를 지정합니다(예: Microsoft).Specifies the vendor for the product content that will be removed (for example, Microsoft). 이 스위치의 기본 인수는 Microsoft입니다.The default argument for this switch is Microsoft.
/productName/productName 아니요No 제거될 책의 제품 이름을 지정합니다.Specifies the product name for the books that will be removed. 제품 이름은 콘텐츠와 함께 제공되는 helpcontentsetup.msha 또는 books.html 파일에서 식별됩니다.The product name is identified in the helpcontentsetup.msha or books.html files that shipped with the content. 한 번에 한 제품에서만 책을 제거할 수 있습니다.You can remove books from only one product at a time. 여러 제품에서 책을 제거하려면 여러 설치를 수행해야 합니다.To remove books from multiple products, you must perform multiple installations.
/booklist/booklist 아니요No 관리할 책의 이름을 공백으로 구분하여 지정합니다.Specifies the names of the books to be managed, separated by spaces. 값은 설치 미디어에 표시된 책 이름과 일치해야 합니다.Values must match the book names as listed on the installation media.

이 인수를 지정하지 않는 경우 /sourceURI에 지정된 제품의 모든 권장되는 책이 설치됩니다.If you don't specify this argument, all recommended books for the specified product in the /sourceURI are installed.

책의 이름에 공백이 하나 이상 포함되어 있으면 목록이 적절하게 구분되도록 큰따옴표(")로 묶습니다.If the name of a book contains one or more spaces, surround it with double quotes (") so that the list is delimited appropriately.

잘못되거나 연결될 수 없는 /sourceURI를 지정하는 경우 오류 메시지가 기록됩니다.Error messages will be logged if you specify a /sourceURI that isn't valid or isn't reachable.
/skuId/skuId 아니요No 설치 원본에서 제품의 SKU(Stock Keeping Unit)를 지정하고 /SourceURI 스위치로 식별되는 책을 필터링합니다.Specifies the stock keeping unit (SKU) of the product from the installation source, and filters books that the /SourceURI switch identifies.
/membership/membership 아니요No - Minimum--/skuId 스위치를 사용하여 지정한 SKU를 기반으로 도움말 콘텐츠의 최소 집합을 설치합니다.- Minimum-- Installs a minimum set of Help content based on the SKU that you specify by using the /skuId switch. SKU와 콘텐츠 집합 간의 매핑은 서비스 API에서 노출됩니다.The mapping between the SKU and the content set is exposed in the Service API.
- Recommended--/skuId 인수를 사용하여 지정한 SKU에 대한 권장되는 책의 집합을 설치합니다.- Recommended—Installs a set of recommended books for the SKU that you specify by using the /skuId argument. 설치 원본은 서비스 API 또는 .MSHA입니다.The Installation source is the service API or .MSHA.
- Full--/skuId 인수를 사용하여 지정한 SKU에 대한 책의 전체 집합을 설치합니다.- Full-- Installs the entire set of books for the SKU that you specify by using the /skuId argument. 설치 원본은 서비스 API 또는 .MSHA입니다.The Installation source is the service API or .MSHA.
/locationpath/locationpath 아니요No 로컬 도움말 콘텐츠의 기본 폴더를 지정합니다.Specifies the default folder for local Help content. 이 스위치는 콘텐츠를 설치하거나 이동하는 데만 사용해야 합니다.You must use this switch only to install or move content. 이 스위치를 지정하는 경우 /silent 스위치도 지정해야 합니다.If you specify this switch, you must also specify the /silent switch.
/silent/silent 아니요No 사용자에게 메시지를 표시하거나 상태 알림 영역의 아이콘을 비롯한 UI를 표시하지 않고 도움말 콘텐츠를 설치하거나 제거합니다.Installs or removes Help content without prompting the user or displaying any UI, including the icon in the status notification area. 출력은 %Temp% 디렉터리의 파일에 기록됩니다.Output is logged to a file in the %Temp% directory. 중요: 콘텐츠를 자동으로 설치하려면 .mshc 파일이 아니라 디지털 서명된 .cab 파일을 사용해야 합니다.Important: To install content silently, you must use digitally signed .cab files, not .mshc files.
/launchingApp/launchingApp 아니요No 도움말 뷰어가 부모 응용 프로그램 없이 시작될 때 응용 프로그램 및 카탈로그 컨텍스트를 정의합니다.Defines the application and catalog context when the Help viewer is launched without the parent application. 이 스위치의 인수는 CompanyName, ProductNameVersionNumber(예: /launchingApp Microsoft,VisualStudio,15.0)입니다.The arguments for this switch are CompanyName, ProductName, and VersionNumber (for example, /launchingApp Microsoft,VisualStudio,15.0).

이 스위치는 /silent 매개 변수를 사용하여 콘텐츠를 설치하는 데 필요합니다.This is required for installing content with the /silent parameter."
/wait Seconds/wait Seconds 아니요No 설치, 제거 및 새로 고침 작업을 일시 중지합니다.Pauses install, uninstall, and refresh operations. 작업이 이미 카탈로그에 대해 진행 중인 경우 프로세스는 지정된 기간(초)까지 대기한 다음 계속됩니다.If an operation is already in progress for the catalog, the process will wait up to the given number of seconds to continue. 무한정 기다리려면 0을 사용합니다.Use 0 to wait indefinitely.
/?/? 아니요No 도움말 콘텐츠 관리자용 명령줄 도구에 대한 스위치와 해당 설명을 나열합니다.Lists the switches and their descriptions for the command-line tool for Help Content Manager.

종료 코드Exit Codes

도움말 콘텐츠 관리자용 명령줄 도구를 자동 모드에서 실행하면 다음과 같은 종료 코드가 반환됩니다.When you run the command-line tool for the Help Content Manager in silent mode, it returns the following exit codes:

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.)

참고 항목See also

도움말 뷰어 관리자 가이드Help Viewer Administrator Guide
도움말 콘텐츠 관리자 재정의Help Content Manager Overrides
Microsoft 도움말 뷰어Microsoft Help Viewer