Instalar o PowerShell no macOS

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

Observação

O PowerShell 7.4 é uma atualização in-loco que remove versões anteriores do PowerShell 7. Versões prévias do PowerShell podem ser instaladas juntamente com outras versões do PowerShell. Se você precisar executar o PowerShell 7.4 lado a lado com o PowerShell 7, reinstale a versão anterior usando o método do arquivo binário.

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:

Se o comando brew não for encontrado, será necessário instalar o Homebrew seguindo as instruções.

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

Uma vez que brew esteja instalado, você poderá instalar o PowerShell.

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

brew install powershell/tap/powershell

Por fim, 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

Os comandos acima podem ser chamados por meio de um host do PowerShell (pwsh), mas será necessário sair e entrar novamente no shell do PowerShell para concluir o upgrade e atualizar os valores mostrados em $PSVersionTable.

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

Depois de instalar o Homebrew, você pode instalar o 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 do PowerShell forem lançadas, atualize a fórmula do Homebrew e faça upgrade do PowerShell:

brew update
brew upgrade powershell-preview

Observação

Os comandos acima podem ser chamados por meio de um host do PowerShell (pwsh), mas será necessário sair e entrar novamente no shell do PowerShell para concluir a atualização. e atualizar os valores mostrados em $PSVersionTable.

Instalar a versão LTS mais recente do PowerShell

brew install powershell/tap/powershell-lts

Agora você pode verificar sua instalação

pwsh

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

brew upgrade powershell-lts

Observação

Se você usar o método cask ou de toque, ao atualizar para uma versão mais recente do PowerShell, siga o mesmo método usado para instalar o PowerShell na primeira vez. Se você usar um método diferente, abrir uma nova sessão de push continuará a usar a versão mais antiga do PowerShell.

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

Instalação por meio de download direto

A partir da versão 7.2, o PowerShell dá suporte ao processador Apple M1. Baixe o pacote de instalação na página de versões para o computador. Os links para as versões atuais são:

Clique duas vezes no arquivo e siga os prompts ou instale-o do terminal com os comandos a seguir. Altere o nome do arquivo para um igual ao do arquivo que você baixou.

sudo installer -pkg ./Downloads/powershell-7.4.1-osx-x64.pkg -target /

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

O "powershell-7.4.1-osx-x64.pkg" não pode ser aberto porque a Apple não consegue verificar se inclui um software mal-intencionado.

Há duas maneiras de contornar esse problema:

Usando o Localizador

  1. Localize o pacote no Localizador.
  2. Clique no botão de controle (clique enquanto pressiona a tecla Ctrl) no pacote.
  3. Selecione Abrir no menu de contexto.

Da linha de comando

  1. Execute sudo xattr -rd com.apple.quarantine ./Downloads/powershell-7.4.1-osx-x64.pkg. Se estiver usando o PowerShell 7 ou superior, você poderá usar o cmdlet Unblock-File. Inclua o caminho completo para o arquivo .pkg.
  2. Instale o pacote como você faria normalmente.

Observação

Esse é um problema conhecido relacionado à notarização do pacote que será abordado no futuro.

Instalar como uma ferramenta global do .NET

Se você já tiver o SDK do .NET Core instalado, será 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. Você deve conseguir iniciar o PowerShell em 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 o 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 na página de versões para o computador. 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.4.1/powershell-7.4.1-osx-x64.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 adicionais do PowerShell, confira a seção caminhos neste documento e remova os caminhos com sudo rm.

Observação

Isso não é necessário se você tiver instalado usando 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 será gravado em ~/.local/share/powershell/PSReadLine/ConsoleHost_history.txt

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

Versões suportadas

A tabela a seguir contém uma lista de versões do PowerShell e o status do suporte para versões do macOS. Essas versões permanecem compatíveis 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 Com suporte indica que a versão do sistema operacional ou do PowerShell ainda tem suporte
  • O ícone Fora de suporte indica que a versão do PowerShell não tem mais suporte nesta versão do sistema operacional
  • O ícone Em teste indica que ainda não terminamos de testar o PowerShell neste sistema operacional
  • O ícone Sem suporte indica que a versão do sistema operacional ou do PowerShell não tem suporte
  • Quando a versão do sistema operacional e a versão do PowerShell têm um ícone Com suporte, há suporte para essa combinação
macOS 7.2 (LTS – versão prévia) 7.3 7.4 (LTS – atual)
Com suporte 14 (Sonoma) Em teste Em teste Em teste
Com suporte 13 (Ventura) Em teste Em teste Em teste
Com suporte 12 (Monterey) Em teste Em teste Em teste
Com suporte 11 (Big Sur) Compatível Compatível Com suporte

O suporte ao macOS é definido pela Apple. Para saber mais, consulte o seguinte:

O PowerShell é compatível com o macOS nestas arquiteturas de processador:

macOS 7.2 (LTS – atual) 7.3 7.4 (LTS – atual)
macOS Big Sur 11.5 x64, Arm64 x64, Arm64 x64, Arm64

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