Compartilhar via


Instalar o PowerShell 7 no macOS

Há várias versões de pacote do PowerShell 7 que podem ser instaladas. Este artigo se concentra na instalação do pacote de lançamento estável mais recente. Para obter mais informações sobre as versões do pacote, consulte o artigo ciclo de vida de suporte do PowerShell .

As versões mais recentes do PowerShell 7 substituem as versões anteriores existentes do PowerShell 7. Versões prévias do PowerShell podem ser instaladas juntamente com outras versões do PowerShell. Versões de visualização mais recentes substituem as versões prévias anteriores existentes. Se você precisar executar o PowerShell 7.5 lado a lado com uma versão anterior, reinstale a versão anterior usando o método de arquivo binário.

Escolher um método de instalação

Existem várias maneiras de instalar o PowerShell no macOS.

Baixar e instalar o pacote manualmente

Baixe o pacote de instalação na página lançamentos. Selecione a versão do pacote que você deseja instalar.

Há duas maneiras de instalar o PowerShell usando o pacote baixado.

Instalar o pacote usando o Finder

Instale o PowerShell usando o Finder:

  1. Abrir Localizador

  2. Localizar o pacote baixado

  3. Clique duas vezes no arquivo

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

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

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

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

Essa mensagem de erro vem do recurso Gatekeeper do macOS. Para obter mais informações, consulte Aplicativos abertos com segurança em seu Mac – Suporte da Apple.

Depois de tentar abrir o pacote, siga estas etapas:

  1. Abra as Configurações do Sistema.
  2. Selecione Privacidade & Segurança e role para baixo até a seção Segurança .
  3. Selecione o botão Abrir De Qualquer Maneira para confirmar sua intenção de instalar o PowerShell.
  4. Quando o prompt de aviso reaparecer, selecione Abrir Mesmo Assim.
  5. Insira o nome de usuário e a senha para permitir que a instalação prossiga.

Instale o pacote a partir de um terminal de comandos

Para instalar o pacote do PowerShell 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.5-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.5-osx-arm64.pkg.
    • Use o Unblock-File cmdlet se você estiver usando o PowerShell. Inclua o caminho completo para o arquivo .pkg.

Instalar como uma ferramenta .NET Global

Se você já tiver o .NET Core SDK instalado, poderá usar a ferramenta .NET Global para instalar o PowerShell 7.

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. Inicie o PowerShell de um novo shell digitando pwsh.

Instalar o PowerShell 7 de um arquivo binário

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 usando esse método, você também deve instalar manualmente quaisquer dependências.

Baixe o pacote de instalação da página de lançamentos para o seu Mac. Selecione a versão arquivada que você deseja instalar.

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.5.5/powershell-7.5.5-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

Iniciar o PowerShell 7

Depois de instalar o pacote, execute pwsh em um terminal. Se você instalou um pacote de visualização, execute pwsh-preview.

  • O local de $PSHOME varia de acordo com o pacote que você instalou.
    • Para pacotes estáveis e LTS: /usr/local/microsoft/powershell/7/
    • Para pacotes de versão prévia: /usr/local/microsoft/powershell/7-preview/
    • 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 é gravado em ~/.local/share/powershell/PSReadLine/ConsoleHost_history.txt

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

Atualizar o PowerShell 7

Para atualizar o PowerShell, baixe a nova versão do pacote ou arquivo binário e instale-a.

Desinstalar o PowerShell 7

Para desinstalar o PowerShell, você precisa excluir a pasta do aplicativo e outros arquivos de suporte. O comando a seguir remove o link simbólico e os arquivos do PowerShell.

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

Use sudo rm para remover quaisquer outros arquivos e pastas restantes do PowerShell.

Versões com suporte do macOS

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

Há suporte para as seguintes versões do macOS:

  • 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:

Métodos de instalação com suporte

A Microsoft dá suporte aos métodos de instalação neste documento. Pode haver outros métodos de instalação de terceiros disponíveis de outras fontes. Embora essas ferramentas e métodos possam funcionar, a Microsoft não pode dar suporte a esses métodos. Para obter mais informações, consulte Maneiras alternativas de instalar o PowerShell.