Compartilhar via

Instalar o PowerShell no Windows

Há várias maneiras de instalar o PowerShell no Windows. Cada método de instalação é projetado para funcionar em diferentes cenários e fluxos de trabalho. Escolha o tipo de instalação mais adequado às suas necessidades.

  • WinGet – maneira recomendada de instalar o PowerShell em clientes Windows.
  • Pacote MSI – Melhor opção para servidores Windows e cenários de implantação empresarial.
  • Pacote ZIP – maneira mais fácil de carregar ou instalar várias versões
    • Use esse método para Windows Nano Server, Windows IoT e sistemas baseados em ARM
  • Ferramenta global do .NET – uma boa opção para desenvolvedores do .NET que instalam e usam outras ferramentas globais.
  • Pacote da Microsoft Store – um jeito fácil de instalar para usuários casuais do PowerShell, mas tem limitações.

O PowerShell 7 é instalado em um novo diretório e é executado lado a lado com o Windows PowerShell 5.1. As versões mais recentes do PowerShell 7 substituem as versões anteriores existentes do PowerShell 7. Versões prévias do PowerShell podem ser instaladas juntamente com outras versões do PowerShell. Versões de visualização mais recentes substituem as versões prévias anteriores existentes.

O PowerShell 7 dá suporte a atualizações por meio do Microsoft Update. Ao habilitar esse recurso, você receberá as atualizações mais recentes do PowerShell 7 em seu fluxo de gerenciamento tradicional do MICROSOFT Update (MU), seja com o Windows Update para Empresas, WSUS, Microsoft Endpoint Configuration Manager ou a caixa de diálogo MU interativa em Configurações.

Para saber mais, confira as Perguntas frequentes sobre o Microsoft Update para PowerShell.

O WinGet, o Gerenciador de Pacotes do Windows, é uma ferramenta de linha de comando que permite que os usuários descubram, instalem, atualizem, removam e configurem aplicativos em computadores cliente Windows. Essa ferramenta é a interface do cliente para o serviço Gerenciador de Pacotes do Windows. A ferramenta de linha de comando winget vem no pacote do Windows 11 e das versões modernas do Windows 10 por padrão como o Instalador de Aplicativo.

Observação

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

Os seguintes comandos podem ser usados para instalar o PowerShell com os pacotes do winget publicados:

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 a versão prévia do PowerShell com o parâmetro --id

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

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

Observação

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

Instalar o pacote MSI

Para instalar o PowerShell no Windows, use os links a seguir para baixar o pacote de instalação do GitHub.

Versão estável mais recente:

Versão prévia mais recente:

Após o download, clique duas vezes no arquivo de instalação 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
    • O local de instalação é adicionado à variável de $Env:PATH ambiente
  • Versões prévias 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 em uma pasta diferente.

Instalar o pacote MSI da linha de comando

É possível instalar os pacotes MSI por 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 - Essa propriedade tem dois valores possíveis:

    • 1 (padrão) – opta por atualizar por meio do Microsoft Update, do WSUS ou do Configuration Manager
    • 0 – Não aceitar atualizar por meio do Microsoft Update, do WSUS ou do Configuration Manager

  • ENABLE_MU

    • 1 (padrão) – opta por usar o Microsoft Update para Atualizações Automáticas

    • 0 – Não aceitar usar o Microsoft Update

      Observação

      A habilitação de atualizações pode ter sido definida em uma instalação anterior ou por meio de configuração manual. Usar ENABLE_MU=0 não remove as configurações existentes. Além disso, essa configuração pode ser substituída por configurações de Política de Grupo controladas pelo administrador.

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

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

  • ENABLE_PSREMOTING – Esta propriedade controla a opção para habilitar a comunicação remota do PowerShell durante a instalação.

  • REGISTER_MANIFEST – Esta propriedade controla a opção para registrar o manifesto de Registro de Eventos do Windows.

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

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

  • INSTALLFOLDER - Essa propriedade controla o diretório de instalação. O padrão é $Env:ProgramFiles\PowerShell\. Esse é o local em que o instalador cria a subpasta versionada. Não é possível alterar o nome da subpasta versionada.

    • Para versões atuais, a subpasta com versão é 7
    • Para versões anteriores, a subpasta com versão é 7-preview

Os exemplos a seguir mostram 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

Confira a lista completa das opções de linha de comando para Msiexec.exe em Opções de linha de comando.

Instalar a partir do pacote ZIP

Arquivos ZIP binários do PowerShell são fornecidos para habilitar cenários avançados de implantação. Baixe um dos arquivos ZIP a seguir da página da versão atual.

Dependendo de como você baixar o arquivo, poderá ser necessário desbloqueá-lo usando o cmdlet Unblock-File. Descompacte o conteúdo para o local de sua escolha e execute pwsh.exe a partir daí. Ao contrário da instalação de pacotes MSI, a instalação do arquivo ZIP não verifica os pré-requisitos. Para que a comunicação remota pelo WSMan funcione corretamente, certifique-se de atender 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 $Env:ProgramFiles\PowerShell\7.

Instalar como uma ferramenta global do .NET

Se você já tiver o SDK do .NET Core instalado, poderá instalar o PowerShell como uma ferramenta global do .NET.

dotnet tool install --global PowerShell

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

Instalar da Microsoft Store

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

Benefícios do pacote da Microsoft Store:

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

Limitações conhecidas

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

Essa área restrita bloqueia todas as alterações na pasta raiz do aplicativo. Nenhuma definição de configuração no nível do sistema armazenada em $PSHOME pode ser modificada. Isso inclui a configuração do WSMAN. Isso impede que as sessões remotas se conectem a instalações baseadas na Store do PowerShell. Há suporte para configurações no nível do usuário e para comunicação remota SSH.

Os comandos a seguir precisam ser escritos em $PSHOME. Esses comandos não têm suporte em uma instância da Microsoft Store do PowerShell.

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

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

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

Importante

Você precisa 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 ao instalar o PowerShell pela primeira vez. Se você não tiver certeza de como o PowerShell foi instalado, poderá verificar o valor da variável $PSHOME, que sempre aponta para o diretório que contém o PowerShell que a sessão atual está em execução.

  • Se o valor for $HOME\.dotnet\tools, o PowerShell foi instalado com a ferramenta global do .NET.
  • 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 da Microsoft Store ou com WinGet em um computador com processador ARM.
  • Se o valor for qualquer outra coisa, é provável que o PowerShell tenha sido instalado como um pacote ZIP.

Se você tiver instalado por meio do pacote MSI, essas informações também aparecerão 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 indicará 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 desinstalação do PowerShell 7 depende do método de instalação usado.

  • Se você instalou o PowerShell usando o WinGet, execute o seguinte comando:

    winget uninstall --id Microsoft.PowerShell

  • Se você instalou o PowerShell usando o pacote MSI, poderá desinstalá-lo no Painel de Controle de Programas e Recursos .

  • Se você instalou o PowerShell usando o pacote ZIP, exclua a pasta na qual descompactou os arquivos.

  • Se você instalou o PowerShell na Microsoft Store, abra o menu Iniciar e pesquise PowerShell 7. Selecione Desinstalar no menu de opções.

  • Se você instalou o PowerShell como uma ferramenta global do .NET, execute o seguinte comando:

    dotnet tool uninstall --global PowerShell

Versões com suporte do Windows

A Microsoft dá suporte ao PowerShell até que o PowerShell chegue ao fim do suporte ou a versão do Windows chegue ao 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 Registro de Artefatos da Microsoft.

Essas 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, a fim de garantir que as atualizações de segurança mais recentes sejam aplicadas.

Essas imagens são fornecidas para fins de teste. Se você precisar de uma imagem do Docker para uma carga de trabalho de produção, deverá criar e manter a sua própria.

Observação

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

Você pode verificar qual versão está usando ao executar winver.exe.

Suporte à instalação

A Microsoft dá suporte aos 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 dar 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 de que você precisa. 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 são encontrados na seção Recursos da página de lançamento. A seção Ativos pode estar recolhida e, portanto, talvez você precise clicar para expandi-la.

  • Last updated on