다음을 통해 공유

솔루션 확장에 대한 루트 탐색 동작 수정하기

  • 아티클

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

해당 문서는 솔루션의 루트 탐색 동작을 수정하여 다른 연결 목록 동작을 취하는 방법에 대한 지침을 제공합니다. 도구 목록을 숨기거나 표시하는 방법도 알아보세요.

루트 탐색 동작 수정하기

{extension root}\src에서 manifest.json 파일을 열고 'rootNavigationBehavior' 속성을 찾으세요. 해당 속성에는 '연결(connections)' 또는 '경로(path)'라는 두 개의 유효한 값이 있습니다. '연결' 동작은 설명서의 뒷부분에 자세히 설명되어 있습니다.

경로(path)를 rootNavigationBehavior로 설정

rootNavigationBehavior 값을 path로 설정한 다음 requirements 속성을 삭제하고 path 속성을 빈 문자열로 둡니다. 솔루션 확장 빌드에 필요한 최소한의 구성을 완료했습니다. 파일을 저장하고 gulp 빌드 -> gulp는 도구와 마찬가지로 제공된 다음 로컬 Windows Admin Center 확장에 사이드 로드합니다.

유효한 매니페스트 entryPoints 배열은 다음과 같습니다.

    "entryPoints": [
        {
          "entryPointType": "solution",
          "name": "main",
          "urlName": "testsln",
          "displayName": "resources:strings:displayName",
          "description": "resources:strings:description",
          "icon": "sme-icon:icon-win-powerShell",
          "path": "",
          "rootNavigationBehavior": "path"
        }
    ],

이러한 종류의 구조로 빌드된 도구는 로드할 때 연결이 필요하지 않지만 노드 연결 기능 또한 없습니다.

연결을 rootNavigationBehavior로 설정

rootNavigationBehavior 속성을 connections로 설정하면 연결 상태를 확인하기 위해 연결해야 하는 연결된 노드(항상 특정 유형의 서버)가 있음을 Windows Admin Center Shell에 알려 줍니다. 연결을 확인하는 두 가지 단계가 있습니다.

  1. Windows Admin Center는 자격 증명을 사용하여 노드에 로그인하려고 시도합니다(원격 PowerShell 세션 설정).
  2. Windows Admin Center는 사용자가 제공하는 PowerShell 스크립트를 실행하여 노드가 연결 가능한 상태인지 확인합니다.

연결을 포함하는 유효 솔루션 정의는 다음과 같습니다.

        {
          "entryPointType": "solution",
          "name": "example",
          "urlName": "solutionexample",
          "displayName": "resources:strings:displayName",
          "description": "resources:strings:description",
          "icon": "sme-icon:icon-win-powerShell",
          "rootNavigationBehavior": "connections",
          "connections": {
            "header": "resources:strings:connectionsListHeader",
            "connectionTypes": [
                "msft.sme.connection-type.example"
                ]
            },
            "tools": {
                "enabled": false,
                "defaultTool": "solution"
            }
        },

rootNavigationBehavior가 '연결(connections)'로 설정된 경우 매니페스트에서 연결 정의를 빌드해야 합니다. 여기에는 '헤더(header)' 속성(사용자가 메뉴에서 선택할 때 솔루션 헤더에 표시됨) 및 connectionTypes 배열(솔루션에서 사용되는 connectionTypes를 지정함)이 포함됩니다. 자세한 내용은 connectionProvider 설명서를 참조하세요.

도구 메뉴 활성화 및 비활성화

솔루션 정의에서 사용할 수 있는 또 다른 속성은 도구 속성입니다. 도구 속성은 도구 메뉴의 표시 여부와 로드할 도구를 결정합니다. 사용하도록 설정하면 Windows Admin Center가 왼쪽 도구 메뉴를 렌더링합니다. defaultTool을 사용하면 적절한 리소스를 로드하고자 매니페스트에 도구 진입점을 추가해야 합니다. 'defaultTool' 값은 매니페스트에 정의된 대로 도구의 '이름(name)' 속성이어야 합니다.