Compartilhar via

Instalar o PowerShell no macOS

O PowerShell 7 ou superior requer o macOS 13 e superior. Todos os pacotes estão disponíveis na página de versões do GitHub para o PowerShell. Depois de instalar o pacote, execute pwsh em um terminal. Antes de instalar, verifique a lista de versões com suporte.

Observação

O PowerShell 7.4 é uma atualização no local que remove as versões anteriores do PowerShell 7. Você pode instalar versões prévias do PowerShell lado a lado com outras versões do PowerShell. Se você precisar executar o PowerShell 7.4 lado a lado com uma versão anterior, reinstale a versão anterior usando o método de arquivo binário .

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.

Instalar a versão estável mais recente do PowerShell

Existem várias maneiras de instalar o PowerShell no macOS. Use um dos seguintes métodos:

Instalar usando Homebrew

Se o brew comando não for encontrado, você precisará instalar o Homebrew seguindo suas instruções.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Depois de brew instalado, instale o PowerShell.

O comando a seguir instala a versão estável mais recente do PowerShell:

brew install --cask powershell

Verifique se a instalação está funcionando corretamente:

pwsh

Quando novas versões do PowerShell forem lançadas, atualize a fórmula do Homebrew e faça upgrade do PowerShell:

brew update
brew upgrade powershell

Observação

Você pode chamar os comandos anteriores de dentro de uma sessão do PowerShell (pwsh), mas, em seguida, você deve reiniciar a sessão do PowerShell para concluir a atualização e atualizar os valores mostrados em $PSVersionTable.

Instalar a versão prévia mais recente do PowerShell

O comando a seguir instala a versão prévia mais recente do PowerShell:

brew install powershell/tap/powershell-preview

Execute o seguinte comando para iniciar a versão prévia do PowerShell:

pwsh-preview

Quando novas versões prévias do PowerShell forem lançadas, atualize a fórmula do Homebrew e atualize para a versão prévia mais recente do PowerShell:

brew update
brew upgrade powershell-preview

Observação

Você pode chamar os comandos anteriores de dentro de uma sessão do PowerShell (pwsh), mas, em seguida, você deve reiniciar a sessão do PowerShell para concluir a atualização e atualizar os valores mostrados em $PSVersionTable.

Instalar a versão LTS mais recente do PowerShell

O comando a seguir instala a versão mais recente do LTS do PowerShell:

brew install powershell/tap/powershell-lts

Verifique sua instalação:

pwsh-lts

Quando novas versões lts do PowerShell forem lançadas, execute os seguintes comandos para atualizar a fórmula do Homebrew e atualizar para a versão mais recente do LTS do PowerShell:

brew update
brew upgrade powershell-lts

Observação

Ao atualizar para uma versão mais recente do PowerShell, use o mesmo método, cask ou tap, que você usou ao executar a instalação inicial. Se você usar um método diferente, abrir uma nova sessão pwsh continuará a usar a versão mais antiga do PowerShell.

Se você decidir usar métodos diferentes, haverá maneiras de corrigir o problema usando o método de link Homebrew.

Instalação por meio de download direto

A partir da versão 7.2, o PowerShell oferece suporte aos processadores Apple da série M baseados em Arm. Baixe o pacote de instalação da página de lançamentos para o seu Mac. Os links para as versões atuais são:

Há duas maneiras de instalar o PowerShell usando o método de Download Direto.

Usando o Localizador

Instale o PowerShell usando o Finder:

  1. Abrir Localizador
  2. Localizar o pacote baixado
  3. Clique duas vezes no arquivo
  4. Siga as instruções

Você pode receber a seguinte mensagem de erro ao instalar o pacote:

"powershell-7.5.1-osx-arm64.pkg" não pode ser aberto porque a Apple não pode verificar se há software mal-intencionado.

Para contornar esse problema usando o Finder:

  1. Localizar o pacote baixado no Finder
  2. Clique no botão de controle (clique enquanto pressiona a tecla Control (ou Ctrl) no pacote.
  3. Selecione Abrir no menu de contexto

Usar o terminal

Instale o PowerShell no terminal. Altere o nome do arquivo para corresponder ao pacote que você baixou.

sudo installer -pkg ./Downloads/powershell-7.5.1-osx-arm64.pkg -target /

Você pode receber a seguinte mensagem de erro ao instalar o pacote:

"powershell-7.5.1-osx-arm64.pkg" não pode ser aberto porque a Apple não pode verificar se há software mal-intencionado.

Há algumas maneiras diferentes de contornar esse problema na linha de comando:

  • Execute o installer comando com o sinalizador allowUntrusted :

    `sudo installer -allowUntrusted -pkg ./Downloads/powershell-7.5.1-osx-arm64.pkg -target /`

  • Ou instale o pacote como faria normalmente depois de executar um dos seguintes comandos:

    • Execute sudo xattr -rd com.apple.quarantine ./Downloads/powershell-7.5.1-osx-arm64.pkg.
    • Use o Unblock-File cmdlet se você estiver usando o PowerShell. Inclua o caminho completo para o arquivo .pkg.

Instalar como uma ferramenta global do .NET

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

dotnet tool install --global PowerShell

O instalador da ferramenta dotnet adiciona ~/.dotnet/tools à sua variável de ambiente PATH. No entanto, o shell atualmente em execução não tem o PATH atualizado. Inicie o PowerShell de um novo shell digitando pwsh.

Arquivos binários

Os arquivos binários tar.gz do PowerShell são fornecidos para plataformas macOS a fim de habilitar cenários de implantação avançada. Ao instalar usando esse método, você também deve instalar manualmente quaisquer dependências.

Observação

Você pode usar esse método para instalar qualquer versão do PowerShell, incluindo a mais recente:

Instalação de arquivos binários no macOS

Baixe o pacote de instalação da página de lançamentos para o seu Mac. Os links para as versões atuais são:

Use os comandos a seguir para instalar o PowerShell usando o arquivo binário. Altere a URL de download para corresponder à versão que você deseja instalar.

# Download the powershell '.tar.gz' archive
curl -L -o /tmp/powershell.tar.gz https://github.com/PowerShell/PowerShell/releases/download/v7.5.1/powershell-7.5.1-osx-arm64.tar.gz

# Create the target folder where powershell is placed
sudo mkdir -p /usr/local/microsoft/powershell/7

# Expand powershell to the target folder
sudo tar zxf /tmp/powershell.tar.gz -C /usr/local/microsoft/powershell/7

# Set execute permissions
sudo chmod +x /usr/local/microsoft/powershell/7/pwsh

# Create the symbolic link that points to pwsh
sudo ln -s /usr/local/microsoft/powershell/7/pwsh /usr/local/bin/pwsh

Desinstalar o PowerShell

Se você instalou o PowerShell com Homebrew, use o comando a seguir para desinstalar:

brew uninstall --cask powershell

Se você instalou o PowerShell por meio de download direto, o PowerShell deve ser removido manualmente:

sudo rm -rf /usr/local/bin/pwsh /usr/local/microsoft/powershell

Para remover os caminhos extras do PowerShell, consulte a seção caminhos neste documento e remova os caminhos usando sudo rm.

Observação

Esse processo não será necessário se você tiver instalado com o Homebrew.

Caminhos

  • $PSHOME é /usr/local/microsoft/powershell/7
    • O pacote de instalação do macOS cria um link simbólico, /usr/local/bin/pwsh que aponta para pwsh no local $PSHOME.
  • Os perfis de usuário serão lidos de ~/.config/powershell/profile.ps1
  • Os perfis padrão serão lidos de $PSHOME/profile.ps1
  • Os módulos de usuário serão lidos de ~/.local/share/powershell/Modules
  • Os módulos compartilhados serão lidos de /usr/local/share/powershell/Modules
  • Os módulos padrão serão lidos de $PSHOME/Modules
  • O histórico do PSReadLine é gravado em ~/.local/share/powershell/PSReadLine/ConsoleHost_history.txt

O PowerShell respeita a Especificação do Diretório Base do XDG no macOS.

Versões suportadas

A Microsoft dá suporte ao PowerShell até que o PowerShell atinja o fim do suporte ou a versão do macOS atinja o fim do suporte.

  • macOS 15 (Sequoia) x64 e Arm64
  • macOS 14 (Sonoma) x64 e Arm64
  • macOS 13 (Ventura) x64 e Arm64

A Apple determina o ciclo de vida de suporte do macOS. Para saber mais, consulte o seguinte:

Suporte à instalação

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

Recursos adicionais