Modificar o comportamento da navegação raiz para uma extensão de solução

• Aplica-se a:

  ✅ Windows Admin Center, ✅ Windows Admin Center Preview

Este artigo apresenta diretrizes sobre como modificar o comportamento de navegação raiz para que sua solução tenha um comportamento de lista de conexões diferente. Você também aprenderá a ocultar ou mostrar a lista de ferramentas.

Como modificar o comportamento da navegação raiz

Abra o arquivo manifest.json em {raiz da extensão}\src e localize a propriedade "rootNavigationBehavior". Essa propriedade tem dois valores válidos: "connections" ou "path". O comportamento de "connections" será detalhado mais adiante na documentação.

Como definir o caminho como um rootNavigationBehavior

Defina o valor de rootNavigationBehavior como path, exclua a propriedade requirements e mantenha a propriedade path como uma cadeia de caracteres vazia. Você concluiu a configuração mínima necessária para criar uma extensão de solução. Salve o arquivo e o build do gulp -> (gulp serve como uma ferramenta) e carregue a extensão por sideload na extensão local do Windows Admin Center.

Uma matriz de entryPoints de manifesto válida tem esta aparência:

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

As ferramentas criadas com esse tipo de estrutura não exigirão conexões para o carregamento, mas também não terão a funcionalidade de conectividade de nó.

Como definir as conexões como um rootNavigationBehavior

Ao definir a propriedade rootNavigationBehavior como connections, você está informando ao Shell do Windows Admin Center de que há um nó conectado (sempre um servidor de algum tipo) ao qual ele deve se conectar para verificar o status da conexão. Há duas etapas para verificar uma conexão.

1. O Windows Admin Center tenta fazer logon no nó com suas credenciais (para estabelecer a sessão remota do PowerShell).
2. O Windows Admin Center executa o script do PowerShell que você fornece para verificar se o nó está em um estado conectável.

Uma definição de solução válida com as conexões terá esta aparência:

        {
          "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"
            }
        },

Quando o rootNavigationBehavior é definido como "connections", você precisa compilar a definição de conexões no manifesto. Isso inclui a propriedade "header" (exibida no cabeçalho da solução quando um usuário a selecionar no menu) e uma matriz de connectionTypes (isso especificará os connectionTypes que são usados na solução. Mais informações sobre isso na documentação do connectionProvider.

Como habilitar e desabilitar o menu de ferramentas

Outra propriedade disponível na definição da solução é a propriedade Tools. A propriedade Ferramentas decide se o menu Ferramentas é exibido e qual ferramenta será carregada. Quando habilitado, o Windows Admin Center renderizará o menu Ferramentas à esquerda. Com defaultTool, é necessário que você adicione um ponto de entrada de ferramenta ao manifesto para carregar os recursos apropriados. O valor de "defaultTool" precisa ser a propriedade "name" da ferramenta, pois ela é definida no manifesto.