Instalación de PowerShell en macOSInstalling PowerShell on macOS

PowerShell 7.0 o posteriores requiere macOS 10.13 y versiones posteriores.PowerShell 7.0 or higher require macOS 10.13 and higher. Todos los paquetes están disponibles en nuestra página de versiones de GitHub.All packages are available on our GitHub releases page. Una vez instalado el paquete, ejecute pwsh desde un terminal.After the package is installed, run pwsh from a terminal.

Nota

PowerShell 7.1 es una actualización local que quita PowerShell Core 6.x y 7.0.PowerShell 7.1 is an in-place upgrade that removes PowerShell Core 6.x and 7.0.

La carpeta /usr/local/microsoft/powershell/6 se reemplaza por /usr/local/microsoft/powershell/7.The /usr/local/microsoft/powershell/6 folder is replaced by /usr/local/microsoft/powershell/7.

Si tiene que ejecutar y una versión anterior de PowerShell Core en paralelo con PowerShell 7.1, instale la versión que quiera con el método de archivo binario.If you need to run and older version of PowerShell core side-by-side with PowerShell 7.1, install the version you want using the binary archive method.

Existen varias maneras de instalar PowerShell en macOS.There are several ways to install PowerShell on macOS. Elija uno de los métodos siguientes:Choose one of the following methods:

  • Realice la instalación mediante Homebrew.Install using Homebrew. Homebrew es el administrador de paquetes preferido de macOS.Homebrew is the preferred package manager for macOS.
  • Realice la instalación de PowerShell mediante descarga directa.Install PowerShell via Direct Download
  • Realice la instalación a partir de archivos binarios.Install from binary archives.

Después de instalar PowerShell, debe instalar OpenSSL.After installing PowerShell, you should install OpenSSL. OpenSSL se necesita para la comunicación remota de PowerShell y las operaciones de CIM.OpenSSL is needed for PowerShell remoting and CIM operations.

Instalación de la versión estable más reciente a través de Homebrew en macOS 10.13 o posteriorInstallation of latest stable release via Homebrew on macOS 10.13 or higher

Si no se encuentra el comando brew, debe instalar Homebrew según sus instrucciones.If the brew command is not found, you need to install Homebrew following their instructions.

Ahora puede instalar PowerShell:Now, you can install PowerShell:

brew install --cask powershell

Por último, compruebe que la instalación funciona correctamente:Finally, verify that your install is working properly:

pwsh

Cuando se publiquen nuevas versiones de PowerShell, actualice PowerShell y las fórmulas de Homebrew:When new versions of PowerShell are released, update Homebrew's formulae and upgrade PowerShell:

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.The commands above can be called from within a PowerShell (pwsh) host, but then the PowerShell shell must be exited and restarted to complete the upgrade and refresh the values shown in $PSVersionTable.

Instalación de la versión preliminar más reciente a través de Homebrew en macOS 10.13 o posteriorInstallation of latest preview release via Homebrew on macOS 10.13 or higher

Una vez instalado Homebrew, puede instalar PowerShell.After you've installed Homebrew, you can install PowerShell. En primer lugar, instale el paquete Cask-Versions que le permite instalar versiones alternativas de los paquetes de cask:First, install the Cask-Versions package that lets you install alternative versions of cask packages:

brew tap homebrew/cask-versions

Ahora puede instalar PowerShell:Now, you can install PowerShell:

brew install --cask powershell-preview

Por último, compruebe que la instalación funciona correctamente:Finally, verify that your install is working properly:

pwsh-preview

Cuando se publiquen nuevas versiones de PowerShell, actualice PowerShell y las fórmulas de Homebrew:When new versions of PowerShell are released, update Homebrew's formulae and upgrade PowerShell:

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.The commands above can be called from within a PowerShell (pwsh) host, but then the PowerShell shell must be exited and restarted to complete the upgrade. y actualice los valores mostrados en $PSVersionTable.and refresh the values shown in $PSVersionTable.

La instalación de PowerShell mediante el método TAP de Homebrew también se admite para las versiones estable y LTS.Installing PowerShell using the Homebrew tap method is also supported for stable and LTS versions.

brew install powershell/tap/powershell

Ahora puede comprobar la instalación.You can now verify your install

pwsh

Cuando se publiquen nuevas versiones de PowerShell, solo tendrá que ejecutar el siguiente comando.When new versions of PowerShell are released, simply run the following command.

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.Whether you use the cask or the tap method, when updating to a newer version of PowerShell, use the same method you used to initially install PowerShell. Si usa otro método, al abrir una nueva sesión de pwsh seguirá usando la versión anterior de PowerShell.If you use a different method, opening a new pwsh session will continue to use the older version of PowerShell.

Si decide usar métodos diferentes, hay formas de corregir el problema con el método de vínculo de Homebrew.If you do decide to use different methods, there are ways to correct the issue using the Homebrew link method.

Instalación mediante descarga directaInstallation via Direct Download

Descargue el paquete PKG powershell-7.1.0-osx-x64.pkg de la página de versiones en la máquina macOS.Download the PKG package powershell-7.1.0-osx-x64.pkg from the releases page onto your macOS machine.

Puede hacer doble clic en el archivo y seguir las indicaciones, o bien instalarlo desde el terminal:You can double-click the file and follow the prompts, or install it from the terminal:

sudo installer -pkg powershell-7.1.0-osx-x64.pkg -target /

Instale OpenSSL.Install OpenSSL. OpenSSL se necesita para la comunicación remota de PowerShell y las operaciones de CIM.OpenSSL is needed for PowerShell remoting and CIM operations.

Instalación como una herramienta global de .NETInstall as a .NET Global tool

Si ya tiene instalado el SDK de .NET Core, es fácil instalar PowerShell como una herramienta global de .NET.If you already have the .NET Core SDK installed, it's easy to install PowerShell as a .NET Global tool.

dotnet tool install --global PowerShell

El instalador de la herramienta dotnet agrega ~/.dotnet/tools a la variable de entorno PATH.The dotnet tool installer adds ~/.dotnet/tools to your PATH environment variable. Sin embargo, el shell que se está ejecutando actualmente no tiene PATHactualizado.However, the currently running shell does not have the updated PATH. Debe poder iniciar PowerShell desde un nuevo shell escribiendo pwsh.You should be able to start PowerShell from a new shell by typing pwsh.

Instale OpenSSL.Install OpenSSL. OpenSSL se necesita para la comunicación remota de PowerShell y las operaciones de CIM.OpenSSL is needed for PowerShell remoting and CIM operations.

Archivos binariosBinary Archives

Se proporcionan archivos binarios tar.gz de PowerShell para la plataforma macOS, a fin de permitir escenarios de implementación avanzados.PowerShell binary tar.gz archives are provided for the macOS platform to enable advanced deployment scenarios. Al realizar la instalación con este método, también debe instalar manualmente las dependencias.When you install using this method you must also manually install any dependencies.

Instale OpenSSL.Install OpenSSL. OpenSSL se necesita para la comunicación remota de PowerShell y las operaciones de CIM.OpenSSL is needed for PowerShell remoting and CIM operations.

Instalación de archivos binarios en macOSInstalling binary archives on macOS

# Download the powershell '.tar.gz' archive
curl -L -o /tmp/powershell.tar.gz https://github.com/PowerShell/PowerShell/releases/download/v7.1.0/powershell-7.1.0-osx-x64.tar.gz

# Create the target folder where powershell will be placed
sudo mkdir -p /usr/local/microsoft/powershell/7.1.0

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

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

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

Instalación de dependenciasInstalling dependencies

Se necesita OpenSSL para la comunicación remota de PowerShell y las operaciones de CIM.OpenSSL is required for PowerShell remoting and CIM operations. Puede instalar OpenSSL mediante MacPorts si fuera necesario.You can install OpenSSL via MacPorts if needed.

Nota

MacPorts y Homebrew pueden tener problemas cuando se usan juntos en el mismo sistema.MacPorts and Homebrew can have problems when used to together on the same system. Sin embargo, Homebrew no tiene un paquete para OpenSSL 1.0.However, Homebrew does not have a package for OpenSSL 1.0. Para obtener más información, consulte las Preguntas frecuentes sobre MacPorts.For more information, see the MacPorts FAQ.

  1. Instale las herramientas de la línea de comandos de Xcode.Install the Xcode command-line tools. MacPorts requiere las herramientas de Xcode.The Xcode tools are required by MacPorts.

    xcode-select --install
    
  2. Instale MacPorts.Install MacPorts. Si necesita instrucciones, consulte la guía de instalación.If you need instructions, refer to the installation guide.

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

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

  5. Instale OpenSSL mediante la ejecución de sudo port install openssl10.Install OpenSSL by running sudo port install openssl10.

  6. Vincule las bibliotecas para que estén a disposición de PowerShell:Link the libraries to make them available to 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 PowerShellUninstalling PowerShell

Si ha instalado PowerShell con Homebrew, use el siguiente comando para desinstalar:If you installed PowerShell with Homebrew, use the following command to uninstall:

brew cask uninstall powershell

Si ha instalado PowerShell mediante descarga directa, deberá quitar PowerShell manualmente:If you installed PowerShell via direct download, PowerShell must be removed manually:

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.To remove the additional PowerShell paths, refer to the paths section in this document and remove the paths using sudo rm.

Nota

Este paso no es necesario si ha realizado la instalación con Homebrew.This is not necessary if you installed with Homebrew.

Rutas de accesoPaths

  • $PSHOME es /usr/local/microsoft/powershell/7.1.0/.$PSHOME is /usr/local/microsoft/powershell/7.1.0/
  • Los perfiles de usuario se leerán de ~/.config/powershell/profile.ps1.User profiles will be read from ~/.config/powershell/profile.ps1
  • Los perfiles predeterminados se leerán de $PSHOME/profile.ps1.Default profiles will be read from $PSHOME/profile.ps1
  • Los módulos de usuario se leerán de ~/.local/share/powershell/Modules.User modules will be read from ~/.local/share/powershell/Modules
  • Los módulos compartidos se leerán de /usr/local/share/powershell/Modules.Shared modules will be read from /usr/local/share/powershell/Modules
  • Los módulos predeterminados se leerán de $PSHOME/Modules.Default modules will be read from $PSHOME/Modules
  • El historial de PSReadline se grabará en ~/.local/share/powershell/PSReadLine/ConsoleHost_history.txt.PSReadline history will be recorded to ~/.local/share/powershell/PSReadLine/ConsoleHost_history.txt

Los perfiles respetan la configuración por host de PowerShell.The profiles respect PowerShell's per-host configuration. Así que el perfil predeterminado específico del host está en Microsoft.PowerShell_profile.ps1 en las mismas ubicaciones.So the default host-specific profile exists at Microsoft.PowerShell_profile.ps1 in the same locations.

PowerShell respeta la especificación de directorio base de XDG en macOS.PowerShell respects the XDG Base Directory Specification on macOS.

Dado que macOS es una derivación de BSD, se usa el prefijo /usr/local en lugar de /opt.Because macOS is a derivation of BSD, the prefix /usr/local is used instead of /opt. Por lo tanto, $PSHOME es /usr/local/microsoft/powershell/7.1.0/, y el vínculo simbólico se coloca en /usr/local/bin/pwsh.So, $PSHOME is /usr/local/microsoft/powershell/7.1.0/, and the symbolic link is placed at /usr/local/bin/pwsh.

Compatibilidad con la instalaciónInstallation support

Microsoft admite los métodos de instalación de este documento,Microsoft supports the installation methods in this document. aunque puede haber otros disponibles desde otros orígenes.There may be other methods of installation available from other sources. Si bien esas herramientas y métodos pueden funcionar, Microsoft no los admite.While those tools and methods may work, Microsoft cannot support those methods.

Recursos adicionalesAdditional Resources