도구 확장 개발

  • 아티클

적용 대상: Windows 관리 Center, Windows 관리 Center 미리 보기

도구 확장은 사용자가 Windows 관리 Center와 상호 작용하여 서버 또는 클러스터와 같은 연결을 관리하는 기본 방법입니다. Windows 관리 Center 홈 화면에서 연결을 클릭하면 왼쪽 탐색 창에 도구 목록이 표시됩니다. 도구를 클릭하면 도구 확장이 로드되고 오른쪽 창에 표시됩니다.

도구 확장이 로드되면 대상 서버 또는 클러스터에서 WMI 호출 또는 PowerShell 스크립트를 실행하고 UI에 정보를 표시하거나 사용자 입력에 따라 명령을 실행할 수 있습니다. 도구 확장은 표시해야 하는 솔루션을 정의하므로 각 솔루션에 대해 다른 도구 집합이 생성됩니다.

참고 항목

다른 확장 유형에 익숙하지 않나요? 확장성 아키텍처 및 확장 유형에 대해 자세히 알아봅니다.

환경 준비

아직 준비하지 않은 경우 모든 프로젝트에 필요한 종속성 및 전역 필수 구성 요소를 설치하여 환경을 준비합니다.

Windows 관리 Center SDK를 사용하여 새 도구 확장 만들기

모든 종속성이 설치되면 새 도구 확장을 만들 준비가 된 것입니다. 프로젝트 파일이 포함된 폴더를 만들거나 찾아 명령 프롬프트를 열고 해당 폴더를 작업 디렉터리로 설정합니다. 이전에 설치된 Windows 관리 Center SDK를 사용하여 다음 구문을 사용하여 새 확장을 만듭니다.

wac create --company "{!Company Name}" --tool "{!Tool Name}" --version latest
값 설명 예시
{!Company Name} 회사 이름(공백 포함) Contoso Inc
{!Tool Name} 도구 이름(공백 포함) Manage Foo Works

다음은 사용 예입니다.

wac create --company "Contoso Inc" --tool "Manage Foo Works" --version latest

이렇게 하면 도구에 대해 지정한 이름을 사용하여 현재 작업 디렉터리 내에 새 폴더를 만들고, 필요한 모든 템플릿 파일을 프로젝트에 복사하고, 회사 및 도구 이름으로 파일을 구성합니다.

참고 항목

이 명령의 --version 플래그는 대상으로 지정할 Windows 관리 Center SDK 버전을 지정합니다. 최신 SDK 및 플랫폼 변경 내용으로 확장을 최신 상태로 유지하기 위해 다른 버전의 Windows 관리 Center SDK를 대상으로 지정하는 방법을 알아봅니다.

다음으로 방금 만든 폴더로 디렉터리를 변경한 다음, 다음 명령을 실행하여 필요한 로컬 종속성을 설치합니다.

npm install

이 작업이 완료되면 Windows 관리 Center에 새 확장을 로드하는 데 필요한 모든 것을 설정했습니다.

확장에 콘텐츠 추가

이제 Windows 관리 Center SDK를 사용하여 확장을 만들었으므로 콘텐츠를 사용자 지정할 준비가 되었습니다. 수행할 수 있는 작업에 대한 예제는 다음 가이드를 참조하세요.

개발자 가이드에서 더 많은 예제를 찾을 수 있습니다. 개발자 가이드는 Windows 관리 Center에 테스트용으로 로드할 수 있는 완전히 작동하는 솔루션 확장이며, 고유한 확장에서 찾아보고 사용할 수 있는 다양한 샘플 기능 및 도구 예제 컬렉션을 포함합니다.

Windows 관리 Center 설정의 고급 페이지에서 개발자 가이드 확장을 사용하도록 설정합니다.

확장 아이콘 사용자 지정

도구 목록에서 확장에 대해 표시되는 아이콘을 사용자 지정할 수 있습니다. 이렇게 하려면 확장에 대한 모든 icon 항목을 manifest.json 수정합니다.

"icon": "{!icon-uri}",
값 설명 예제 URI
{!icon-uri} 아이콘 리소스의 위치 assets/foo-icon.svg

참고: 현재 개발 모드에서 확장을 로드할 때 사용자 지정 아이콘이 표시되지 않습니다. 해결 방법으로 다음과 같은 내용을 target 제거합니다.

"target": "",

이 구성은 개발 모드에서 테스트용 로드에만 유효하므로 확장을 게시하기 전에 포함된 target 값을 유지한 다음 복원하는 것이 중요합니다.

확장 빌드 및 테스트용 로드

다음으로, Windows 관리 Center에 확장을 빌드하고 테스트용으로 로드합니다. 명령 창을 열고 디렉터리를 원본 디렉터리로 변경한 다음 빌드할 준비가 된 것입니다.

  • gulp를 사용하여 빌드 및 제공:

    gulp build
gulp serve --port 4201

현재 사용 가능한 포트를 선택해야 합니다. Windows 관리 Center가 실행 중인 포트를 사용하지 않도록 합니다.

로컬로 제공되는 프로젝트를 Windows 관리 Center에 연결하여 테스트용으로 프로젝트를 Windows 관리 Center의 로컬 인스턴스에 로드할 수 있습니다.

  • 웹 브라우저에서 Windows 관리 센터 시작

  • 디버거 열기(F12)

  • 콘솔을 열고 다음 명령을 입력합니다.

    MsftSme.sideLoad("http://localhost:4201")

  • 웹 브라우저 새로 고침

이제 프로젝트 이름이 옆에 있는(측면 로드) 도구 목록에 프로젝트가 표시됩니다.