Compartir a través de


Instalación de PowerShell en macOS

PowerShell 7 o posterior requiere macOS 11 y versiones posteriores. Todos los paquetes están disponibles en nuestra página de versiones de GitHub. Una vez instalado el paquete, ejecute pwsh desde un terminal. Antes de llevar a cabo la instalación, consulte la lista de versiones admitidas a continuación.

Nota:

PowerShell 7.4 es una actualización local que quita las versiones anteriores de PowerShell 7. Las versiones preliminares de PowerShell se pueden instalar 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.

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:

  • Realice la instalación mediante Homebrew. Homebrew es el administrador de paquetes preferido de macOS.
  • Realice la instalación de PowerShell mediante descarga directa.
  • Realice la instalación a partir de archivos binarios.

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 instalado brew podrá instalar PowerShell.

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

brew install powershell/tap/powershell

Por último, compruebe que la instalación funciona correctamente:

pwsh

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

brew update
brew upgrade powershell

Nota

Los comandos anteriores pueden llamarse desde un host de PowerShell (pwsh), pero, acto seguido, el shell de PowerShell se debe cerrar y volver a iniciar para finalizar la actualización y actualizar los valores que aparecen en $PSVersionTable.

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

Una vez instalado Homebrew, puede instalar 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 de PowerShell, actualice PowerShell y las fórmulas de Homebrew:

brew update
brew upgrade powershell-preview

Nota

Los comandos anteriores pueden llamarse desde dentro de un host de PowerShell (pwsh), pero, en este caso, es necesario salir y reiniciar el shell de PowerShell para completar la actualización. y actualice los valores mostrados en $PSVersionTable.

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

brew install powershell/tap/powershell-lts

Ahora puede comprobar la instalación.

pwsh

Cuando se publiquen nuevas versiones de PowerShell, ejecute el siguiente comando.

brew upgrade powershell-lts

Nota

Si usa el método Cask o TAP, al actualizar a una versión más reciente de PowerShell, use el mismo método que para instalar PowerShell inicialmente. Si usa otro método, al abrir una nueva sesión de pwsh seguirá usando la versión anterior de PowerShell.

Si decide usar métodos diferentes, hay formas de corregir el problema con el método de vínculo de 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 desde la página de versiones en el equipo. Los vínculos a las versiones actuales son:

Puede hacer doble clic en el archivo y seguir las indicaciones, o bien instalarlo desde el terminal mediante los siguientes comandos. Cambie el nombre del archivo para que coincida con el archivo que ha descargado.

sudo installer -pkg ./Downloads/powershell-7.4.6-osx-x64.pkg -target /

Si usa macOS Big Sur 11.5 o una versión posterior, es posible que reciba el mensaje de error siguiente al instalar el paquete:

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

Hay dos formas de evitar este problema:

Uso de Finder

  1. Busque el paquete en Finder.
  2. Haga clic con la tecla Control pulsada en el paquete.
  3. Seleccione Abrir en el menú contextual.

Desde la línea de comandos

  1. Ejecute sudo xattr -rd com.apple.quarantine ./Downloads/powershell-7.4.6-osx-x64.pkg. Si usa PowerShell 7 o superior, puede usar el cmdlet Unblock-File. Incluya la ruta de acceso completa al archivo .pkg.
  2. Instale el paquete como lo haría normalmente.

Nota

Se trata de un problema conocido relacionado con la certificación de paquetes que se solucionará en el futuro.

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. Debe poder iniciar 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. Al realizar la instalación con 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 desde la página de versiones en el equipo. 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.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

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 de PowerShell adicionales, consulte la sección de rutas de acceso de este documento y elimine las rutas de acceso deseadas mediante sudo rm.

Nota

Este paso no es necesario si ha realizado la instalación con Homebrew.

Rutas de acceso

  • $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 registrará 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:

Compatibilidad con la instalación

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

Recursos adicionales