Compartilhar via

Instalar o PowerShell no macOS

  • Artigo

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 oferece suporte aos processadores Apple da série M baseados em Arm. 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.6-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:

"powershell-7.4.6-osx-x64.pkg" não pode ser aberto porque a Apple não pode verificar se há software malicioso.

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.6-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.6/powershell-7.4.6-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 Microsoft dá suporte ao PowerShell até o PowerShell chegar ao fim do suporte ou a versão do macOS também chegar ao 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