Instalar e gerenciar extensões

O Windows Admin Center é uma plataforma extensível onde cada tipo de ligação e ferramenta é uma extensão que 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 Definiçõ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 visualizar a descrição da extensão, versão, editora e outras informações no painel de 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. Pode adicionar qualquer feed NuGet que suporte as APIs NuGet V2 ou uma partilha de ficheiros ao Centro de Administração do Windows para instalar extensões.

1. Selecione o botão Definiçõ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. Se adicionar uma partilha de ficheiros como feed, deve cumprir os seguintes critérios:
   • NTAuthority\Network Service deve ter acesso ao ficheiro
   • 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ó aparece se estiveres a usar o Windows Admin Center em modo ambiente de trabalho.

A lista Extensões disponíveis mostra extensões de todos os feeds registrados. Pode verificar a que feed pertence cada extensão usando a coluna Package Feed.

Desinstalar uma extensão

Podes desinstalar quaisquer extensões que tenhas instalado anteriormente, ou até desinstalar quaisquer ferramentas que já estivessem pré-instaladas como parte da instalação do Centro de Administração do Windows.

1. Selecione o botão Definiçõ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. Escolhe uma extensão para desinstalar e depois seleciona Desinstalar.

Depois de terminar o processo de desinstalação, o seu navegador atualiza automaticamente e o Centro de Administração do Windows recarrega com a extensão removida. Se desinstalaste uma ferramenta que estava pré-instalada no Centro de Administração do Windows, podes reinstalar a ferramenta no separador Extensões Disponíveis .

Instale extensões num computador sem ligação à internet

Se instalares o Windows Admin Center num computador que não está ligado à internet ou que está atrás de um proxy, pode não conseguir aceder e instalar as extensões a partir do feed do Windows Admin Center. Pode descarregar pacotes de extensões manualmente ou usando um script PowerShell, e configurar o Windows Admin Center para recuperar pacotes de uma partilha de ficheiros ou disco local.

Descarregar manualmente pacotes de extensões

1. Noutro computador com ligação à internet, abra um navegador web e aceda ao seguinte URL: https://dev.azure.com/WindowsAdminCenter/Windows%20Admin%20Center%20Feed/_artifacts/feed/wac-public-extensions

   Pode ser necessário criar uma conta Microsoft e iniciar sessão para visualizar 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 de download na barra de navegação superior da página de detalhes do pacote e descarregue o .nupkg ficheiro da extensão.

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

5. Copie os ficheiros do pacote para uma partilha de ficheiros que possa aceder a partir do computador onde instalou o Centro de Administração do Windows, ou para o disco local do computador onde instalou o Centro de Administração do Windows.

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

Baixando pacotes com um script do PowerShell

Podes encontrar scripts na internet para descarregar pacotes NuGet a partir de um feed NuGet. Utilize o guião fornecido por Jon Galloway, Gestor Sénior de Programas na 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/wac-public-extensions"
   

3. Executa o script. Descarrega 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 plug-in do gateway do Windows Admin Center são as mais afetadas pelas alterações ao 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. Pode estender o serviço gateway para incluir plug-ins personalizados que suportem protocolos diferentes dos predefinidos (PowerShell e WMI).

Como os plug-ins gateway comunicam com o backend do Windows Admin Center para permitir a comunicação com API, o código dos plug-ins gateway pode incluir componentes escritos com a versão 4.6.2 do .NET Framework, que não funcionam com .NET 8.

Além disso, a forma como funcionam os plug-ins mudou com a versão 2410. Em vez de desenvolver uma classe C# que implemente a IPlugIn interface do Microsoft.ManagementExperience.FeatureInterfaces namespace para estender o plug-in gateway, agora escreve extensões sob a 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 disponíveis na instalação

Extensões não incluídas no instalador do Centro de Administração do Windows, incluindo extensões de parceiros externos, não estão disponíveis a menos que as adicione utilizando um feed de extensões.

Quando instala o Centro de Administração do Windows, recebe as seguintes extensões:

• 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