Instalar o PowerShell no macOS

O PowerShell 7.0 ou superior necessita do macOS 10.13 e superior. Todos os pacotes estão disponíveis na nossa página de lançamentos do GitHub. Depois de instalar o pacote, execute pwsh a partir de um terminal. Antes de instalar, verifique a lista de Versões suportadas abaixo.

Nota

O PowerShell 7.3 é uma atualização no local que remove versões anteriores do PowerShell.

Se precisar de executar uma versão mais antiga do PowerShell lado a lado com o PowerShell 7.3, instale a versão que pretende com o método de arquivo binário .

Instalação da versão estável mais recente através do Homebrew no macOS 10.13 ou superior

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

Se o brew comando não for encontrado, terá de instalar o Homebrew ao seguir as instruções.

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

Agora, pode instalar o PowerShell:

brew install --cask powershell

Por fim, verifique se a instalação está a funcionar corretamente:

pwsh

Quando forem lançadas novas versões do PowerShell, atualize as fórmulas do Homebrew e atualize o PowerShell:

brew update
brew upgrade powershell --cask

Nota

Os comandos acima podem ser chamados a partir de um anfitrião do PowerShell (pwsh), mas, em seguida, a shell do PowerShell tem de ser encerrada e reiniciada para concluir a atualização e atualizar os valores apresentados em $PSVersionTable.

Instalação da versão de pré-visualização mais recente através do Homebrew no macOS 10.13 ou superior

Depois de instalar o Homebrew, pode instalar o PowerShell. Primeiro, instale o pacote Cask-Versions que lhe permite instalar versões alternativas de pacotes cask:

brew tap homebrew/cask-versions

Agora, pode instalar o PowerShell:

brew install --cask powershell-preview

Por fim, verifique se a instalação está a funcionar corretamente:

pwsh-preview

Quando forem lançadas novas versões do PowerShell, atualize as fórmulas do Homebrew e atualize o PowerShell:

brew update
brew upgrade powershell-preview --cask

Nota

Os comandos acima podem ser chamados a partir de um anfitrião do PowerShell (pwsh), mas, em seguida, a shell do PowerShell tem de ser encerrada e reiniciada para concluir a atualização. e atualize os valores apresentados em $PSVersionTable.

A instalação do PowerShell com o método de toque do Homebrew também é suportada para versões estáveis e LTS.

brew install powershell/tap/powershell

Agora, pode verificar a instalação

pwsh

Quando forem lançadas novas versões do PowerShell, execute o seguinte comando.

brew upgrade powershell

Nota

Quer utilize o barril ou o método de toque, ao atualizar para uma versão mais recente do PowerShell, utilize o mesmo método que utilizou para instalar inicialmente o PowerShell. Se utilizar um método diferente, abrir uma nova sessão pwsh continuará a utilizar a versão mais antiga do PowerShell.

Se optar por utilizar métodos diferentes, existem formas de corrigir o problema com o método de ligação Homebrew.

Instalação através da Transferência Direta

A partir da versão 7.2, o PowerShell suporta o processador Apple M1. Transfira o pacote de instalação da página de versões para o seu computador. As ligações para as versões atuais são:

Pode fazer duplo clique no ficheiro e seguir as instruções ou instalá-lo a partir do terminal com os seguintes comandos. Altere o nome do ficheiro para corresponder ao ficheiro que transferiu.

sudo installer -pkg powershell-7.3.3-osx-x64.pkg -target /

Se estiver a executar no macOS Big Sur 11.5 ou superior, poderá receber a seguinte mensagem de erro ao instalar o pacote:

"powershell-7.3.3-osx-x64.pkg" não pode ser aberto porque a Apple não consegue verificar se existe software malicioso.

Existem duas formas de contornar este problema:

Utilizar o Finder

  1. Localize o pacote no Finder.
  2. Clique com o botão de controlo (clique enquanto prime a tecla Ctrl ) no pacote.
  3. Selecione Abrir no menu de contexto.

A partir da linha de comandos

  1. Execute sudo xattr -rd com.apple.quarantine powershell-7.3.3-osx-x64.pkg. Inclua o caminho completo para o .pkg ficheiro.
  2. Instale o pacote como faria normalmente.

Nota

Este é um problema conhecido relacionado com a notação de pacotes que será resolvido no futuro.

Instalar como uma ferramenta .NET Global

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

dotnet tool install --global PowerShell

O instalador da ferramenta dotnet adiciona ~/.dotnet/tools à variável de PATH ambiente. No entanto, a shell atualmente em execução não tem o PATH. Deverá conseguir iniciar o PowerShell a partir de uma nova shell ao escrever pwsh.

Arquivos Binários

Os arquivos binários tar.gz do PowerShell são fornecidos para a plataforma macOS para permitir cenários de implementação avançados. Ao instalar com este método, também tem de instalar manualmente quaisquer dependências.

Nota

Pode utilizar este método para instalar qualquer versão do PowerShell, incluindo a mais recente:

Instalar arquivos binários no macOS

Transfira o pacote de instalação da página de versões para o seu computador. As ligações para as versões atuais são:

Utilize os seguintes comandos para instalar o PowerShell a partir do arquivo binário. Altere o URL de transferência para corresponder à versão que pretende instalar.

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

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

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

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

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

Desinstalar o PowerShell

Se instalou o PowerShell com o Homebrew, utilize o seguinte comando para desinstalar:

brew uninstall --cask powershell

Se instalou o PowerShell através da transferência direta, o PowerShell tem de ser removido manualmente:

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

Para remover os caminhos adicionais do PowerShell, veja a secção paths neste documento e remova os caminhos com sudo rm.

Nota

Isto não é necessário se tiver instalado com o Homebrew.

Caminhos

  • $PSHOME é /usr/local/microsoft/powershell/7.3.3/
  • Os perfis de utilizador são lidos a partir de ~/.config/powershell/profile.ps1
  • Os perfis predefinidos são lidos a partir de $PSHOME/profile.ps1
  • Os módulos de utilizador são lidos a partir de ~/.local/share/powershell/Modules
  • Os módulos partilhados são lidos a partir de /usr/local/share/powershell/Modules
  • Os módulos predefinidos são lidos a partir de $PSHOME/Modules
  • O histórico do PSReadLine é gravado em ~/.local/share/powershell/PSReadLine/ConsoleHost_history.txt

Os perfis respeitam a configuração por anfitrião do PowerShell. Assim, o perfil predefinido específico do anfitrião existe Microsoft.PowerShell_profile.ps1 nas mesmas localizações.

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

Uma vez que o macOS é uma derivação do BSD, o prefixo /usr/local é utilizado em vez de /opt. Assim como $PSHOME/usr/local/microsoft/powershell/7.3.3/, e a ligação simbólica é colocada em /usr/local/bin/pwsh.

Versões suportadas

A tabela seguinte contém uma lista de versões do PowerShell e o estado do suporte para versões do macOS. Estas versões permanecem suportadas até que a versão do PowerShell atinja o fim do suporte ou a versão do macOS atinja o fim do suporte.

  • O ícone Suportado indica que a versão do SO ou do PowerShell ainda é suportada
  • O ícone Fora do Suporte indica que a versão do PowerShell já não é suportada nessa versão do SO
  • O ícone Em Teste indica que ainda não terminámos o teste do PowerShell nesse SO
  • O ícone Não Suportado indica que a versão do SO ou do PowerShell não é suportada
  • Quando a versão do SO e a versão do PowerShell têm um ícone Suportado , essa combinação é suportada
macOS 7.2 (LTS-current) 7.3 7.4 (pré-visualização)
Suportado Big Sur 11.5 Suportado Suportado Suportado

O macOS 12 (Monterey) e o macOS 13 (Ventura) não foram testados.

O suporte do macOS é definido pela Apple. Para obter mais informações, consulte:

O PowerShell é suportado no macOS para as seguintes arquiteturas de processador:

macOS 7.2 (LTS-current) 7.3 7.4 (pré-visualização)
macOS Big Sur 11.5 x64, Arm64 x64, Arm64 x64, Arm64

Suporte de instalação

A Microsoft suporta os métodos de instalação neste documento. Podem existir outros métodos de instalação disponíveis a partir de outras origens. Embora essas ferramentas e métodos possam funcionar, a Microsoft não pode suportar esses métodos.

Recursos Adicionais