Instalar o PowerShell no macOS

  • Artigo

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

Nota

O PowerShell 7.4 é uma atualização in-loco que remove versões anteriores do PowerShell 7. As versões de visualização do PowerShell podem ser instaladas 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.

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

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

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

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

Uma vez brew instalado, você pode instalar o PowerShell.

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

brew install powershell/tap/powershell

Finalmente, verifique se a instalação está funcionando corretamente:

pwsh

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

brew update
brew upgrade powershell

Nota

Os comandos acima podem ser chamados de dentro de um host do PowerShell (pwsh), mas o shell do PowerShell deve ser encerrado e reiniciado para concluir a atualização e atualizar os valores mostrados em $PSVersionTable.

Instalar a versão de visualização 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 de visualização do PowerShell:

pwsh-preview

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

brew update
brew upgrade powershell-preview

Nota

Os comandos acima podem ser chamados de dentro de um host do PowerShell (pwsh), mas o shell do PowerShell deve ser encerrado e reiniciado para concluir a atualização. e atualize 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 seguinte comando.

brew upgrade powershell-lts

Nota

Quer você use o método cask ou tap, ao atualizar para uma versão mais recente do PowerShell, use o mesmo método usado para instalar inicialmente o PowerShell. 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, há maneiras de corrigir o problema usando o método de link Homebrew.

Instalação via Download Direto

A partir da versão 7.2, o PowerShell suporta os processadores baseados em Arm da série M da Apple. Transfira o pacote de instalação a partir da página de versões para o seu computador. Os links para as versões atuais são:

Você pode clicar duas vezes no arquivo e seguir os prompts, ou instalá-lo a partir do terminal usando os seguintes comandos. Altere o nome do arquivo para corresponder ao 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, você 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 verificá-lo em busca de software mal-intencionado.

Há duas maneiras de contornar esse problema:

Usando o Finder

  1. Encontre o pacote no Finder.
  2. Clique com a tecla Control pressionada (clique enquanto pressiona a tecla Ctrl ) no pacote.
  3. Selecione Abrir no menu de contexto.

A partir da linha de comando

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

Nota

Este é um problema conhecido relacionado à notarização de pacotes que será abordado no futuro.

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 PATH variável de ambiente. No entanto, o shell em execução no momento não tem o arquivo PATH. Você deve ser capaz de iniciar o PowerShell a partir de um novo shell digitando pwsh.

Arquivos binários

Os arquivos binários tar.gz do PowerShell são fornecidos para a plataforma macOS para habilitar cenários avançados de implantação. Quando você instala usando esse método, você também deve instalar manualmente todas as dependências.

Nota

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

Instalando arquivos binários no macOS

Transfira o pacote de instalação a partir da página de versões para o seu computador. Os links para as versões atuais são:

Use os comandos a seguir para instalar o PowerShell a partir do arquivo binário. Altere o 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

Desinstalando o PowerShell

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

brew uninstall --cask powershell

Se você instalou o PowerShell por 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, consulte a seção de caminhos neste documento e remova os caminhos usando sudo rmo .

Nota

Isso não é necessário se você instalou com 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 o $PSHOME local.
  • Os perfis de utilizador são lidos a partir de ~/.config/powershell/profile.ps1
  • Os perfis padrão são lidos de $PSHOME/profile.ps1
  • Os módulos de usuário são lidos a partir de ~/.local/share/powershell/Modules
  • Os módulos compartilhados são lidos a partir de /usr/local/share/powershell/Modules
  • Os módulos padrão são lidos a partir de $PSHOME/Modules
  • O histórico PSReadLine é gravado em ~/.local/share/powershell/PSReadLine/ConsoleHost_history.txt

O PowerShell respeita a especificação do diretório base XDG no macOS.

Versões suportadas

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

  • macOS 12 (Monterey) x64 e Arm64
  • macOS 13 (Ventura) x64 e Arm64
  • macOS 14 (Sonoma) x64 e Arm64

A Apple determina o ciclo de vida de suporte do macOS. Para mais informações, consulte o seguinte:

Suporte à instalação

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

Recursos Adicionais