도구 확장 개발
도구 확장은 사용자가 Windows Admin Center와 상호 작용하여 서버 또는 클러스터와 같은 연결을 관리하는 기본 방법입니다. Windows Admin Center 홈 화면에서 연결을 클릭하면 왼쪽 탐색 창에 도구 목록이 나타납니다. 도구를 클릭하면 도구 확장이 로드되고 이는 오른쪽 창에 표시됩니다.
도구 확장이 로드되면 대상 서버 또는 클러스터에서 WMI 호출 또는 PowerShell 스크립트를 실행하고, UI에 정보를 표시하거나 사용자 입력에 따라 명령을 실행할 수 있습니다. 도구 확장은 표시해야 하는 솔루션을 정의하므로 각 솔루션에 대한 다른 도구 집합이 생성됩니다.
참고 항목
다른 확장 유형에 익숙하지 않으신가요? 확장성 아키텍처 및 확장 유형에 대해 자세히 알아보세요.
사용자 환경 준비하기
아직 준비하지 않은 경우 모든 프로젝트에 필요한 종속성 및 전역 필수 구성 요소를 설치하여 환경을 준비합니다.
Windows Admin Center SDK를 사용하여 새 도구 확장 만들기
모든 종속성이 설치되면 새 도구 확장을 생성할 준비가 된 것입니다. 프로젝트 파일이 포함된 폴더를 생성하거나 찾아 명령 프롬프트를 열고 해당 폴더를 작업 디렉터리로 설정하세요. 이전에 설치된 Windows Admin 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 Admin Center SDK 버전을 지정합니다. 최신 SDK 및 플랫폼 변경 내용으로 확장을 최신 상태로 유지하기 위해 다른 버전의 Windows Admin Center SDK를 대상으로 지정하는 방법을 알아봅니다.
다음으로 방금 만든 폴더로 디렉터리를 변경한 다음, 다음 명령을 실행하여 필요한 로컬 종속성을 설치합니다.
npm install
해당 작업이 완료되면 새 확장을 Windows Admin Center에 로드하는 데 필요한 모든 항목을 설정한 것입니다.
콘텐츠에 확장을 추가합니다.
이제 Windows Admin Center SDK를 사용하여 확장을 생성했으므로 콘텐츠를 사용자 지정할 준비가 된 것입니다. 수행할 수 있는 작업에 대한 예제로 다음 가이드를 참조하세요.
개발자 가이드에서 더 많은 예제를 찾을 수 있습니다. 개발자 가이드는 Windows Admin Center에 테스트용으로 로드할 수 있,는 완벽하게 작동하는 솔루션 확장이며, 고유한 확장에서 찾아보고 사용할 수 있는 다양한 샘플 기능 및 도구 예제 컬렉션을 포함합니다.
Windows Admin Center 설정의 고급 페이지에서 개발자 가이드 확장을 사용하도록 설정합니다.
확장 아이콘 사용자 지정
도구 목록에서 확장 표시에 대한 아이콘을 사용자 지정할 수 있습니다. 이렇게 하려면 확장에 대한 manifest.json의 모든 icon 항목을 수정합니다.
"icon": "{!icon-uri}",
| 값 | 설명 | 예시 URI |
|---|---|---|
{!icon-uri} |
아이콘 리소스 그룹 위치 | assets/foo-icon.svg |
참고: 현재 개발 모드에서 확장을 로드할 때 사용자 지정 아이콘이 표시되지 않습니다. 해결 방법으로 다음과 같은 target 내용을 제거합니다.
"target": "",
이 구성은 개발 모드에서 테스트용 로드에만 유효하므로 확장을 게시하기 전에 target에 포함된 값을 유지한 다음 복원하는 것이 중요합니다.
확장 빌드 및 테스트용 로드
다음으로, 확장을 빌드하고 Windows Admin Center에 테스트용으로 로드합니다. 명령 창을 열고 디렉터리를 원본 디렉터리로 변경하고 나면 빌드할 준비가 된 것입니다.
gulp를 사용하여 빌드 및 제공.
gulp build gulp serve --port 4201
현재 사용 가능한 포트를 선택해야 합니다. Windows Admin Center가 실행 중인 포트를 사용하지 않도록 하세요.
로컬로 제공되는 프로젝트를 Windows Admin Center에 연결하여 테스트용으로 프로젝트를 Windows Admin Center의 로컬 인스턴스에 로드할 수 있습니다.
웹 브라우저에서 Windows Admin Center 실행
디버거 열기(F12)
콘솔을 열고 다음 명령어를 입력합니다.
MsftSme.sideLoad("http://localhost:4201")웹 브라우저를 새로 고칩니다.
이제 프로젝트 이름이 옆에 있는(테스트용 로드) 도구 목록에 프로젝트가 표시됩니다.