Partilhar 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 PowerShell. Depois que o pacote for instalado, execute pwsh a partir de um terminal. Antes de instalar, verifique a lista de versões suportadas.

Versões mais recentes do PowerShell 7 substituem versões anteriores existentes do PowerShell 7. As versões de visualização do PowerShell podem ser instaladas lado a lado com outras versões do PowerShell. As versões de pré-visualização mais recentes substituem as versões anteriores existentes. Se precisares de correr o PowerShell 7.5 lado a lado com uma versão anterior, reinstala 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 necessária. 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 encontram-se na secção Recursos da página de lançamento. A seção Ativos pode estar fechada, portanto, talvez seja necessário clicar em "expandir".

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:

Instalar usando o Homebrew

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, 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 as fórmulas do Homebrew e atualize o PowerShell:

brew update
brew upgrade powershell

Observação

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

Instalar a versão de visualização mais recente do PowerShell

O comando a seguir instala a versão de visualização mais recente do 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 de visualização do PowerShell forem lançadas, atualize as fórmulas do Homebrew e atualize para a versão de visualização 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 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 LTS mais recente do PowerShell:

brew install powershell/tap/powershell-lts

Verifique a sua instalação:

pwsh-lts

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

brew update
brew upgrade powershell-lts

Observação

Ao atualizar para uma versão mais recente do PowerShell, utilize o mesmo método, cask ou tap, que usou para 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, há maneiras de corrigir o problema usando o método de link Homebrew.

Instale o pacote 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 da página de releases 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 Finder

Instale o PowerShell usando o Finder:

  1. Abrir Finder

  2. Localize o pacote baixado

  3. Clique duas vezes no arquivo

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

    "powershell-7.5.4-osx-arm64.pkg" não foi aberto

    A Apple não pôde verificar se "powershell-7.5.4-osx-arm64.pkg" está livre de malware que pode prejudicar o seu Mac ou comprometer a sua privacidade.

  4. Selecione o botão Concluído para fechar o prompt.

Esta mensagem de erro vem do recurso Gatekeeper do macOS. Para obter mais informações, consulte Abrir aplicações com segurança no Mac - Suporte Apple.

Depois de tentar abrir o pacote, siga estas etapas:

  1. Abra Configurações do Sistema.
  2. Selecione Privacidade e Segurança e desça até a seção Segurança.
  3. Selecione o botão Abrir mesmo assim para confirmar sua intenção de instalar o PowerShell.
  4. Quando o prompt de aviso reaparecer, selecione Abrir mesmo assim.
  5. Introduza o nome de utilizador e a palavra-passe para permitir que a instalação prossiga.

Usando o Terminal

Para instalar o pacote do PowerShell a partir da linha de comando, você deve ignorar as verificações do Gatekeeper. Use um dos seguintes métodos para instalar o pacote:

  • Execute o installer comando com o sinalizador allowUntrusted :

    sudo installer -allowUntrusted -pkg ./Downloads/powershell-7.5.4-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.4-osx-arm64.pkg.
    • Utilize o Unblock-File cmdlet se estiver a usar o PowerShell. Inclua o caminho completo para o .pkg arquivo.

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 PATH atualizado. Inicie 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.

Observação

Você pode usar esse 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 releases para o seu Mac. 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.5.4/powershell-7.5.4-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

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 .

Observação

Este processo não é necessário se você instalou com Homebrew.

Paths

  • $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 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 do 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 26 (Tahoe) x64 e Arm64
  • macOS 15 (Sequoia) x64 e Arm64
  • macOS 14 (Sonoma) x64 e Arm64

A Apple determina o ciclo de vida de suporte do macOS. Para obter 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 de outras fontes. Embora essas ferramentas e métodos possam funcionar, a Microsoft não pode oferecer suporte a esses métodos.

Recursos adicionais

  • Last updated on