Instalar Azure PowershellInstall Azure PowerShell

En este artículo se explica cómo instalar los módulos de Azure PowerShell con PowerShellGet.This article explains how to install the Azure PowerShell modules using PowerShellGet. Estas instrucciones funcionan en plataformas Windows, macOS y Linux.These instructions work on Windows, macOS, and Linux platforms.

Azure PowerShell también está disponible en Azure Cloud Shell y ahora está preinstalado en las imágenes de Docker.Azure PowerShell is also available in Azure Cloud Shell and is now preinstalled in Docker images.

RequisitosRequirements

Nota

PowerShell 7.x (y versiones posteriores) es la versión recomendada para usar con Azure PowerShell en todas las plataformas.PowerShell 7.x and later is the recommended version of PowerShell for use with Azure PowerShell on all platforms.

Azure PowerShell funciona con PowerShell 6.2.4 y versiones posteriores en todas las plataformas.Azure PowerShell works with PowerShell 6.2.4 and later on all platforms. También se admite con PowerShell 5.1 en Windows.It is also supported with PowerShell 5.1 on Windows. Instale la última versión de PowerShell que haya disponible para su sistema operativo.Install the latest version of PowerShell available for your operating system. No hay ningún requisito adicional para Azure PowerShell cuando se ejecuta en PowerShell 6.2.4 y versiones posteriores.Azure PowerShell has no additional requirements when run on PowerShell 6.2.4 and later.

Para comprobar la versión de PowerShell, ejecute el comando:To check your PowerShell version, run the command:

$PSVersionTable.PSVersion

Para usar Azure PowerShell en PowerShell 5.1 en Windows:To use Azure PowerShell in PowerShell 5.1 on Windows:

  1. Actualice a Windows PowerShell 5.1.Update to Windows PowerShell 5.1. Si tiene Windows 10 versión 1607 o posteriores, ya tiene PowerShell 5.1 instalado.If you're on Windows 10 version 1607 or higher, you already have PowerShell 5.1 installed.
  2. Instale .NET Framework 4.7.2 o posterior.Install .NET Framework 4.7.2 or later.
  3. Asegúrese de tener instalada la versión más reciente de PowerShellGet.Make sure you have the latest version of PowerShellGet. Ejecute Install-Module -Name PowerShellGet -Force.Run Install-Module -Name PowerShellGet -Force.

Instalación del módulo de Azure PowerShellInstall the Azure PowerShell module

Advertencia

No se pueden tener los módulos AzureRM y Az instalados al mismo tiempo para PowerShell 5.1 en Windows.We do not support having both the AzureRM and Az modules installed for PowerShell 5.1 on Windows at the same time. Si necesita mantener AzureRM disponible en el sistema, instale el módulo Az para PowerShell 6.2.4 o versiones posteriores.If you need to keep AzureRM available on your system, install the Az module for PowerShell 6.2.4 or later.

El método de instalación preferido es mediante los cmdlets de PowerShellGet.Using the PowerShellGet cmdlets is the preferred installation method. Instale el Módulo Az solo para el usuario actual.Install the Az module for the current user only. Este es el ámbito de instalación recomendado.This is the recommended installation scope. Este método funciona igual en plataformas Windows, macOS y Linux.This method works the same on Windows, macOS, and Linux platforms. Ejecute el siguiente comando desde una sesión de PowerShell:Run the following command from a PowerShell session:

if ($PSVersionTable.PSEdition -eq 'Desktop' -and (Get-Module -Name AzureRM -ListAvailable)) {
    Write-Warning -Message ('Az module not installed. Having both the AzureRM and ' +
      'Az modules installed at the same time is not supported.')
} else {
    Install-Module -Name Az -AllowClobber -Scope CurrentUser
}

De forma predeterminada, la Galería de PowerShell no está configurada como un repositorio de confianza para PowerShellGet.By default, the PowerShell gallery isn't configured as a trusted repository for PowerShellGet. La primera vez que use PSGallery verá el siguiente mensaje:The first time you use the PSGallery you see the following prompt:

Untrusted repository

You are installing the modules from an untrusted repository. If you trust this repository, change
its InstallationPolicy value by running the `Set-PSRepository` cmdlet.

Are you sure you want to install the modules from 'PSGallery'?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"):

Responda Yes o Yes to All para continuar con la instalación.Answer Yes or Yes to All to continue with the installation.

Para instalar el módulo para todos los usuarios de un sistema se necesitan privilegios elevados.Installing the module for all users on a system requires elevated privileges. Inicie la sesión de PowerShell mediante Ejecutar como administrador en Windows o use el comando sudo en macOS o Linux:Start the PowerShell session using Run as administrator in Windows or use the sudo command on macOS or Linux:

if ($PSVersionTable.PSEdition -eq 'Desktop' -and (Get-Module -Name AzureRM -ListAvailable)) {
    Write-Warning -Message ('Az module not installed. Having both the AzureRM and ' +
      'Az modules installed at the same time is not supported.')
} else {
    Install-Module -Name Az -AllowClobber -Scope AllUsers
}

El módulo Az es un módulo acumulativo para los cmdlets de Azure PowerShell.The Az module is a rollup module for the Azure PowerShell cmdlets. Al instalarlo, se descargan todos los módulos de Az PowerShell disponibles con carácter general, y hace que sus cmdlets estén disponibles para su uso.Installing it downloads all of the generally available Az PowerShell modules, and makes their cmdlets available for use.

Instalar sin conexiónInstall offline

En algunos entornos no es posible conectarse a la Galería de PowerShell.In some environments, it's not possible to connect to the PowerShell Gallery. En esos casos, puede instalar sin conexión mediante uno de estos métodos:In those situations, you can still install offline using one of these methods:

  • Descargue los módulos en otra ubicación de la red y úselos como origen de la instalación.Download the modules to another location in your network and use that as an installation source. Este método le permite almacenar en caché, en un solo servidor o recurso compartido de archivos, los módulos de PowerShell que se van a implementar con PowerShellGet en los sistemas desconectados.This method allows you to cache PowerShell modules on a single server or file share to be deployed with PowerShellGet to any disconnected systems. Obtenga información sobre cómo configurar un repositorio local e instalar en sistemas desconectados con Trabajo con repositorios de PowerShellGet locales.Learn how to set up a local repository and install on disconnected systems with Working with local PowerShellGet repositories.

  • Descargue el instalador MSI de Azure PowerShell en un equipo conectado a la red y, a continuación, copie el instalador en los sistemas sin acceso a la Galería de PowerShell.Download the Azure PowerShell MSI to a machine connected to the network, and then copy the installer to systems without access to PowerShell Gallery. Tenga en cuenta que el instalador MSI solo funciona para PowerShell 5.1 en Windows.Keep in mind that the MSI installer only works for PowerShell 5.1 on Windows.

  • Guarde el módulo con Save-Module en un recurso compartido de archivos, o bien guárdelo en otro origen y cópielo manualmente en otras máquinas:Save the module with Save-Module to a file share, or save it to another source and manually copy it to other machines:

    Save-Module -Name Az -Path '\\server\share\PowerShell\modules' -Force
    

Solución de problemasTroubleshooting

Estos son algunos problemas comunes que se han observado cuando se instala el módulo Azure PowerShell.Here are some common problems seen when installing the Azure PowerShell module. Si tiene algún problema que no se trata aquí, abra una incidencia en GitHub.If you experience a problem not listed here, file an issue on GitHub.

El servidor proxy bloquea la conexiónProxy blocks connection

Si se producen errores en Install-Module que indican que la Galería de PowerShell es inaccesible, es posible que esté detrás de un proxy.If you get errors from Install-Module that indicate the PowerShell Gallery is unreachable, you may be behind a proxy. Sistemas operativos diferentes tendrán requisitos diferentes para configurar un servidor proxy de todo el sistema.Different operating systems and network environment have different requirements for configuring a system-wide proxy. Póngase en contacto con el administrador del sistema para la configuración del proxy y para saber cómo configurarlos en su entorno.Contact your system administrator for your proxy settings and how to configure them for your environment.

PowerShell no puede configurarse para usar este proxy automáticamente.PowerShell itself may not be configured to use this proxy automatically. Con PowerShell 5.1 y versiones posteriores, use los siguientes comandos para configurar la sesión de PowerShell para que use un servidor proxy:With PowerShell 5.1 and later, configure the PowerShell session to use a proxy using the following commands:

$webClient = New-Object System.Net.WebClient
$webClient.Proxy.Credentials = [System.Net.CredentialCache]::DefaultNetworkCredentials

Si las credenciales del sistema operativo están configuradas correctamente, esta configuración enruta las solicitudes de PowerShell a través del proxy.If your operating system credentials are configured correctly, this configuration routes PowerShell requests through the proxy. Para que esta configuración se conserve entre sesiones, agregue los comandos a un perfil de PowerShell.To have this setting persist between sessions, add the commands to your PowerShell profile.

Para instalar el paquete, el servidor proxy debe permitir las conexiones HTTPS a las siguientes direcciones:To install the package, your proxy needs to allow HTTPS connections to the following address:

  • https://www.powershellgallery.com

Iniciar sesiónSign in

Para empezar a trabajar con Azure PowerShell, inicie sesión con sus credenciales de Azure.To start working with Azure PowerShell, sign in with your Azure credentials.

# Connect to Azure with a browser sign in token
Connect-AzAccount

Nota

Si ha deshabilitado la carga automática de módulos, importe el módulo manualmente con Import-Module -Name Az.If you've disabled module autoloading, manually import the module with Import-Module -Name Az. Debido al modo en que el módulo está estructurado, esto puede tardar unos segundos.Because of the way the module is structured, this can take a few seconds.

Deberá repetir estos pasos para cada nueva sesión de PowerShell que inicie.You'll need to repeat these steps for every new PowerShell session you start. Para más información sobre cómo conservar el inicio de sesión de Azure entre sesiones de PowerShell, consulte Conservación de las credenciales de usuario entre las sesiones de PowerShell.To learn how to persist your Azure sign in across PowerShell sessions, see Persist user credentials across PowerShell sessions.

Actualización del módulo de Azure PowerShellUpdate the Azure PowerShell module

Para actualizar cualquier módulo de PowerShell, debe usar el mismo método que se usa para instalar el módulo.To update any PowerShell module, you should use the same method used to install the module. Por ejemplo, si originalmente usó Install-Module, debe usar Update-Module para obtener la versión más reciente.For example, if you originally used Install-Module, then you should use Update-Module to get the latest version. Si originalmente usó el paquete MSI, debe descargar e instalar el nuevo MSI para realizar la actualización.If you originally used the MSI package then you should download and install the new MSI package.

Los cmdlets de PowerShellGet no pueden actualizar los módulos que se instalaron desde un paquete MSI.The PowerShellGet cmdlets cannot update modules that were installed from an MSI package. Los paquetes MSI no actualizan los módulos que se instalaron con PowerShellGet.MSI packages do not update modules that were installed using PowerShellGet. Si tiene algún problema para actualizar con PowershellGet, debe reinstalar en lugar de actualizar.If you have any issues updating using PowershellGet, then you should reinstall, rather than update. Esto se hace de la misma manera que la instalación, pero es posible que tenga que agregar el parámetro -Force:Reinstalling is done the same way as installing, but you need to add the -Force parameter:

if ($PSVersionTable.PSEdition -eq 'Desktop' -and (Get-Module -Name AzureRM -ListAvailable)) {
    Write-Warning -Message ('Az module not installed. Having both the AzureRM and ' +
      'Az modules installed at the same time is not supported.')
} else {
    Install-Module -Name Az -AllowClobber -Force
}

A diferencia de las instalaciones basadas en MSI, al instalar o actualizar con PowerShellGet no se quitan las versiones anteriores que pueda haber en el sistema.Unlike MSI-based installations, installing or updating using PowerShellGet does not remove older versions that may exist on your system. Si quiere quitar las versiones anteriores de Azure PowerShell de su sistema, consulte Desinstalación del módulo de Azure PowerShell.To remove old versions of Azure PowerShell from your system, see Uninstall the Azure PowerShell module. Para más información acerca de las instalaciones basadas en MSI, consulte Instalación de Azure PowerShell con un MSI.For more information about MSI-based installations, see Install Azure PowerShell with an MSI.

Uso de varias versiones de Azure PowerShellUse multiple versions of Azure PowerShell

Se pueden instalar varias versiones de Azure PowerShell.It's possible to install more than one version of Azure PowerShell. Para comprobar si tiene varias versiones de Azure PowerShell instaladas, use el siguiente comando:To check if you have multiple versions of Azure PowerShell installed, use the following command:

Get-InstalledModule -Name Az -AllVersions | Select-Object -Property Name, Version

Para eliminar una versión de Azure PowerShell, consulte Desinstalación del módulo de Azure PowerShell.To remove a version of Azure PowerShell, see Uninstall the Azure PowerShell module.

Si tiene más de una versión del módulo instalada, la función de carga automática del módulo y Import-Module cargarán la versión más reciente de forma predeterminada.If you have more than one version of the module installed, module autoload and Import-Module load the latest version by default.

Para instalar o cargar una versión específica del módulo Az, use el parámetro -RequiredVersion:You can install or load a specific version of the Az module using the -RequiredVersion parameter:

# Install Az version 3.6.1
Install-Module -Name Az -RequiredVersion 3.6.1
# Load Az version 3.6.1
Import-Module -Name Az -RequiredVersion 3.6.1

Uso de varios repositorios con PowerShellGetUse multiple repositories with PowerShellGet

El parámetro Repository es necesario si ha agregado repositorios adicionales a PowerShellGet en el sistema y el módulo Az puede encontrarse en más de uno de ellos.The Repository parameter is required if you have added additional repositories to PowerShellGet on your system and the Az module can be found in more than one of them.

if ($PSVersionTable.PSEdition -eq 'Desktop' -and (Get-Module -Name AzureRM -ListAvailable)) {
    Write-Warning -Message 'Az module not installed. Having both the AzureRM and Az modules installed at the same time is not supported.'
} else {
    Install-Module -Name Az -Repository PSGallery -AllowClobber -Force
}

Envío de comentariosProvide feedback

Si encuentra un error en Azure PowerShell, abra una incidencia en GitHub.If you find a bug in Azure PowerShell, file an issue on GitHub. Para enviar sus comentarios desde la línea de comandos, use el cmdlet Send-Feedback.To provide feedback from the command line, use the Send-Feedback cmdlet.

Pasos siguientesNext Steps

Para más información sobre los módulos de Azure PowerShell y sus características, consulte Introducción a Azure PowerShell.To learn more about the Azure PowerShell modules and their features, see Get Started with Azure PowerShell. Si está familiarizado con Azure PowerShell y tiene que migrar desde AzureRM, consulte Migración desde AzureRM a Az.If you're familiar with Azure PowerShell and need to migrate from AzureRM, see Migrate from AzureRM to Az.