Desenvolver uma extensão de ferramenta

Aplica-se a: Windows Admin Center, Versão prévia do Windows Admin Center

uma extensão de ferramenta é a principal maneira que os usuários interagem com Windows centro de administração para gerenciar uma conexão, como um servidor ou cluster. ao clicar em uma conexão na tela inicial do Windows Admin Center e conectar, você verá uma lista de ferramentas no painel de navegação à esquerda. Quando você clica em uma ferramenta, a extensão de ferramenta é carregada e exibida no painel direito.

Quando uma extensão de ferramenta é carregada, ela pode executar chamadas WMI ou scripts do PowerShell em um servidor de destino ou cluster e exibir informações na interface do usuário ou executar comandos com base na entrada do usuário. As extensões de ferramenta definem quais soluções devem ser exibidas, resultando em um conjunto diferente de ferramentas para cada solução.

Observação

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

Prepare o seu ambiente

Se você ainda não fez isso, Prepare seu ambiente instalando dependências e pré-requisitos globais necessários para todos os projetos.

criar uma nova extensão de ferramenta com o SDK do centro de administração Windows

Depois de ter todas as dependências instaladas, você estará pronto para criar sua nova extensão de ferramenta. Crie ou navegue até uma pasta que contém os arquivos de projeto, abra um prompt de comando e defina essa pasta como o diretório de trabalho. usando o SDK do centro de administração Windows que foi instalado anteriormente, crie uma nova extensão com a seguinte sintaxe:

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

Aqui está um uso de exemplo:

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

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

Em seguida, altere o diretório para a pasta recém-criada e instale as dependências locais necessárias executando o seguinte comando:

npm install

quando isso for concluído, você configurou tudo o que precisa para carregar sua nova extensão no centro de administração Windows.

Adicionar conteúdo à sua extensão

agora que você criou uma extensão com o Windows SDK do centro de administração, você está pronto para personalizar o conteúdo. Consulte 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 no centro de administração do Windows e contém uma rica coleção de exemplos de funcionalidade e de ferramentas que você pode procurar e usar em sua própria extensão.

habilite a extensão do guia do desenvolvedor na página avançado de suas configurações do centro de administração do Windows.

Personalizar o ícone da extensão

Você pode personalizar o ícone que aparece para sua extensão na lista de ferramentas. Para fazer isso, modifique todas as icon entradas em manifest.json para sua extensão:

"icon": "{!icon-uri}",
Valor Explicação URI de exemplo
{!icon-uri} O local do recurso de ícone assets/foo-icon.svg

Observação: atualmente, os ícones personalizados não são visíveis ao carregar o lado de sua extensão no modo de desenvolvimento. Como alternativa, remova o conteúdo da target seguinte maneira:

"target": "",

Essa configuração só é válida para o carregamento lateral no modo dev, portanto, é importante preservar o valor contido em target e, em seguida, restaurá-lo antes de publicar sua extensão.

Compilar e carregar lado sua extensão

em seguida, compile e carregue sua extensão no centro de administração do Windows. Abra uma janela de comando, altere o diretório para o diretório de origem e, em seguida, você estará pronto para compilar.

  • 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.

direcionar uma versão diferente do SDK do centro de administração Windows

Manter sua extensão atualizada com alterações do SDK e alterações na plataforma é fácil. leia sobre como direcionar uma versão diferente do SDK do centro de administração Windows.