도구 확장은 사용자가 Windows Admin Center와 상호 작용하여 서버 또는 클러스터와 같은 연결을 관리하는 기본 방법입니다. Windows Admin Center 홈 화면에서 연결을 클릭하면 왼쪽 탐색 창에 도구 목록이 표시됩니다. 도구를 클릭하면 도구 확장이 로드되고 오른쪽 창에 표시됩니다.
도구 확장이 로드되면 대상 서버 또는 클러스터에서 WMI 호출 또는 PowerShell 스크립트를 실행하고 UI에 정보를 표시하거나 사용자 입력에 따라 명령을 실행할 수 있습니다. 도구 확장은 표시해야 하는 솔루션을 정의하므로 각 솔루션에 대해 다른 도구 집합이 생성됩니다.
Note
다른 확장 유형에 익숙하지 않으신가요? 확장성 아키텍처 및 확장 유형에 대해 자세히 알아보세요.
환경 준비
아직 준비하지 않은 경우 모든 프로젝트에 필요한 종속성 및 전역 필수 구성 요소를 설치하여 환경을 준비 합니다.
Windows Admin Center SDK를 사용하여 새 도구 확장 만들기
모든 종속성이 설치되면 새 도구 확장을 만들 준비가 된 것입니다. 프로젝트 파일이 포함된 폴더를 만들거나 찾아 명령 프롬프트를 열고 해당 폴더를 작업 디렉터리로 설정합니다. 이전에 설치된 Windows Admin Center SDK를 사용하여 다음 구문을 사용하여 새 확장을 만듭니다.
wac create --company "{!Company Name}" --tool "{!Tool Name}" --version latest
| Value | Explanation | Example |
|---|---|---|
{!Company Name} |
회사 이름(공백 포함) | Contoso Inc |
{!Tool Name} |
도구 이름(공백 포함) | Manage Foo Works |
다음은 사용 예입니다.
wac create --company "Contoso Inc" --tool "Manage Foo Works" --version latest
Windows Admin Center SDK 버전 6.0.0 이상을 사용하면 React 기반 도구 확장 기능도 만들 수 있습니다. 다음 문법을 사용하여 새로운 React 기반 도구 확장 기능을 생성하세요:
wac create-react --company "{!Company Name}" --tool "{!Tool Name}" --version latest
| Value | Explanation | Example |
|---|---|---|
{!Company Name} |
회사 이름(공백 포함) | Contoso Inc |
{!Tool Name} |
도구 이름(공백 포함) | Manage Foo Works |
예제는 다음과 같습니다.
wac create-react --company "Contoso Inc" --tool "Manage Foo Works" --version latest
이렇게 하면 도구에 대해 지정한 이름을 사용하여 현재 작업 디렉터리 내에 새 폴더를 만들고, 필요한 모든 템플릿 파일을 프로젝트에 복사하고, 회사 및 도구 이름으로 파일을 구성합니다.
Note
이 명령의 --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 설정의 고급 페이지에서 개발자 가이드 확장을 사용하도록 설정합니다.
확장 아이콘 사용자 지정
도구 목록에서 확장에 대해 표시되는 아이콘을 사용자 지정할 수 있습니다. 이렇게 하려면, 확장의 모든 icon 항목을 manifest.json에서 수정합니다.
"icon": "{!icon-uri}",
| Value | Explanation | 예제 URI |
|---|---|---|
{!icon-uri} |
아이콘 리소스의 위치 | assets/foo-icon.svg |
참고: 현재 개발 모드에서 확장을 로드할 때 사용자 지정 아이콘이 표시되지 않습니다. 해결 방법으로 다음과 같은 내용을 target 제거합니다.
"target": "",
이 구성은 개발 모드에서 테스트용 로드에만 유효하므로 확장을 게시하기 전에 포함된 target 값을 유지한 다음 복원하는 것이 중요합니다.
확장 프로그램을 빌드하고 사이드로드하세요.
다음으로, 확장 프로그램을 Windows Admin Center에 빌드하고 사이드로딩하세요. 명령 창을 열고 디렉터리를 소스 디렉터리로 변경하세요.
확장 기능을 빌드하고 지원하려면 다음 명령을 실행하세요:
npm run build npm start
이 단말기 계속 가동해.
기본적으로 확장 프로그램은 포트 4200에서 사이드로딩됩니다. 포트를 변경하려면 확장자 package.json 와 appsettings.json 파일을 수정하세요. Windows Admin Center가 실행 중인 포트를 사용하지 않도록 하세요.
테스트를 위해 프로젝트를 Windows Admin Center의 로컬 인스턴스에 사이드로드하려면, 로컬 제공 프로젝트를 첨부하세요.
웹 브라우저에서 Windows Admin Center 실행
디버거 열기(F12)
콘솔을 열고 localhost와 사이드로딩하기 위한 다음 명령을 입력합니다:
MsftSme.sideLoad("http://localhost:4200")FQDN을 사용해 사이드로드하라는 지침을 따랐다면, 콘솔을 열고 다음 명령을 입력하세요:
MsftSme.sideLoad("http://<FQDN>:4200")웹 브라우저를 새로고침하세요.
이제 프로젝트가 도구 목록에 이름 옆에 (사이드로드됨) 표시와 함께 나타납니다.