Instalar o PowerShell no WindowsInstalling PowerShell on Windows

Há várias maneiras de instalar o PowerShell no Windows.There are multiple ways to install PowerShell in Windows.

Pré-requisitosPrerequisites

A versão mais recente do PowerShell tem suporte no Windows 7 SP1, Server 2008 R2 e versões posteriores.The latest release of PowerShell is supported on Windows 7 SP1, Server 2008 R2, and later versions.

Para habilitar a comunicação remota do PowerShell pelo WSMan, os pré-requisitos a seguir precisam ser atendidos:To enable PowerShell remoting over WSMan, the following prerequisites need to be met:

  • Instale o Universal C Runtime em versões do Windows anteriores ao Windows 10.Install the Universal C Runtime on Windows versions predating Windows 10. Ele está disponível por meio do Windows Update ou de download direto.It's available via direct download or Windows Update. Os sistemas totalmente corrigidos já têm esse pacote instalado.Fully patched systems already have this package installed.
  • Instale o Windows Management Framework (WMF) 4.0 ou mais recente no Windows 7 e no Windows Server 2008 R2.Install the Windows Management Framework (WMF) 4.0 or newer on Windows 7 and Windows Server 2008 R2. Saiba mais sobre o WMF em Visão geral do WMF.For more information about WMF, see WMF Overview.

Baixar o pacote do instaladorDownload the installer package

Para instalar o PowerShell no Windows, baixe o pacote de instalação mais recente no GitHub.To install PowerShell on Windows, download the latest install package from GitHub. Você também pode encontrar a versão prévia mais recente na página de versões.You can also find the latest preview version on the releases page. Role a tela para baixo até a seção Ativos na página de Lançamentos.Scroll down to the Assets section of the Release page. A seção Ativos pode estar recolhida e, portanto, talvez você precise clicar para expandi-la.The Assets section may be collapsed, so you may need to click to expand it.

Instalando o pacote MSIInstalling the MSI package

O arquivo MSI tem esta aparência PowerShell-<version>-win-<os-arch>.msi.The MSI file looks like PowerShell-<version>-win-<os-arch>.msi. Por exemplo: For example:

  • PowerShell-7.0.3-win-x64.msi
  • PowerShell-7.0.3-win-x86.msi

Após o download, clique duas vezes no instalador e siga os prompts.Once downloaded, double-click the installer and follow the prompts.

O instalador cria um atalho no Menu Iniciar do Windows.The installer creates a shortcut in the Windows Start Menu.

  • Por padrão, o pacote é instalado em $env:ProgramFiles\PowerShell\<version>By default the package is installed to $env:ProgramFiles\PowerShell\<version>
  • Você pode iniciar o PowerShell por meio do Menu Iniciar ou $env:ProgramFiles\PowerShell\<version>\pwsh.exeYou can launch PowerShell via the Start Menu or $env:ProgramFiles\PowerShell\<version>\pwsh.exe

Observação

O PowerShell 7 é instalado em um novo diretório e executado lado a lado com o Windows PowerShell 5.1.PowerShell 7 installs to a new directory and runs side-by-side with Windows PowerShell 5.1. Para o PowerShell Core 6.x, o PowerShell 7 é uma atualização in-loco que remove o PowerShell Core 6.x.For PowerShell Core 6.x, PowerShell 7 is an in-place upgrade that removes PowerShell Core 6.x.

  • O PowerShell 7 é instalado em $env:ProgramFiles\PowerShell\7PowerShell 7 is installed to $env:ProgramFiles\PowerShell\7
  • A pasta $env:ProgramFiles\PowerShell\7 é adicionada ao $env:PATHThe $env:ProgramFiles\PowerShell\7 folder is added to $env:PATH
  • A pasta $env:ProgramFiles\PowerShell\6 é excluídaThe $env:ProgramFiles\PowerShell\6 folder is deleted

Se você precisar executar o PowerShell 6 lado a lado com o PowerShell 7, reinstale o PowerShell 6 usando o método de instalação por ZIP.If you need to run PowerShell 6 side-by-side with PowerShell 7, reinstall PowerShell 6 using the ZIP install method.

Instalação administrativa a partir da linha de comandoAdministrative install from the command line

É possível instalar os pacotes MSI por linha de comando, permitindo que os administradores implantem pacotes sem interação do usuário.MSI packages can be installed from the command line allowing administrators to deploy packages without user interaction. O pacote MSI inclui as seguintes propriedades para controlar as opções de instalação:The MSI package includes the following properties to control the installation options:

  • ADD_EXPLORER_CONTEXT_MENU_OPENPOWERSHELL – Esta propriedade controla a opção de adicionar o item Abrir o PowerShell ao menu de contexto no Windows Explorer.ADD_EXPLORER_CONTEXT_MENU_OPENPOWERSHELL - This property controls the option for adding the Open PowerShell item to the context menu in Windows Explorer.
  • ENABLE_PSREMOTING – Esta propriedade controla a opção para habilitar a comunicação remota do PowerShell durante a instalação.ENABLE_PSREMOTING - This property controls the option for enabling PowerShell remoting during installation.
  • REGISTER_MANIFEST – Esta propriedade controla a opção para registrar o manifesto do Log de eventos do Windows.REGISTER_MANIFEST - This property controls the option for registering the Windows Event Logging manifest.

Os exemplos a seguir mostram como instalar silenciosamente o PowerShell com todas as opções de instalação habilitadas.The following example shows how to silently install PowerShell with all the install options enabled.

msiexec.exe /package PowerShell-7.0.3-win-x64.msi /quiet ADD_EXPLORER_CONTEXT_MENU_OPENPOWERSHELL=1 ENABLE_PSREMOTING=1 REGISTER_MANIFEST=1

Confira a lista completa das opções de linha de comando para Msiexec.exe em Opções de linha de comando.For a full list of command-line options for Msiexec.exe, see Command line options.

Chaves do Registro criadas durante a instalaçãoRegistry keys created during installation

A partir do PowerShell 7.1, o pacote MSI cria chaves do Registro que armazenam o local de instalação e a versão do PowerShell.Beginning in PowerShell 7.1, the MSI package creates registry keys that store the installation location and version of PowerShell. Esses valores estão localizados em HKLM\Software\Microsoft\PowerShellCore\InstalledVersions\<GUID>.These values are located in HKLM\Software\Microsoft\PowerShellCore\InstalledVersions\<GUID>. O valor de <GUID> é único para cada tipo de build (versão ou versão prévia), versão principal e arquitetura.The value of <GUID> is unique for each build type (release or preview), major version, and architecture.

VersãoRelease ArquiteturaArchitecture Chave do RegistroRegistry Key
Versão 7.1.x7.1.x Release x86x86 HKLM\Software\Microsoft\PowerShellCore\InstalledVersions\1d00683b-0f84-4db8-a64f-2f98ad42fe06
Versão 7.1.x7.1.x Release x64x64 HKLM\Software\Microsoft\PowerShellCore\InstalledVersions\31ab5147-9a97-4452-8443-d9709f0516e1
Versão 7.1.x7.1.x Preview x86x86 HKLM\Software\Microsoft\PowerShellCore\InstalledVersions\86abcfbd-1ccc-4a88-b8b2-0facfde29094
Versão 7.1.x7.1.x Preview x64x64 HKLM\Software\Microsoft\PowerShellCore\InstalledVersions\39243d76-adaf-42b1-94fb-16ecf83237c8

Isso pode ser usado por administradores e desenvolvedores para encontrar o caminho para o PowerShell.This can be used by administrators and developers to find the path to PowerShell. Os valores de <GUID> serão os mesmos em todas as versões prévias e secundárias.The <GUID> values will be the same for all preview and minor version releases. Os valores de <GUID> são alterados em cada versão principal.The <GUID> values are changed for each major release.

Instalação do pacote MSIXInstalling the MSIX package

Observação

No momento, o pacote MSIX não tem suporte oficial.The MSIX package is not officially supported at this time. Continuamos a criar o pacote apenas para fins de teste interno.We continue to build the package for internal testing purposes only.

Para instalar manualmente o pacote MSIX em um cliente do Windows 10, baixe o pacote MSIX na nossa página de versões do GitHub.To manually install the MSIX package on a Windows 10 client, download the MSIX package from our GitHub releases page. Role a tela até a seção Ativos da versão que você deseja instalar.Scroll down to the Assets section of the Release you want to install. A seção Ativos pode estar recolhida e, portanto, talvez você precise clicar para expandi-la.The Assets section may be collapsed, so you may need to click to expand it.

O arquivo MSIX tem esta aparência – PowerShell-<version>-win-<os-arch>.msixThe MSIX file looks like this - PowerShell-<version>-win-<os-arch>.msix

Para instalar o pacote, você deve usar o cmdlet Add-AppxPackage.To install the package, you must use the Add-AppxPackage cmdlet.

Add-AppxPackage PowerShell-<version>-win-<os-arch>.msix

Instalando o pacote ZIPInstalling the ZIP package

Arquivos binários de ZIP do PowerShell são fornecidos para habilitar cenários de implantação avançada.PowerShell binary ZIP archives are provided to enable advanced deployment scenarios. Baixe um dos seguintes arquivos ZIP da página de versões.Download one of the following ZIP archives from the releases page.

  • PowerShell-7.0.3-win-x64.zipPowerShell-7.0.3-win-x64.zip
  • PowerShell-7.0.3-win-x86.zipPowerShell-7.0.3-win-x86.zip
  • PowerShell-7.0.3-win-arm64.zipPowerShell-7.0.3-win-arm64.zip
  • PowerShell-7.0.3-win-arm32.zipPowerShell-7.0.3-win-arm32.zip

Dependendo de como você baixar o arquivo, poderá ser necessário desbloqueá-lo usando o cmdlet Unblock-File.Depending on how you download the file you may need to unblock the file using the Unblock-File cmdlet. Descompacte o conteúdo para o local de sua escolha e execute pwsh.exe desse local.Unzip the contents to the location of your choice and run pwsh.exe from there. Ao contrário da instalação de pacotes MSI, a instalação do arquivo ZIP não verifica os pré-requisitos.Unlike installing the MSI packages, installing the ZIP archive doesn't check for prerequisites. Para que a comunicação remota pelo WSMan funcione corretamente, certifique-se de atender aos pré-requisitos.For remoting over WSMan to work properly, ensure that you've met the prerequisites.

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.Use this method to install the ARM-based version of PowerShell on computers like the Microsoft Surface Pro X. For best results, install PowerShell to the to $env:ProgramFiles\PowerShell\7 folder.

Implantar no Windows 10 IoT EnterpriseDeploying on Windows 10 IoT Enterprise

O Windows 10 IoT Enterprise vem com o Windows PowerShell, que pode ser usado para implantar o PowerShell 7.Windows 10 IoT Enterprise comes with Windows PowerShell, which we can use to deploy PowerShell 7.

  1. Crie PSSession no dispositivo de destinoCreate PSSession to target device

    Set-Item -Path WSMan:\localhost\Client\TrustedHosts <deviceip>
    $S = New-PSSession -ComputerName <deviceIp> -Credential Administrator
    
  2. Copie o pacote ZIP no dispositivoCopy the ZIP package to the device

    # change the destination to however you had partitioned it with sufficient
    # space for the zip and the unzipped contents
    # the path should be local to the device
    Copy-Item .\PowerShell-<version>-win-<os-arch>.zip -Destination u:\users\administrator\Downloads -ToSession $s
    
  3. Conecte-se ao dispositivo e expanda o arquivoConnect to the device and expand the archive

    Enter-PSSession $s
    Set-Location u:\users\administrator\downloads
    Expand-Archive .\PowerShell-<version>-win-<os-arch>.zip
    
  4. Configure a comunicação remota no PowerShell 7Set up remoting to PowerShell 7

    Set-Location .\PowerShell-<version>-win-<os-arch>
    # Be sure to use the -PowerShellHome parameter otherwise it'll try to create a new
    # endpoint with Windows PowerShell 5.1
    .\Install-PowerShellRemoting.ps1 -PowerShellHome .
    # You'll get an error message and will be disconnected from the device because
    # it has to restart WinRM
    
  5. Conectar-se ao ponto de extremidade do PowerShell 7 no dispositivoConnect to PowerShell 7 endpoint on device

    # Be sure to use the -Configuration parameter. If you omit it, you will connect to Windows PowerShell 5.1
    Enter-PSSession -ComputerName <deviceIp> -Credential Administrator -Configuration powershell.<version>
    

Implantar no Windows 10 IoT CoreDeploying on Windows 10 IoT Core

O Windows 10 IoT Core adiciona o Windows PowerShell quando você inclui o recurso IOT_POWERSHELL , que pode ser usado para implantar o PowerShell 7.Windows 10 IoT Core adds Windows PowerShell when you include IOT_POWERSHELL feature, which we can use to deploy PowerShell 7. As etapas definidas acima para o Windows 10 IoT Enterprise também podem ser seguidas para o IoT Core.The steps defined above for Windows 10 IoT Enterprise can be followed for IoT Core as well.

Para adicionar o PowerShell mais recente na imagem de remessa, use o comando Import-PSCoreRelease para incluir o pacote na área de trabalho e adicione o recurso OPENSRC_POWERSHELL à imagem.For adding the latest PowerShell in the shipping image, use Import-PSCoreRelease command to include the package in the workarea and add OPENSRC_POWERSHELL feature to your image.

Observação

Para a arquitetura ARM64, o Windows PowerShell não é adicionado quando você inclui IOT_POWERSHELL.For ARM64 architecture, Windows PowerShell is not added when you include IOT_POWERSHELL. Portanto, a instalação baseada em zip não funcionará.So the zip based install will not work. Você precisará usar o comando Import-PSCoreRelease para adicioná-lo à imagem.You will need to use Import-PSCoreRelease command to add it in the image.

Implantação no Nano ServerDeploying on Nano Server

Essas instruções pressupõem que o Nano Server é um sistema operacional "sem periféricos" que tem uma versão do PowerShell já em execução.These instructions assume that the Nano Server is a "headless" OS that has a version of PowerShell is already running on it. Confira mais informações na documentação do Construtor de Imagens do Nano Server.For more information, see the Nano Server Image Builder documentation.

Os binários do PowerShell podem ser implantados usando dois métodos diferentes.PowerShell binaries can be deployed using two different methods.

  1. Offline – monte o VHD do Nano Server e descompacte o conteúdo do arquivo zip para o local escolhido na imagem montada.Offline - Mount the Nano Server VHD and unzip the contents of the zip file to your chosen location within the mounted image.
  2. Online – transfira o arquivo zip em uma sessão do PowerShell e descompacte-o em seu local escolhido.Online - Transfer the zip file over a PowerShell Session and unzip it in your chosen location.

Em ambos os casos, você precisa do pacote de versão ZIP do Windows 10 x64.In both cases, you need the Windows 10 x64 ZIP release package. Execute os comandos em uma instância de "Administrador" do PowerShell.Run the commands within an "Administrator" instance of PowerShell.

Implantação offline do PowerShellOffline Deployment of PowerShell

  1. Use o utilitário zip favorito para descompactar o pacote para um diretório na imagem montada do Nano Server.Use your favorite zip utility to unzip the package to a directory within the mounted Nano Server image.
  2. Desmonte a imagem e inicialize-a.Unmount the image and boot it.
  3. Conecte-se à instância interna do Windows PowerShell.Connect to the built-in instance of Windows PowerShell.
  4. Siga as instruções para criar um ponto de extremidade de comunicação remota usando a "outra técnica de instância".Follow the instructions to create a remoting endpoint using the "another instance technique".

Implantação online do PowerShellOnline Deployment of PowerShell

Implante o PowerShell no Nano Server usando as etapas a seguir.Deploy PowerShell to Nano Server using the following steps.

  • Conectar-se à instância interna do Windows PowerShellConnect to the built-in instance of Windows PowerShell

    $session = New-PSSession -ComputerName <Nano Server IP address> -Credential <An Administrator account on the system>
    
  • Copiar o arquivo para a instância do Nano ServerCopy the file to the Nano Server instance

    Copy-Item <local PS Core download location>\powershell-<version>-win-x64.zip c:\ -ToSession $session
    
  • Entrar na sessãoEnter the session

    Enter-PSSession $session
    
  • Extrair o arquivo ZIPExtract the ZIP file

    # Insert the appropriate version.
    Expand-Archive -Path C:\powershell-<version>-win-x64.zip -DestinationPath "C:\PowerShell_<version>"
    
  • Se você deseja comunicação remota baseada no WSMan, siga as instruções para criar um ponto de extremidade de comunicação remota usando a "outra técnica de instância".If you want WSMan-based remoting, follow the instructions to create a remoting endpoint using the "another instance technique".

Instalar como uma ferramenta global do .NETInstall as a .NET Global tool

Se você já tiver o SDK do .NET Core instalado, será fácil instalar o PowerShell como uma ferramenta global do .NET.If you already have the .NET Core SDK installed, it's easy to install PowerShell as a .NET Global tool.

dotnet tool install --global PowerShell

O instalador da ferramenta dotnet adiciona $env:USERPROFILE\dotnet\tools à sua variável de ambiente $env:PATH.The dotnet tool installer adds $env:USERPROFILE\dotnet\tools to your $env:PATH environment variable. No entanto, o shell atualmente em execução não tem o $env:PATH atualizado.However, the currently running shell doesn't have the updated $env:PATH. Você pode iniciar o PowerShell em um novo shell digitando pwsh.You can start PowerShell from a new shell by typing pwsh.

Instalar o PowerShell por meio do WingetInstall PowerShell via Winget

A ferramenta de linha de comando winget permite que os desenvolvedores descubram, instalem, atualizem, removam e configurem aplicativos em computadores Windows 10.The winget command-line tool enables developers to discover, install, upgrade, remove, and configure applications on Windows 10 computers. Essa ferramenta é a interface do cliente para o serviço Gerenciador de Pacotes do Windows.This tool is the client interface to the Windows Package Manager service.

Observação

Atualmente, a ferramenta winget está em versão prévia.The winget tool is currently a preview. Nem todas as funcionalidades planejadas estão disponíveis no momento.Not all planned functionality is available at this time. Não use esse método em um cenário de implantação de produção.You should not use this method in a production deployment scenario. Confira a documentação do winget para obter uma lista de requisitos do sistema e de instruções de instalação.See the winget documentation for a list of system requirements and install instructions.

Os seguintes comandos podem ser usados para instalar o PowerShell com os pacotes do winget publicados:The following commands can be used to install PowerShell using the published winget packages:

  1. Pesquisar a versão mais recente do PowerShellSearch for the latest version of PowerShell

    winget search Microsoft.PowerShell
    
    Name               Id                           Version
    ---------------------------------------------------------------
    PowerShell         Microsoft.PowerShell         7.0.3
    PowerShell-Preview Microsoft.PowerShell-Preview 7.1.0-preview.5
    
  2. Instalar uma versão do PowerShell usando o parâmetro --exactInstall a version of PowerShell using the --exact parameter

    winget install --name PowerShell --exact
    winget install --name PowerShell-Preview --exact
    

Como criar um ponto de extremidade de comunicação remotaHow to create a remoting endpoint

O PowerShell dá suporte ao protocolo PSRP (comunicação remota do PowerShell) por WSMan e SSH.PowerShell supports the PowerShell Remoting Protocol (PSRP) over both WSMan and SSH. Para obter mais informações, consulte:For more information, see:

Atualizar uma instalação existenteUpgrading an existing installation

Para obter melhores resultados ao atualizar, você deve usar o mesmo método de instalação usado ao instalar o PowerShell pela primeira vez.For best results when upgrading, you should use the same install method you used when you first installed PowerShell. Cada método de instalação instala o PowerShell em um local diferente.Each installation method installs PowerShell in a different location. Se você não tiver certeza de como o PowerShell foi instalado, compare o local de instalação às informações do pacote neste artigo.If you are not sure how PowerShell was installed, you can compare the installed location with the package information in this article. Se você instalou por meio do pacote MSI, essas informações serão exibidas no Painel de Controle de Programas e Recursos.If you installed via the MSI package, that information appears in the Programs and Features Control Panel.

Suporte à instalaçãoInstallation support

A Microsoft dá suporte aos métodos de instalação neste documento.Microsoft supports the installation methods in this document. Pode haver outros métodos de instalação disponíveis de outras fontes.There may be other methods of installation available from other sources. Embora essas ferramentas e métodos possam funcionar, a Microsoft não pode dar suporte a esses métodos.While those tools and methods may work, Microsoft cannot support those methods.