Instalar e gerenciar extensões

O Windows Admin Center foi criado como uma plataforma extensível onde cada tipo de conexão e ferramenta é uma extensão que você pode instalar, desinstalar e atualizar individualmente. Pode procurar novas extensões publicadas pela Microsoft e por outros programadores e instalá-las e atualizá-las individualmente sem ter de atualizar toda a instalação do Windows Admin Center. Você também pode configurar um feed ou compartilhamento de arquivos NuGet separado e distribuir extensões para usar internamente em sua organização.

Instalando uma extensão

O Windows Admin Center mostra extensões disponíveis no feed NuGet especificado. Por padrão, o Windows Admin Center aponta para o feed NuGet oficial da Microsoft, que hospeda extensões publicadas pela Microsoft e outros desenvolvedores.

1. Selecione o botão Configurações no canto superior direito > No painel esquerdo, selecione Extensões.
2. A guia Extensões disponíveis lista as extensões no feed que estão disponíveis para instalação.
3. Selecione uma extensão para exibir a descrição da extensão, versão, editor e outras informações no painel Detalhes .
4. Selecione Instalar para instalar uma extensão. Se o gateway precisar ser executado no modo elevado para fazer essa alteração, será apresentado um prompt de elevação do UAC (Controle de Conta de Usuário). Após a conclusão da instalação, o navegador é atualizado automaticamente e o Windows Admin Center é recarregado com a nova extensão instalada. Se a extensão que está a tentar instalar for uma atualização para uma extensão instalada anteriormente, pode selecionar o botão Atualizar para a mais recente para instalar a atualização. Você também pode ir para a guia Extensões instaladas para exibir as extensões instaladas e ver se uma atualização está disponível na coluna Status .

Instalando extensões de um feed diferente

O Windows Admin Center suporta vários feeds e pode ver e gerir pacotes a partir de mais do que um feed de cada vez. Qualquer feed do NuGet que ofereça suporte às APIs do NuGet V2 ou a um compartilhamento de arquivos pode ser adicionado ao Windows Admin Center para instalar extensões.

1. Selecione o botão Configurações no canto superior direito > No painel esquerdo, selecione Extensões.
2. No painel direito, selecione a guia Feeds .
3. Selecione o botão Adicionar para adicionar outro feed. Para um feed do NuGet, insira a URL do feed do NuGet V2. O provedor de feed ou administrador do NuGet deve ser capaz de fornecer as informações de URL. Para um compartilhamento de arquivos, insira o caminho completo do compartilhamento de arquivos no qual os arquivos do pacote de extensão (.nupkg) estão armazenados. Ao adicionar um compartilhamento de arquivos como feed, ele deve atender aos seguintes critérios:
   • O acesso ao arquivo deve ser concedido a NTAuthority\Network Service
   • O caminho do arquivo não pode incluir a pasta C:\Users
   • Os pacotes no compartilhamento de arquivos devem ser assinados, a menos que seu modo de operação esteja definido como "Desenvolvimento"
4. Selecione Adicionar. Se o gateway precisar ser executado no modo elevado para fazer essa alteração, será apresentado um prompt de elevação do UAC. Este aviso só será apresentado se estiver a executar o Windows Admin Center no modo de ambiente de trabalho.

A lista Extensões disponíveis mostra extensões de todos os feeds registrados. Você pode verificar de qual feed é cada extensão, usando a coluna Fonte de Pacotes.

Desinstalando uma extensão

Pode desinstalar quaisquer extensões instaladas anteriormente ou até desinstalar quaisquer ferramentas que tenham sido pré-instaladas como parte da instalação do Windows Admin Center.

1. Selecione o botão Configurações no canto superior direito > No painel esquerdo, selecione Extensões.
2. Selecione a guia Extensões instaladas para visualizar todas as extensões instaladas.
3. Escolha uma extensão para desinstalar e, em seguida, selecione Desinstalar.

Após a conclusão da desinstalação, o navegador é atualizado automaticamente e o Windows Admin Center é recarregado com a extensão removida. Se você desinstalou uma ferramenta que foi pré-instalada como parte do Windows Admin Center, a ferramenta estará disponível para reinstalação na guia Extensões Disponíveis .

Instalar extensões num computador sem ligação à Internet

Se o Windows Admin Center estiver instalado em um computador que não esteja conectado à Internet ou esteja atrás de um proxy, talvez não seja possível acessar e instalar as extensões do feed do Windows Admin Center. Você pode baixar pacotes de extensão manualmente ou com um script do PowerShell e configurar o Windows Admin Center para recuperar pacotes de um compartilhamento de arquivos ou unidade local.

Descarregar manualmente os pacotes de extensão

1. Em outro computador que tenha conectividade com a internet, abra um navegador da web e navegue até a seguinte URL: https://dev.azure.com/WindowsAdminCenter/Windows%20Admin%20Center%20Feed/_packaging?_a=feed&feed=WAC

   Talvez seja necessário criar uma conta da Microsoft e entrar para exibir os pacotes de extensão.

2. Selecione o nome do pacote que você deseja instalar para exibir a página de detalhes do pacote.

3. Selecione o link Download na barra de navegação superior da página de detalhes do pacote e baixe o .nupkg arquivo para a extensão.

4. Repita as etapas 2 e 3 para todos os pacotes que você deseja baixar.

5. Copie os arquivos do pacote para um compartilhamento de arquivos que possa ser acessado a partir do computador em que o Windows Admin Center está instalado ou para o disco local do computador no qual o Windows Admin Center está instalado.

6. Siga as instruções para instalar extensões a partir de um feed diferente.

Baixando pacotes com um script do PowerShell

Há scripts disponíveis na Internet para baixar pacotes NuGet de um feed NuGet. Usamos o script fornecido por Jon Galloway, Gerente de Programa Sênior da Microsoft.

1. Conforme descrito na postagem do blog, instale o script como um pacote NuGet ou copie e cole o script no ISE do PowerShell.

2. Edite a primeira linha do script para o URL v2 do seu feed NuGet. Se estiver a transferir pacotes a partir do feed oficial do Windows Admin Center, utilize o seguinte URL:

   $feedUrlBase = "https://aka.ms/sme-extension-feed"
   

3. Execute o script e ele baixa todos os pacotes NuGet do feed para a seguinte pasta local: %USERPROFILE%\Documents\NuGetLocal

4. Siga as instruções para instalar extensões a partir de um feed diferente.

Gerir extensões com o PowerShell

O Windows Admin Center Preview inclui um módulo do PowerShell para gerenciar suas extensões de gateway.

# Add the module to the current session
Import-Module "$env:ProgramFiles\windows admin center\PowerShell\Modules\ExtensionTools"
# Available cmdlets: Get-Feed, Add-Feed, Remove-Feed, Get-Extension, Install-Extension, Uninstall-Extension, Update-Extension

# List feeds
Get-Feed "https://wac.contoso.com"

# Add a new extension feed
Add-Feed -GatewayEndpoint "https://wac.contoso.com" -Feed "\\WAC\our-private-extensions"

# Remove an extension feed
Remove-Feed -GatewayEndpoint "https://wac.contoso.com" -Feed "\\WAC\our-private-extensions"

# List all extensions
Get-Extension "https://wac.contoso.com"

# Install an extension (locate the latest version from all feeds and install it)
Install-Extension -GatewayEndpoint "https://wac.contoso.com" "msft.sme.containers"

# Install an extension (latest version from a specific feed, if the feed is not present, it will be added)
Install-Extension -GatewayEndpoint "https://wac.contoso.com" "msft.sme.containers" -Feed "https://aka.ms/sme-extension-feed"

# Install an extension (install a specific version)
Install-Extension "https://wac.contoso.com" "msft.sme.certificate-manager" "0.133.0"

# Uninstall-Extension
Uninstall-Extension "https://wac.contoso.com" "msft.sme.containers"

# Update-Extension
Update-Extension "https://wac.contoso.com" "msft.sme.containers"

Saiba mais sobre como criar uma extensão com o SDK do Windows Admin Center.

Extensões de plug-in de gateway

As extensões de plug-in de gateway do Windows Admin Center são mais afetadas pelas alterações em nosso gateway modernizado. Os plug-ins de gateway do Windows Admin Center permitem a comunicação de API da interface do usuário da sua ferramenta ou solução para um nó de destino. O Windows Admin Center hospeda um serviço de gateway que retransmite comandos e scripts de plug-ins de gateway para serem executados em nós de destino. O serviço de gateway pode ser estendido para incluir plug-ins de gateway personalizados que suportam protocolos diferentes dos padrão (PowerShell e WMI).

Como os plug-ins de gateway se comunicam com o back-end do Windows Admin Center para habilitar a comunicação de API, o código do plug-in de gateway pode incluir componentes escritos com o .NET Framework versão 4.6.2, que não funcionará com o .NET 8.

Além disso, modificamos a forma como os plug-ins funcionam com a versão 2410. Em vez de desenvolver uma classe C# que implementa a interface IPlugIn do namespace Microsoft.ManagementExperience.FeatureInterfaces para estender o plug-in de gateway, as extensões agora serão escritas na forma de controladores MVC ASP.NET. Esses controladores aumentaram a flexibilidade em comparação com a classe C# simples e a extensa documentação.

Consulte nossa documentação para desenvolvedores para saber mais sobre o desenvolvimento de plug-ins de gateway no Windows Admin Center.

Extensões de gateway não suportadas

O feed de extensões para o gateway do Windows Admin Center não está configurado. As extensões não incluídas no instalador do Windows Admin Center, incluindo extensões de parceiros externos, não estão disponíveis a menos que você adicione um feed de extensões.

As seguintes extensões estão disponíveis após a instalação da compilação do gateway modernizado:

• Aplicações e funcionalidades
• Azure Backup
• Azure File Sync
• Centro híbrido do Azure
• Azure Kubernetes Service
• Certificados
• Criação de Cluster
• Gestor de Cluster
• Guia do desenvolvedor
• Dispositivos
• Eventos
• Ferramentas de clusters de failover
• Arquivos & compartilhamento de arquivos
• Firewall
• Usuários locais & grupos
• Ferramentas de controlador de rede e redes virtuais SDN
• Redes
• Monitoramento de pacotes
• Monitor de Desempenho
• PowerShell
• Processes
• Registry
• Ambiente de Trabalho Remoto
• Funções e recursos
• Tarefas agendadas
• Conexões de gateway SDN
• Infraestrutura SDN
• Redes lógicas SDN
• Grupos de segurança de rede SDN
• Segurança
• Gestor de Servidores e Gestão de Computadores
• Services
• Armazenamento
• Serviço de migração de armazenamento
• Réplica de armazenamento
• Insights do sistema
• Atualizações
• Máquinas virtuais e comutadores