Instalación del módulo Azure Az PowerShell

En este artículo se explica cómo instalar el módulo Azure Az PowerShell desde la Galería de PowerShell. Estas instrucciones funcionan en plataformas Windows, Linux y macOS.

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.0.6 LTS, PowerShell 7.1.3, o cualquier versión superior, son las versiones recomendadas para usarlas con el módulo Azure Az PowerShell en todas las plataformas.

No hay ningún requisito adicional para Azure PowerShell cuando se ejecuta en PowerShell 7.0.6 LTS y PowerShell 7.1.3, o cualquier versión superior.

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, Linux y macOS. 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.0.6 LTS, PowerShell 7.1.3, o cualquier versión superior, son las versiones recomendadas de PowerShell y Install-Module es la opción de instalación recomendada, hay otras opciones de instalación, en caso de que sea necesario.

Instalación en Windows PowerShell

Importante

Si tiene instalado el módulo AzureRM PowerShell, consulte Coexistencia de Az y AzureRM antes de continuar.

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 problemas para actualizar con PowerShellGet, debe reinstalarlo en lugar de actualizarlo. 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.

Nota

La desinstalación puede ser complicada si tiene instaladas varias versiones del módulo Az de PowerShell. Debido a esta complejidad, solo se admite la desinstalación de todas las versiones del módulo Az de PowerShell que estén instaladas actualmente.

Si quiere quitar todas las versiones del módulo Az de 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

Solución de problemas de instalación con el módulo Az de Azure PowerShell.

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.