Desenvolver uma extensão de solução
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:
- Adicionar um módulo vazio
- Adicionar um iFrame
- Criar um provedor de conexão personalizado
- Modificar o comportamento de navegação raiz
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.