Instalar e gerenciar extensões

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

Como instalar uma extensão

O Windows Admin Center mostra as extensões disponíveis no feed do NuGet especificado. Por padrão, o Windows Admin Center aponta para o feed do NuGet oficial da Microsoft que hospeda as extensões publicadas pela Microsoft e por 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, a versão, o editor e outras informações no painel Detalhes .
4. Selecione Instalar para instalar uma extensão. Se for necessário executar o gateway no modo elevado para fazer essa alteração, você receberá uma solicitação de elevação do UAC (controle da conta de usuário). Após a conclusão da instalação, seu navegador é atualizado automaticamente e o Windows Admin Center e recarregado com a nova extensão instalada. Se a extensão que você está tentando instalar for uma atualização para uma extensão instalada anteriormente, você poderá selecionar o botão Atualizar para o mais recente para instalar a atualização. Você também pode acessar a guia Extensões Instaladas para exibir extensões instaladas e ver se uma atualização está disponível na coluna Status .

Como instalar extensões de um feed diferente

O Windows Admin Center dá suporte a vários feeds e você pode exibir e gerenciar pacotes de mais de um feed de cada vez. Você pode adicionar qualquer feed do NuGet que dê suporte às APIs do NuGet V2 ou a um compartilhamento de arquivos 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 ou o administrador do feed do NuGet deve ser capaz de fornecer as informações de URL. Para um compartilhamento de arquivo, insira o caminho completo do compartilhamento de arquivo no qual os arquivos de pacote de extensão (.nupkg) são armazenados. Se você adicionar um compartilhamento de arquivos como um feed, ele deverá atender aos seguintes critérios:
   • NTAuthority\Network Service deve ter acesso ao arquivo
   • 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, você verá uma solicitação de elevação do UAC. Esse prompt só será exibido se você estiver executando o Windows Admin Center no modo desktop.

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

Desinstalar uma extensão

Você pode desinstalar todas as extensões instaladas anteriormente ou até mesmo desinstalar todas as ferramentas 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 exibir todas as extensões instaladas.
3. Escolha uma extensão para desinstalar e, em seguida, selecione Desinstalar.

Após a conclusão do processo de desinstalação, o navegador é atualizado automaticamente e o Windows Admin Center recarrega com a extensão removida. Se você desinstalou uma ferramenta pré-instalada como parte do Windows Admin Center, poderá reinstalar a ferramenta na guia Extensões Disponíveis .

Instalar extensões em um computador sem conectividade com a Internet

Se você instalar o Windows Admin Center em um computador que não está conectado à Internet ou está por trá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 usando um script do PowerShell e configurar o Windows Admin Center para recuperar pacotes de um compartilhamento de arquivos ou unidade local.

Baixar manualmente pacotes de extensão

1. Em outro computador que tenha conectividade com a Internet, abra um navegador da Web e acesse a seguinte URL: https://dev.azure.com/WindowsAdminCenter/Windows%20Admin%20Center%20Feed/_artifacts/feed/wac-public-extensions

   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 Baixar 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 de pacote para um compartilhamento de arquivos que você pode acessar do computador em que instalou o Windows Admin Center ou para o disco local do computador no qual você instalou o Windows Admin Center.

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

Como baixar pacotes com um script do PowerShell

Você pode encontrar scripts na Internet para baixar pacotes NuGet de um feed do NuGet. Use o script fornecido por Jon Galloway, Gerente Sênior de Programas 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 a URL v2 do feed do NuGet. Se você estiver baixando pacotes do feed oficial do Windows Admin Center, use a seguinte URL:

   $feedUrlBase = "https://aka.ms/wac-public-extensions"
   

3. Executar o script. 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 de um feed diferente.

Gerenciar extensões com o PowerShell

A versão prévia do Windows Admin Center inclui um módulo do PowerShell para gerenciar as 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 do gateway do Windows Admin Center são as que mais sofrem impacto pelas alterações no gateway modernizado. Os plug-ins de gateway do Windows Admin Center permitem a comunicação da 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. Você pode estender o serviço de gateway para incluir plug-ins de gateway personalizados que dão suporte a 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 do gateway pode incluir componentes gravados com o .NET Framework versão 4.6.2, que não funcionam com o .NET 8.

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

Veja nossa documentação do desenvolvedor para saber mais sobre o desenvolvimento de plug-in de gateway no Windows Admin Center.

Extensões disponíveis na instalação

As extensões não incluídas no instalador do Windows Admin Center, incluindo extensões de parceiro externo, não estão disponíveis, a menos que você as adicione usando um feed de extensão.

Ao instalar o Windows Admin Center, você obtém as seguintes extensões:

• Aplicativos & recursos
• Backup do Azure
• Sincronização de Arquivos do Azure
• Centro híbrido do Azure
• Serviço de Kubernetes do Azure
• Certificados
• Criação de cluster
• Gerenciador de Cluster
• Guia do desenvolvedor
• Dispositivos
• Eventos
• Ferramentas de cluster de failover
• Arquivos & compartilhamento de arquivos
• Firewall
• Usuários e grupos locais
• Ferramentas do Controlador de Rede e redes virtuais do SDN
• Redes
• Monitoramento de pacotes
• Monitor de Desempenho
• PowerShell
• Processes
• Registry
• Área de Trabalho Remota
• Funções & recursos
• Tarefas agendadas
• Conexões do Gateway de SDN
• Infraestrutura do SDN
• Redes lógicas do SDN
• Grupos de segurança de rede do SDN
• Segurança
• Gerenciador de Servidores e Gerenciamento de Computadores
• Services
• Armazenamento
• Serviço de Migração de Armazenamento
• Storage Replica
• Insights sobre o Sistema
• Atualizações
• Máquinas virtuais e comutadores