Compartir a través de

Instalación de PowerShell en macOS

PowerShell 7 o posterior requiere macOS 13 y versiones posteriores. Todos los paquetes están disponibles en la página de versiones de GitHub para PowerShell. Una vez instalado el paquete, ejecute pwsh desde un terminal. Antes de la instalación, compruebe la lista de versiones admitidas.

Nota:

PowerShell 7.4 es una actualización local que quita las versiones anteriores de PowerShell 7. Puede instalar versiones preliminares de PowerShell en paralelo con otras versiones de PowerShell. Si necesita ejecutar PowerShell 7.4 en paralelo con una versión anterior, vuelva a instalar la versión anterior con el método de archivo binario.

Nota:

Los comandos de instalación de este artículo son para la versión estable más reciente de PowerShell. Para instalar otra versión de PowerShell, ajuste el comando para que se adapte a la versión que necesita. Los vínculos siguientes le dirigen a la página de versión más reciente de cada versión en GitHub.

Los enlaces de descarga de cada paquete se encuentran en la sección Recursos de la página de lanzamiento. Es posible que la sección Assets (Recursos) esté contraída, por lo que tendría que hacer clic para expandirla.

Instalación de la versión estable más reciente de PowerShell

Existen varias maneras de instalar PowerShell en macOS. Elija uno de los métodos siguientes:

Instalación mediante Homebrew

Si no se encuentra el comando brew, debe instalar Homebrew según sus instrucciones.

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

Una vez brew instalado, instale PowerShell.

El siguiente comando instala la versión estable más reciente de PowerShell:

brew install --cask powershell

Compruebe que la instalación funciona correctamente:

pwsh

Cuando se publiquen nuevas versiones de PowerShell, actualice las fórmulas de Homebrew y luego actualice PowerShell.

brew update
brew upgrade powershell

Nota:

Puede llamar a los comandos anteriores desde una sesión de PowerShell (pwsh), pero debe reiniciar la sesión de PowerShell para completar la actualización y actualizar los valores que se muestran en $PSVersionTable.

Instalación de la versión preliminar más reciente de PowerShell

El siguiente comando instala la versión preliminar más reciente de PowerShell:

brew install powershell/tap/powershell-preview

Ejecute el siguiente comando para iniciar la versión preliminar de PowerShell:

pwsh-preview

Cuando se publiquen nuevas versiones preliminares de PowerShell, actualice las fórmulas de Homebrew y actualice a la versión preliminar más reciente de PowerShell:

brew update
brew upgrade powershell-preview

Nota:

Puede llamar a los comandos anteriores desde una sesión de PowerShell (pwsh), pero debe reiniciar la sesión de PowerShell para completar la actualización y actualizar los valores que se muestran en $PSVersionTable.

Instalación de la versión más reciente de LTS de PowerShell

El siguiente comando instala la versión más reciente de LTS de PowerShell:

brew install powershell/tap/powershell-lts

Compruebe la instalación:

pwsh-lts

Cuando se publiquen nuevas versiones de LTS de PowerShell, ejecute los siguientes comandos para actualizar las fórmulas de Homebrew y actualizar a la versión más reciente de LTS de PowerShell:

brew update
brew upgrade powershell-lts

Nota:

Al actualizar a una versión más reciente de PowerShell, use el mismo método, cask o tap, que usó para realizar la instalación inicial. Si usa otro método, al abrir una nueva sesión de pwsh se sigue usando la versión anterior de PowerShell.

Si decide usar diferentes métodos, hay maneras de corregir el problema mediante el método de vínculo Homebrew.

Instalación mediante descarga directa

A partir de la versión 7.2, PowerShell admite el procesador serie M de Apple basados en Arm. Descargue el paquete de instalación de la página de versiones en el equipo Mac. Los vínculos a las versiones actuales son:

Hay dos maneras de instalar PowerShell mediante el método Direct Download.

Uso de Finder

Instale PowerShell mediante Finder:

  1. Abrir Finder
  2. Buscar el paquete descargado
  3. Haga doble clic en el archivo.
  4. Siga las indicaciones

Es posible que reciba el siguiente mensaje de error al instalar el paquete:

No se puede abrir "powershell-7.5.1-osx-arm64.pkg" porque Apple no puede comprobar si hay software malintencionado.

Para solucionar este problema mediante Finder:

  1. Buscar el paquete descargado en Finder
  2. Haga clic con la tecla Control (haga clic manteniendo presionada la tecla Control (o Ctrl) sobre el paquete.
  3. Seleccione Abrir en el menú contextual.

Uso de Terminal

Instale PowerShell desde el terminal. Cambie el nombre de archivo para que coincida con el paquete que descargó.

sudo installer -pkg ./Downloads/powershell-7.5.1-osx-arm64.pkg -target /

Es posible que reciba el siguiente mensaje de error al instalar el paquete:

No se puede abrir "powershell-7.5.1-osx-arm64.pkg" porque Apple no puede comprobar si hay software malintencionado.

Hay varias maneras diferentes de solucionar este problema desde la línea de comandos:

  • Ejecute el installer comando con la marca allowUntrusted :

    `sudo installer -allowUntrusted -pkg ./Downloads/powershell-7.5.1-osx-arm64.pkg -target /`

  • O bien, instale el paquete como lo haría normalmente después de ejecutar uno de los siguientes comandos:

    • Ejecute el sudo xattr -rd com.apple.quarantine ./Downloads/powershell-7.5.1-osx-arm64.pkg.
    • Use el Unblock-File cmdlet si usa PowerShell. Incluya la ruta de acceso completa al archivo .pkg.

Instalación como una herramienta global de .NET

Si ya tiene instalado el SDK de .NET Core, es fácil instalar PowerShell como una herramienta global de .NET.

dotnet tool install --global PowerShell

El instalador de la herramienta dotnet agrega ~/.dotnet/tools a la variable de entorno PATH. Sin embargo, el shell que se ejecuta actualmente no tiene PATH actualizado. Inicie PowerShell desde un nuevo shell escribiendo pwsh.

Archivos binarios

Se proporcionan archivos binarios tar.gz de PowerShell para la plataforma macOS, a fin de permitir escenarios de implementación avanzados. Si instala usando este método, también debe instalar manualmente las dependencias.

Nota:

Puede usar este método para instalar cualquier versión de PowerShell, incluidas las más recientes:

Instalación de archivos binarios en macOS

Descargue el paquete de instalación de la página de versiones en el equipo Mac. Los vínculos a las versiones actuales son:

Use los siguientes comandos para instalar PowerShell desde el archivo binario. Cambie la dirección URL de descarga para que coincida con la versión que quiere instalar.

# Download the powershell '.tar.gz' archive
curl -L -o /tmp/powershell.tar.gz https://github.com/PowerShell/PowerShell/releases/download/v7.5.1/powershell-7.5.1-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

Desinstalación de PowerShell

Si ha instalado PowerShell con Homebrew, use el siguiente comando para desinstalar:

brew uninstall --cask powershell

Si ha instalado PowerShell mediante descarga directa, deberá quitar PowerShell manualmente:

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

Para quitar las rutas de acceso adicionales de PowerShell, consulte la sección rutas de acceso de este documento y quite las rutas de acceso mediante sudo rm.

Nota:

Este proceso no es necesario si instaló con Homebrew.

Rutas

  • $PSHOME es /usr/local/microsoft/powershell/7.
    • El paquete de instalación de macOS crea un vínculo simbólico, /usr/local/bin/pwsh que apunta a pwsh en la ubicación $PSHOME.
  • Los perfiles de usuario se leerán de ~/.config/powershell/profile.ps1
  • Los perfiles predeterminados se leerán de $PSHOME/profile.ps1
  • Los módulos de usuario se leerán de ~/.local/share/powershell/Modules
  • Los módulos compartidos se leerán de /usr/local/share/powershell/Modules
  • Los módulos predeterminados se leerán de $PSHOME/Modules
  • El historial de PSReadLine se registra en ~/.local/share/powershell/PSReadLine/ConsoleHost_history.txt

PowerShell respeta la especificación de directorio base de XDG en macOS.

Versiones compatibles

Microsoft admite PowerShell hasta que PowerShell llega al final del soporte técnico o la versión de macOS llega al final del soporte técnico.

  • macOS 15 (Sequoia) x64 y Arm64
  • macOS 14 (Sonoma) x64 y Arm64
  • macOS 13 (Ventura) x64 y Arm64

Apple determina el ciclo de vida de soporte técnico de macOS. Para obtener más información, vea lo siguiente:

Soporte de instalación

Microsoft admite los métodos de instalación de este documento, Puede haber otros métodos de instalación disponibles desde otros orígenes. Aunque esas herramientas y métodos pueden funcionar, Microsoft no puede admitir esos métodos.

Recursos adicionales