도움말 콘텐츠 관리자에 대한 명령줄 인수

도움말 콘텐츠 관리자(HlpCtntmgr.exe)의 명령줄 인수를 사용하여 로컬 도움말 콘텐츠를 배포하고 관리하는 방법을 지정할 수 있습니다. 관리자 권한으로 이 명령줄 도구에 대한 스크립트를 실행해야 하며 이러한 스크립트를 서비스로 실행할 수는 없습니다. 이 도구를 사용하여 다음과 같은 작업을 수행할 수 있습니다.

  • 디스크 또는 클라우드에서 로컬 도움말 콘텐츠를 추가하거나 업데이트합니다.

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

  • 로컬 도움말 콘텐츠 저장소를 이동합니다.

  • 로컬 도움말 콘텐츠를 자동으로 추가, 업데이트, 제거 또는 이동합니다.

    구문:

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

예를 들면 다음과 같습니다.

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

스위치 및 인수

다음 표에는 도움말 콘텐츠 관리자용 명령줄 도구에 사용할 수 있는 스위치와 인수가 정의되어 있습니다.

전환 필수 여부 인수
/operation - Install--지정된 설치 소스의 책을 로컬 콘텐츠 저장소에 추가합니다.
이 스위치에는 /booklist 인수 또는 /sourceURI 인수가 필요하거나 두 인수가 모두 필요합니다. /sourceURI 인수를 지정하지 않는 경우 기본 Visual Studio URI가 설치 소스로 사용됩니다. /booklist 인수를 지정하지 않는 경우 /sourceUri의 모든 책이 설치됩니다.
- Uninstall--지정하는 책을 로컬 콘텐츠 저장소에서 제거합니다.
이 스위치에는 /booklist 인수 또는 /sourceURI 인수가 필요합니다. /sourceURI 인수를 지정하는 경우 모든 책이 제거되고 /booklist 인수가 무시됩니다.
- Move--지정하는 경로로 로컬 저장소를 이동합니다. 기본 로컬 저장소 경로는 도움말 설정에 의해 %PROGRAMDATA% 아래에 설정됩니다.
이 스위치에는 /locationPath 및 /catalogName 인수가 필요합니다. 잘못된 경로를 지정하거나 드라이브에 콘텐츠를 저장할 충분한 여유 공간이 없는 경우 오류 메시지가 이벤트 로그에 기록됩니다.
- Refresh--설치된 이후 변경되었거나 최근에 업데이트된 항목을 업데이트합니다.
이 스위치에는 /sourceURI 인수가 필요합니다.
/catalogName 콘텐츠 카탈로그의 이름을 지정합니다.
/locale 아니요 도움말 뷰어의 현재 인스턴스에 대한 콘텐츠를 보고 관리하는 데 사용되는 제품 로캘을 지정합니다. 예를 들어 영어-미국의 경우 EN-US를 지정합니다.

로캘을 지정하지 않는 경우 운영 체제의 로캘이 사용됩니다. 로캘을 확인할 수 없는 경우에는 EN-US가 사용됩니다.

잘못된 로캘을 지정하면 오류 메시지가 이벤트 로그에 기록됩니다.
/e 아니요 현재 사용자에게 관리자 자격 증명이 있는 경우 도움말 콘텐츠 관리자를 관리자 권한으로 승격합니다.
/sourceURI 아니요 콘텐츠가 설치되는 URL(서비스 API) 또는 콘텐츠 설치 파일(.msha)의 경로를 지정합니다. URL은 Visual Studio 2010 스타일 끝점에서 제품 그룹(최상위 노드) 또는 제품 책(리프 수준 노드)을 가리킬 수 있습니다. URL 끝에 슬래시(/)를 포함할 필요가 없습니다. 끝에 슬래시를 포함하는 경우 적절하게 처리됩니다.

찾을 수 없거나, 잘못되거나, 액세스할 수 없는 파일을 지정하는 경우나 콘텐츠를 관리하는 동안 인터넷 연결을 사용할 수 없거나 중단된 경우 오류 메시지가 이벤트 로그에 기록됩니다.
/vendor 아니요 제거될 제품 콘텐츠의 공급업체를 지정합니다(예: Microsoft). 이 스위치의 기본 인수는 Microsoft입니다.
/productName 아니요 제거될 책의 제품 이름을 지정합니다. 제품 이름은 콘텐츠와 함께 제공되는 helpcontentsetup.msha 또는 books.html 파일에서 식별됩니다. 한 번에 한 제품에서만 책을 제거할 수 있습니다. 여러 제품에서 책을 제거하려면 여러 설치를 수행해야 합니다.
/booklist 아니요 관리할 책의 이름을 공백으로 구분하여 지정합니다. 값은 설치 미디어에 표시된 책 이름과 일치해야 합니다.

이 인수를 지정하지 않는 경우 설치 소스가 Visual Studio 2012Visual Studio 2012 형식이면 /sourceURI에 지정된 제품의 모든 권장되는 책이 설치됩니다.

책의 이름에 공백이 하나 이상 포함되어 있으면 목록이 적절하게 구분되도록 큰따옴표(")로 묶습니다.

잘못되거나 연결될 수 없는 /sourceURI를 지정하는 경우 오류 메시지가 기록됩니다.
/skuId 아니요 설치 원본에서 제품의 SKU(Stock Keeping Unit)를 지정하고 /SourceURI 스위치로 식별되는 책을 필터링합니다.
/membership 아니요 - Minimum--/skuId 스위치를 사용하여 지정한 SKU를 기반으로 도움말 콘텐츠의 최소 집합을 설치합니다. SKU와 콘텐츠 집합 간의 매핑은 서비스 API에서 노출됩니다.
- Recommended--/skuId 인수를 사용하여 지정한 SKU에 대한 권장되는 책의 집합을 설치합니다. 설치 원본은 서비스 API 또는 .MSHA입니다.
- Full--/skuId 인수를 사용하여 지정한 SKU에 대한 책의 전체 집합을 설치합니다. 설치 원본은 서비스 API 또는 .MSHA입니다.
/locationpath 아니요 로컬 도움말 콘텐츠의 기본 폴더를 지정합니다. 이 스위치는 콘텐츠를 설치하거나 이동하는 데만 사용해야 합니다. 이 스위치를 지정하는 경우 /silent 스위치도 지정해야 합니다.
/silent 아니요 사용자에게 메시지를 표시하거나 상태 알림 영역의 아이콘을 비롯한 UI를 표시하지 않고 도움말 콘텐츠를 설치하거나 제거합니다. 출력은 %Temp% 디렉터리의 파일에 기록됩니다. 중요: 콘텐츠를 자동으로 설치하려면 .mshc 파일이 아니라 디지털 서명된 .cab 파일을 사용해야 합니다.
/launchingApp 아니요 도움말 뷰어가 부모 응용 프로그램 없이 시작될 때 응용 프로그램 및 카탈로그 컨텍스트를 정의합니다. 이 스위치의 인수는 CompanyName, ProductNameVersionNumber(예: /launchingApp Microsoft,VisualStudio,11.0)입니다.

이 스위치는 /silent 매개 변수를 사용하여 콘텐츠를 설치하는 데 필요합니다.
/wait Seconds 아니요 설치, 제거 및 새로 고침 작업을 일시 중지합니다. 작업이 이미 카탈로그에 대해 진행 중인 경우 프로세스는 지정된 기간(초)까지 대기한 다음 계속됩니다. 무한정 기다리려면 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.)  

참고 항목

도움말 뷰어 관리자 가이드
도움말 콘텐츠 관리자 재정의