Partilhar via

Instalar o PowerShell no Windows

Há várias maneiras de instalar o PowerShell no Windows. Cada método de instalação é projetado para suportar diferentes cenários e fluxos de trabalho. Escolha o método que melhor se adapta às suas necessidades.

  • WinGet - Maneira recomendada de instalar o PowerShell em clientes Windows
  • Pacote MSI - Melhor escolha para servidores Windows e cenários de implantação corporativa
  • Pacote ZIP - Forma mais fácil de fazer sideload ou instalar várias versões
    • Use este método para Windows Nano Server, Windows IoT e sistemas baseados em Arm
  • Ferramenta Global .NET - Uma boa opção para desenvolvedores .NET que instalam e usam outras ferramentas globais
  • Pacote da Microsoft Store - Uma maneira fácil de instalar para usuários casuais do PowerShell, mas com limitações

O PowerShell 7 instala-se numa nova pasta e corre lado a lado com o Windows PowerShell 5.1. Versões mais recentes do PowerShell 7 substituem versões anteriores existentes do PowerShell 7. As versões de visualização do PowerShell podem ser instaladas lado a lado com outras versões do PowerShell. As versões de pré-visualização mais recentes substituem as versões anteriores existentes.

O PowerShell 7 suporta atualizações através do Microsoft Update. Ao ativar esta funcionalidade, recebe as últimas atualizações do PowerShell 7 no seu fluxo tradicional de gestão Microsoft Update (MU), seja através do Windows Update for Business, WSUS, Microsoft Endpoint Configuration Manager ou o diálogo interativo MU nas Definições.

Para obter mais informações, consulte as Perguntas frequentes do PowerShell Microsoft Update.

WinGet, o Gestor de Pacotes do Windows, é uma ferramenta de linha de comandos que permite aos utilizadores descobrir, instalar, atualizar, remover e configurar aplicações em computadores clientes Windows. Esta ferramenta é a interface do cliente para o serviço Gerenciador de Pacotes do Windows. A winget ferramenta de linha de comando é fornecida com o Windows 11 e versões modernas do Windows 10 por padrão como o App Installer.

Observação

Consulte a documentação do winget para obter uma lista de requisitos do sistema e instruções de instalação. winget não está disponível no Windows Server 2022 ou em versões anteriores. O Windows Server 2025 inclui winget apenas para Windows Server com Experiência de Ambiente de Trabalho .

Os comandos a seguir podem ser usados para instalar o PowerShell usando os pacotes publicados winget :

Pesquisar a versão mais recente do PowerShell

winget search --id Microsoft.PowerShell

Name               Id                           Version Source
---------------------------------------------------------------
PowerShell         Microsoft.PowerShell         7.5.4.0 winget
PowerShell Preview Microsoft.PowerShell.Preview 7.6.0.5 winget

Instalar o PowerShell ou o PowerShell Preview usando o --id parâmetro

winget install --id Microsoft.PowerShell --source winget

winget install --id Microsoft.PowerShell.Preview --source winget

Observação

Em sistemas Windows que usam o processador X86 ou X64, winget instala o pacote MSI. Em sistemas que usam o processador Arm64, winget instala o pacote da Microsoft Store (MSIX).

Instale o pacote MSI

Para instalar o PowerShell no Windows, utilize os seguintes links para descarregar o pacote de instalação do GitHub.

Última versão estável:

Última versão de pré-visualização:

Uma vez baixado, clique duas vezes no arquivo do instalador e siga as instruções.

O instalador cria um atalho no Menu Iniciar do Windows.

  • Por padrão, o pacote é instalado em $Env:ProgramFiles\PowerShell\7
    • A localização de instalação é adicionada à variável de ambiente $Env:PATH
  • Versões pré-visualizadas da instalação do PowerShell 7 para $Env:ProgramFiles\PowerShell\7-preview
  • Você pode iniciar o PowerShell por meio do Menu Iniciar ou $Env:ProgramFiles\PowerShell\7\pwsh.exe

Observação

Para executar o PowerShell 7.5 lado a lado com outras versões do PowerShell 7, use o método de instalação ZIP para instalar a outra versão numa pasta diferente.

Instalar o pacote MSI a partir da linha de comando

Os pacotes MSI podem ser instalados a partir da linha de comando, permitindo que os administradores implantem pacotes sem interação do usuário. O pacote MSI inclui as seguintes propriedades para controlar as opções de instalação:

  • USE_MU - Esta propriedade tem dois valores possíveis:

    • 1 (padrão) - Opta pela atualização por meio do Microsoft Update, WSUS ou Configuration Manager
    • 0 - Não opte por atualizar através do Microsoft Update, WSUS ou Configuration Manager

  • ENABLE_MU

    • 1 (padrão) - Opta por usar o Microsoft Update para atualizações automáticas

    • 0 - Não opte por usar o Microsoft Update

      Observação

      A ativação de atualizações pode ter sido definida em uma instalação anterior ou configuração manual. Usar ENABLE_MU=0 não remove as configurações existentes. Além disso, essa configuração pode ser anulada pelas configurações de Diretiva de Grupo controladas pelo administrador.

  • ADD_EXPLORER_CONTEXT_MENU_OPENPOWERSHELL - Esta propriedade controla a opção para adicionar o Open PowerShell item ao menu de contexto no Windows Explorer.

  • ADD_FILE_CONTEXT_MENU_RUNPOWERSHELL - Esta propriedade controla a opção para adicionar o Run with PowerShell item ao menu de contexto no Windows Explorer.

  • ENABLE_PSREMOTING - Esta propriedade controla a opção para a ativação da comunicação remota do PowerShell durante a instalação.

  • REGISTER_MANIFEST - Esta propriedade controla a opção para registar o manifesto de Registo de Eventos do Windows.

  • ADD_PATH - Esta propriedade controla a opção para adicionar o PowerShell à variável de ambiente PATH do Windows.

  • DISABLE_TELEMETRY - Esta propriedade controla a opção para desabilitar a telemetria do PowerShell definindo a POWERSHELL_TELEMETRY_OPTOUT variável de ambiente.

  • INSTALLFOLDER - Esta propriedade controla o diretório de instalação. A predefinição é $Env:ProgramFiles\PowerShell\. Este é o local onde o instalador cria a subpasta versionada. Não é possível alterar o nome da subpasta versionada.

    • Para versões atuais, a subpasta versionada é 7
    • Para versões preliminares, o subdiretório versionado é 7-preview

O exemplo a seguir mostra como instalar silenciosamente o PowerShell com todas as opções de instalação habilitadas.

msiexec.exe /package PowerShell-7.5.4-win-x64.msi /quiet ADD_EXPLORER_CONTEXT_MENU_OPENPOWERSHELL=1 ADD_FILE_CONTEXT_MENU_RUNPOWERSHELL=1 ENABLE_PSREMOTING=1 REGISTER_MANIFEST=1 USE_MU=1 ENABLE_MU=1 ADD_PATH=1

Para obter uma lista completa de opções de linha de comando para Msiexec.exe, consulte Opções de linha de comando.

Instalar a partir do pacote ZIP

São fornecidos arquivos binários ZIP do PowerShell para permitir cenários avançados de implementação. Faça o download de um dos seguintes arquivos ZIP da página da versão atual do.

Dependendo de como você baixar o arquivo, talvez seja necessário desbloqueá-lo usando o Unblock-File cmdlet. Descompacte o conteúdo para o local de sua escolha e execute pwsh.exe a partir desse local. Ao contrário da instalação dos pacotes MSI, a instalação do arquivo ZIP não verifica os pré-requisitos. Para que a comunicação remota no WSMan funcione corretamente, verifique se você atendeu aos pré-requisitos.

Use esse método para instalar a versão baseada em ARM do PowerShell em computadores como o Microsoft Surface Pro X. Para obter melhores resultados, instale o PowerShell na pasta para $Env:ProgramFiles\PowerShell\7 .

Instalar como uma ferramenta global do .NET

Se já tiver instalado o .NET Core SDK , pode instalar o PowerShell como uma ferramenta .NET Global.

dotnet tool install --global PowerShell

O instalador da ferramenta dotnet adiciona $HOME\.dotnet\tools à sua $Env:PATH variável de ambiente. No entanto, o shell em execução no momento não tem o $Env:PATH atualizado. Você pode iniciar o PowerShell a partir de um novo shell digitando pwsh.

Instalar a partir da Microsoft Store

O PowerShell pode ser instalado a partir da Microsoft Store. Você pode encontrar a versão do PowerShell no site da Microsoft Store ou no aplicativo Store no Windows.

Benefícios do pacote da Microsoft Store:

  • Atualizações automáticas incorporadas no Windows
  • Integra-se com outros mecanismos de distribuição de software, como o Intune e o Configuration Manager
  • Pode instalar em sistemas Windows usando processadores x86, x64 ou Arm64

Limitações conhecidas

Por padrão, os pacotes da Windows Store são executados em uma área restrita de aplicativos que virtualiza o acesso a alguns locais do sistema de arquivos e do Registro. As alterações nos locais de arquivo e registro virtualizados não persistem fora da área restrita do aplicativo.

Esta área restrita bloqueia todas as alterações na pasta raiz do aplicativo. As definições de configuração ao nível do sistema armazenadas em $PSHOME não podem ser modificadas. Isso inclui a configuração WSMAN. Isso impede que sessões remotas se conectem a instalações do PowerShell baseadas em Loja. Configurações de nível de usuário e comunicação remota SSH são suportadas.

Os comandos a seguir precisam ser gravados em $PSHOME. Esses comandos não são suportados em uma instância do PowerShell da Microsoft Store.

  • Register-PSSessionConfiguration
  • Update-Help -Scope AllUsers
  • Enable-ExperimentalFeature -Scope AllUsers
  • Set-ExecutionPolicy -Scope LocalMachine

Para obter mais informações, consulte Noções básicas sobre como os pacotes de aplicativos da área de trabalho são executados no Windows.

A partir do PowerShell 7.2, o pacote do PowerShell agora está isento da virtualização de arquivos e registros. As alterações nos locais de arquivo e registro virtualizados agora persistem fora da área restrita do aplicativo. No entanto, as alterações na pasta raiz do aplicativo ainda estão bloqueadas.

Importante

Você deve estar executando no Windows build 1903 ou superior para que essa isenção funcione.

Atualizar uma instalação existente

Para obter melhores resultados ao atualizar, você deve usar o mesmo método de instalação usado quando instalou o PowerShell pela primeira vez. Se não tiver certeza de como o PowerShell foi instalado, você pode verificar o $PSHOME valor da variável, que sempre aponta para o diretório que contém o PowerShell que a sessão atual está executando.

  • Se o valor for $HOME\.dotnet\tools, o PowerShell foi instalado com a ferramenta .NET Global.
  • Se o valor for $Env:ProgramFiles\PowerShell\7, o PowerShell foi instalado como um pacote MSI ou com WinGet em um computador com um processador X86 ou x64.
  • Se o valor começar com $Env:ProgramFiles\WindowsApps\, o PowerShell foi instalado como um pacote Microsoft Store ou com WinGet no computador com um processador ARM.
  • Se o valor for qualquer outra coisa, é provável que o PowerShell tenha sido instalado como um pacote ZIP.

Se você instalou através do pacote MSI, essas informações também aparecem no Painel de Controle de Programas e Recursos .

Para determinar se o PowerShell pode ser atualizado com o WinGet, execute o seguinte comando:

winget list --id Microsoft.PowerShell --upgrade-available

Se houver uma atualização disponível, a saída indica a versão mais recente disponível. Use o seguinte comando para atualizar o PowerShell usando o WinGet:

winget upgrade --id Microsoft.PowerShell

Desinstalar o PowerShell 7

O processo de desinstalar o PowerShell 7 depende do método de instalação que usaste.

  • Se instalaste o PowerShell usando WinGet, executa o seguinte comando:

    winget uninstall --id Microsoft.PowerShell

  • Se instalaste o PowerShell usando o pacote MSI, podes desinstalá-lo no Painel de Controlo de Programas e Funcionalidades .

  • Se instalaste o PowerShell usando o pacote ZIP, apaga a pasta onde descomprimiste os ficheiros.

  • Se instalaste o PowerShell na Microsoft Store, abre o menu Iniciar e procura por PowerShell 7. Selecione Desinstalar no menu de opções.

  • Se instalou o PowerShell como uma ferramenta .NET Global, execute o seguinte comando:

    dotnet tool uninstall --global PowerShell

Versões suportadas do Windows

A Microsoft oferece suporte ao PowerShell até que o PowerShell atinja o fim do suporte ou a versão do Windows atinja o fim do suporte.

As imagens do Docker para o SDK do .NET contêm as versões mais recentes do PowerShell. Essas imagens estão disponíveis no Microsoft Artifact Registry.

Estas imagens podem não ter as atualizações de segurança mais recentes. A Microsoft recomenda que você atualize os pacotes do sistema operacional para a versão mais recente para garantir que as atualizações de segurança mais recentes sejam aplicadas.

Estas imagens são fornecidas para fins de teste. Se você precisar de uma imagem do Docker para uma carga de trabalho de produção, crie e mantenha a sua própria.

Observação

O suporte para uma versão específica do Windows é determinado pelas políticas de ciclo de vida do suporte da Microsoft. Para obter mais informações, consulte:

Você pode verificar a versão que você está usando executando winver.exe.

Suporte à instalação

A Microsoft suporta os métodos de instalação neste documento. Pode haver outros métodos de instalação de terceiros disponíveis de outras fontes. Embora essas ferramentas e métodos possam funcionar, a Microsoft não pode oferecer suporte a esses métodos.

Observação

Os comandos de instalação neste artigo são para a versão estável mais recente do PowerShell. Para instalar uma versão diferente do PowerShell, ajuste o comando para corresponder à versão necessária. Os links a seguir direcionam você para a página de lançamento mais recente para cada versão no GitHub.

Os links de download para cada pacote encontram-se na secção Recursos da página de lançamento. A seção Ativos pode estar fechada, portanto, talvez seja necessário clicar em "expandir".

  • Last updated on