Instalación del módulo Azure Az PowerShell

En este artículo se explica cómo instalar el módulos Azure Az PowerShell con PowerShellGet. Estas instrucciones funcionan en plataformas Windows, macOS y Linux.

El módulo Azure Az PowerShell está preinstalado en Azure Cloud Shell y en las imágenes de Docker.

El módulo Azure Az PowerShell es un módulo acumulativo. Al instalarlo, se descargan todos los módulos Az PowerShell disponibles con carácter general, y sus cmdlets están disponibles para su uso.

Requisitos

Nota

PowerShell 7.x (y versiones posteriores) es la versión recomendada para usar con el módulo Azure Az PowerShell en todas las plataformas.

El módulo Azure Az PowerShell funciona con PowerShell 7.x y versiones posteriores en todas las plataformas. No hay ningún requisito adicional para Azure PowerShell cuando se ejecuta en PowerShell 7.x y versiones posteriores.

Para comprobar la versión de PowerShell, ejecute el siguiente comando desde una sesión de PowerShell:

$PSVersionTable.PSVersion

La directiva de ejecución de scripts de PowerShell debe establecerse en remota firmada o menos restrictiva. Get-ExecutionPolicy -List puede usarse para determinar la directiva de ejecución actual. Para obtener más información, vea about_Execution_Policies.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Instalación

El uso del cmdlet Install-Module es el método de instalación preferido para el módulo Az PowerShell. Instale el Módulo Az solo para el usuario actual. Este es el ámbito de instalación recomendado. Este método funciona igual en plataformas Windows, macOS y Linux. Ejecute el siguiente comando desde una sesión de PowerShell:

Install-Module -Name Az -Scope CurrentUser -Repository PSGallery -Force

Otras opciones de instalación

Aunque PowerShell 7.x es la versión recomendada de PowerShell y Install-Module es la opción de instalación recomendada, hay otras opciones de instalación.

Instalación en Windows PowerShell

El módulo Azure Az PowerShell también se admite con PowerShell 5.1 en Windows. Para usar módulo Azure Az PowerShell en PowerShell 5.1 en Windows:

  1. Actualice a Windows PowerShell 5.1. Si tiene Windows 10 versión 1607 o posteriores, ya tiene PowerShell 5.1 instalado.
  2. Instale .NET Framework 4.7.2 o posterior.
  3. Asegúrese de tener instalada la versión más reciente de PowerShellGet. Ejecute Install-Module -Name PowerShellGet -Force.

Instalación sin conexión

En algunos entornos no es posible conectarse a la Galería de PowerShell. En esos casos, puede instalar el módulo Az PowerShell sin conexión con uno de estos métodos:

  • Descargue el paquete MSI de Azure PowerShell. Tenga en cuenta que el instalador MSI solo funciona para PowerShell 5.1 en Windows.
  • Descargue los módulos en otra ubicación de la red y úselos como origen de la instalación. 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. Obtenga información sobre cómo configurar un repositorio local e instalar en sistemas desconectados con Trabajo con repositorios de PowerShellGet locales.
  • 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.

Iniciar sesión

Para empezar a trabajar con Azure PowerShell, inicie sesión con sus credenciales de Azure.

Connect-AzAccount

Después de ejecutar este comando, aparece una nueva ventana del explorador y puede iniciar sesión en la cuenta de Azure.

Actualización del módulo de Azure PowerShell

Para actualizar cualquier módulo de PowerShell, debe usar el mismo método que se usa para instalar el módulo. Por ejemplo, si originalmente usó Install-Module, debe usar Update-Module para obtener la versión más reciente. Si originalmente usó el paquete MSI, debe descargar e instalar el nuevo MSI para realizar la actualización.

Los cmdlets de PowerShellGet no pueden actualizar los módulos que se instalaron desde un paquete MSI. Los paquetes MSI no actualizan los módulos que se instalaron con PowerShellGet. Si tiene algún problema para actualizar con PowershellGet, debe reinstalar en lugar de actualizar. La reinstalación se realiza de la misma manera que la instalación. Asegúrese de usar el parámetro Force con Install-Module al reinstalar.

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. Si quiere quitar las versiones anteriores del módulo Az PowerShell de su sistema, consulte Desinstalación del módulo de Azure PowerShell. Para más información acerca de las instalaciones basadas en MSI, consulte Instalación de Azure PowerShell con un MSI.

Solución de problemas

Estos son algunos problemas comunes que se han observado al instalar el módulo Azure Az PowerShell. Si tiene algún problema que no se trata aquí, abra una incidencia en GitHub.

Coexistencia de Az y AzureRM

Advertencia

No se pueden tener los módulos AzureRM y Az instalados al mismo tiempo para PowerShell 5.1 en Windows.

Si quiere instalar tanto AzureRM como el módulo Az PowerShell en el mismo sistema, AzureRM debe instalarse solo en el ámbito de usuario de Windows PowerShell. Instale el módulo Az PowerShell para PowerShell 7.x en el mismo sistema.

Importante

Como los módulos de Az PowerShell ya tienen todas las funcionalidades de los de AzureRM PowerShell, incluso más, el 29 de febrero de 2024 se van a retirar estos últimos.

Para evitar interrupciones del servicio, actualice los scripts que usan los módulos de AzureRM PowerShell para que utilicen los de Az PowerShell antes del 29 de febrero de 2024. Para actualizar automáticamente los scripts, siga la guía de inicio rápido.

El servidor proxy bloquea la conexión

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. Sistemas operativos diferentes tendrán requisitos diferentes para configurar un servidor proxy de todo el sistema. Póngase en contacto con el administrador del sistema para la configuración del proxy y para saber cómo configurarlos en su entorno.

PowerShell no puede configurarse para usar este proxy automáticamente. Con PowerShell 5.1 y versiones posteriores, use los siguientes comandos para configurar la sesión de PowerShell para que use un servidor proxy:

$webClient = New-Object -TypeName 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. Para que esta configuración se conserve entre sesiones, agregue los comandos a un perfil de PowerShell.

Para instalar el paquete, el servidor proxy debe permitir las conexiones HTTPS a https://www.powershellgallery.com.

Envío de comentarios

Si encuentra un error en el módulo Azure Az PowerShell, abra una incidencia en GitHub. Para enviar comentarios desde una sesión de PowerShell, use el cmdlet Send-Feedback.

Pasos siguientes

Para más información sobre los módulos Azure Az PowerShell y sus características, consulte Introducción a Azure PowerShell. Si está familiarizado con Azure PowerShell y tiene que migrar desde AzureRM, consulte Migración desde AzureRM a Az.