Desenvolver uma extensão de solução

  • Artigo
  • Aplica-se a:
    ✅ Windows Admin Center, ✅ Windows Admin Center Preview

As soluções definem principalmente um tipo exclusivo do objeto que você quer gerenciar usando o Windows Admin Center. Essas soluções/tipos de conexão são incluídos com Windows Admin Center por padrão:

  • Conexões do Windows Server
  • Conexões de computador Windows
  • Conexões de cluster de failover
  • Conexões de cluster hiperconvergentes

Quando você seleciona uma conexão na página de conexão Windows Admin Center, a extensão de solução para o tipo dessa conexão é carregada e o Windows Admin Center tentará se conectar ao nó alvo. Se a conexão for bem-sucedida, a interface do usuário da extensão de solução será carregada e o Windows Admin Center exibirá as ferramentas dessa solução no painel de navegação esquerdo.

Se você quiser criar uma GUI de gerenciamento para serviços não definidos pelos tipos de conexão padrão acima, como um comutador de rede ou outro hardware não detectável pelo nome do computador, talvez você queira criar uma extensão própria da solução.

Observação

Não está familiarizado com os diferentes tipos de extensão? Saiba mais sobre a arquitetura de extensibilidade e os tipos de extensão.

Prepare o seu ambiente

Caso ainda não tenha feito isso, prepare seu ambiente instalando dependências e pré-requisitos globais necessários para todos os projetos.

Criar uma extensão de solução com o SDK do Windows Admin Center

Depois de instalar todas as dependências, você estará pronto para criar sua extensão de solução. Crie ou navegue até uma pasta que contenha seus arquivos de projeto, abra um prompt de comando e defina essa pasta como o diretório de trabalho. Usando o SDK do Windows Admin Center que foi instalado anteriormente, crie uma extensão com a seguinte sintaxe:

wac create --company "{!Company Name}" --solution "{!Solution Name}" --tool "{!Tool Name}" --version latest
Valor Explicação Exemplo
{!Company Name} Nome da sua empresa (com espaços) Contoso Inc
{!Solution Name} Nome da solução (com espaços) Contoso Foo Works Suite
{!Tool Name} O nome da sua ferramenta (com espaços) Manage Foo Works

Aqui está um uso de exemplo:

wac create --company "Contoso Inc" --solution "Contoso Foo Works Suite" --tool "Manage Foo Works"

Isso cria uma pasta dentro do diretório de trabalho atual usando o nome especificado para sua solução, copia todos os arquivos de modelo necessários em seu projeto e configura os arquivos com sua empresa, solução e nome da ferramenta.

Observação

O sinalizador --version neste comando especifica qual versão do SDK do Windows Admin Center você gostaria de direcionar. Leia sobre como direcionar uma versão diferente do SDK do Windows Admin Center para manter sua extensão atualizada com as alterações mais recentes do SDK e da plataforma.

Em seguida, altere o diretório para a pasta que acabou de ser criada e instale as dependências locais necessárias executando o seguinte comando:

npm install

Depois que isso for concluído, você configurará tudo o que precisa para carregar sua nova extensão em Windows Admin Center.

Adicionar conteúdo à sua extensão

Agora que você criou uma extensão com o SDK do Windows Admin Center, está pronto para personalizar o conteúdo. Confira estes guias para obter exemplos do que você pode fazer:

Ainda mais exemplos podem ser encontrados em nosso Guia do Desenvolvedor. O Guia do Desenvolvedor é uma extensão de solução totalmente funcional que pode ser carregada em Windows Admin Center e contém uma coleção avançada de exemplos de funcionalidade e de ferramentas que você pode procurar e usar em sua extensão.

Habilite a extensão Guia do Desenvolvedor na página Avançado das configurações do Windows Admin Center.

Compilar e carregar a extensão lateralmente

Em seguida, compile e carregue a extensão no Windows Admin Center. Abra uma janela Comando, altere o diretório para o diretório de origem e você estará pronto para criar.

  • Compilar e servir com gulp:

    gulp build
gulp serve --port 4201

Observe que você precisa escolher uma porta que está atualmente gratuita. Certifique-se de não tentar usar a porta que está em execução no Windows Admin Center.

Seu projeto pode ser transferido por sideload em uma instância local do Windows Admin Center para teste ao anexar o projeto servido localmente no Windows Admin Center.

  • Iniciar o Windows Admin Center em um navegador da Web

  • Abrir o depurador (F12)

  • Abra o Console e digite o seguinte comando:

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

  • Atualizar o navegador da Web

Seu projeto agora estará visível na lista Ferramentas com (sideloaded) ao lado do nome.