Instalación de PowerShell en macOS

PowerShell 7.0 o posteriores requiere macOS 10.13 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.2 es una actualización local que quita las versiones anteriores de PowerShell 6.x y 7.x.

La carpeta /usr/local/microsoft/powershell/6 se reemplaza por /usr/local/microsoft/powershell/7.

Si tiene que ejecutar una versión anterior de PowerShell en paralelo con PowerShell 7.2, instale la versión que quiere con el método de archivo binario.

Instalación de la versión estable más reciente a través de Homebrew en macOS 10.13 o posterior

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)"

Ahora puede instalar PowerShell:

brew install --cask 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 --cask

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 a través de Homebrew en macOS 10.13 o posterior

Una vez instalado Homebrew, puede instalar PowerShell. En primer lugar, instale el paquete Cask-Versions que le permite instalar versiones alternativas de los paquetes de cask:

brew tap homebrew/cask-versions

Ahora puede instalar PowerShell:

brew install --cask powershell-preview

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

pwsh-preview

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

brew update
brew upgrade powershell-preview --cask

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.

La instalación de PowerShell mediante el método TAP de Homebrew también se admite para las versiones estable y LTS.

brew install powershell/tap/powershell

Ahora puede comprobar la instalación.

pwsh

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

brew upgrade powershell

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

PowerShell 7.2 agrega compatibilidad con el procesador M1 de Apple. 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 powershell-7.2.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:

"powershell-7.2.6-osx-x64.pkg" no se puede abrir 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 powershell-7.2.6-osx-x64.pkg. 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.

Instale OpenSSL. OpenSSL se necesita para la comunicación remota de PowerShell y las operaciones de CIM.

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 está ejecutando actualmente no tiene PATHactualizado. Debe poder iniciar PowerShell desde un nuevo shell escribiendo pwsh.

Instale OpenSSL. OpenSSL se necesita para la comunicación remota de PowerShell y las operaciones de CIM.

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.

Instale OpenSSL. OpenSSL se necesita para la comunicación remota de PowerShell y las operaciones de CIM.

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.2.6/powershell-7.2.6-osx-x64.tar.gz

# Create the target folder where powershell is placed
sudo mkdir -p /usr/local/microsoft/powershell/7.2.6

# Expand powershell to the target folder
sudo tar zxf /tmp/powershell.tar.gz -C /usr/local/microsoft/powershell/7.2.6

# Set execute permissions
sudo chmod +x /usr/local/microsoft/powershell/7.2.6/pwsh

# Create the symbolic link that points to pwsh
sudo ln -s /usr/local/microsoft/powershell/7.2.6/pwsh /usr/local/bin/pwsh

Instalación de dependencias

Se necesita OpenSSL para la comunicación remota de PowerShell y las operaciones de CIM. Puede instalar OpenSSL mediante MacPorts si fuera necesario.

Nota

MacPorts y Homebrew pueden tener problemas cuando se usan juntos en el mismo sistema. Sin embargo, Homebrew no tiene un paquete para OpenSSL 1.0. Para obtener más información, consulte las Preguntas frecuentes sobre MacPorts.

  1. Instale las herramientas de la línea de comandos de Xcode. MacPorts requiere las herramientas de Xcode.

    xcode-select --install
    
  2. Instale MacPorts. Si necesita instrucciones, consulte la guía de instalación.

  3. Actualice MacPorts mediante la ejecución de sudo port selfupdate.

  4. Actualice los paquetes de MacPorts mediante la ejecución de sudo port upgrade outdated.

  5. Instale OpenSSL:

    • Para sistemas basados en x64, ejecute sudo port install openssl10.
    • Para sistemas basados en M1, ejecute sudo port install openssl10 +universal.
  6. Vincule las bibliotecas para que estén a disposición de PowerShell:

    sudo mkdir -p /usr/local/opt/openssl
    sudo ln -s /opt/local/lib/openssl-1.0 /usr/local/opt/openssl/lib
    

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.2.6/.
  • 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.

Los perfiles respetan la configuración por host de PowerShell. Así que el perfil predeterminado específico del host está en Microsoft.PowerShell_profile.ps1 en las mismas ubicaciones.

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

Dado que macOS es una derivación de BSD, se usa el prefijo /usr/local en lugar de /opt. Por lo tanto, $PSHOME es /usr/local/microsoft/powershell/7.2.6/, y el vínculo simbólico se coloca en /usr/local/bin/pwsh.

Versiones compatibles

La tabla siguiente contiene una lista de versiones de PowerShell y el estado de compatibilidad con versiones de macOS. Estas versiones se seguirán admitiendo hasta que la versión de macOS o la de PowerShell llegue al final del soporte técnico.

  • ✅ indica que la versión del sistema operativo o PowerShell todavía recibe soporte técnico
  • ❌ indica que la versión del sistema operativo o PowerShell no se admite
  • 🟡 indica que la versión de PowerShell ya no se admite en esa versión del sistema operativo
  • Cuando tanto la versión del sistema operativo como la de PowerShell tienen ✅, esa combinación se admite
macOS 7.0 (LTS) 7.1 7.2 (LTS-Current) 7.3 (versión preliminar)
✅ macOS Big Sur 11.5 🟡
✅ macOS Catalina 10.15 🟡
✅ macOS Mojave 10.14 🟡
✅ macOS High Sierra 10.13 🟡

macOS Monterey 12.0 todavía no se ha sometido a pruebas.

Apple define la compatibilidad con macOS. Para más información, consulte:

PowerShell recibe soporte técnico en macOS para las siguientes arquitecturas de procesador:

macOS 7.0 (LTS) 7.2 (LTS-Current) 7.3 (versión preliminar)
macOS Big Sur 11.5 x64 x64, Arm64 x64, Arm64
macOS High Sierra 10.13+ x64 x64 x64

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