Instalación de Azure PowerShell en Windows

El módulo 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.

Método de instalación recomendado y versión de PowerShell para el módulo Az PowerShell:

  • Instalación desde la Galería de PowerShell
  • Uso con la versión 7 o posterior de PowerShell

En este artículo se explica cómo instalar el módulo Az PowerShell de Azure en Windows desde la Galería de PowerShell.

Requisitos previos

  • Para determinar la versión de PowerShell, ejecute el siguiente comando desde PowerShell:

    $PSVersionTable.PSVersion
    
  • Determine si el módulo AzureRM PowerShell está instalado:

    Get-Module -Name AzureRM -ListAvailable
    

    Importante

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

  • Establezca la directiva de ejecución de PowerShell en remota firmada o menos restrictiva.

    • Compruebe la directiva de ejecución de PowerShell:

      Get-ExecutionPolicy -List
      
    • Establezca la directiva de ejecución de PowerShell a remota firmada:

      Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
      

    Para más información sobre la directiva de ejecución, consulte about_Execution_Policies.

Instalación

Use el cmdlet Install-Module para instalar el módulo Az PowerShell:

Install-Module -Name Az -Repository PSGallery -Force

Actualización del módulo Az PowerShell

Use Update-Module para actualizar a la versión más reciente del módulo Az PowerShell:

Update-Module -Name Az -Force

Al actualizar el módulo Az PowerShell mediante Update-Module no se eliminan las versiones anteriores del módulo en el sistema.

Desinstalación

Para quitar el módulo Az PowerShell, consulte Desinstalación del módulo Azure PowerShell.

En este artículo se explica cómo instalar el módulo Az PowerShell en Windows mediante un instalador MSI. El instalador MSI se proporciona para entornos en los que la Galería de PowerShell puede estar bloqueada por un firewall o se necesita un instalador sin conexión.

Importante

La opción de instalación MSI solo se puede usar para instalar el módulo Az PowerShell para su uso con Windows PowerShell 5.1.

Requisitos previos

  • Para determinar la versión de PowerShell, ejecute el siguiente comando desde PowerShell:

    $PSVersionTable.PSVersion
    
  • Determine si el módulo AzureRM PowerShell está instalado.

    Get-Module -Name AzureRM -ListAvailable
    

    Importante

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

  • Actualice a Windows PowerShell 5.1.

  • Instale .NET Framework 4.7.2 o posterior.

  • Establezca la ejecución de scripts de PowerShell en remota firmada o menos restrictiva.

    • Compruebe la directiva de ejecución de PowerShell:

      Get-ExecutionPolicy -List
      
    • Establezca la directiva de ejecución de PowerShell a remota firmada:

      Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
      

    Para más información sobre la directiva de ejecución, consulte about_Execution_Policies.

Instalación y actualización

El paquete MSI para Azure PowerShell está disponible en GitHub:

  1. Visite github.com/Azure/azure-powershell/releases.
  2. Busque el módulo Az PowerShell más reciente. Se enumeran cronológicamente sin nombre. Por ejemplo, 9.5.0.
  3. Desplácese hasta el final de las notas de la revisión y haga clic en la flecha situada junto a "Recursos" para ver las opciones de MSI.
  4. Haga clic en el paquete MSI de los cmdlets de Az que desee para iniciar la descarga.

El instalador quita automáticamente las versiones anteriores del módulo Az PowerShell que se instalaron mediante MSI. El paquete MSI instala los módulos en "${env:ProgramFiles}\WindowsPowerShell\Modules".

Iniciar sesión

Para empezar a administrar los recursos de Azure con el módulo Az PowerShell, inicie sesión en PowerShell y ejecute Connect-AzAccount para iniciar sesión en Azure:

Connect-AzAccount

Use las credenciales de inicio de sesión de la cuenta de Azure para iniciar sesión en la ventana del explorador que se abre.

Deberá repetir este paso para cada nueva sesión de PowerShell que inicie. Para más información sobre cómo conservar el inicio de sesión de Azure de una sesión a otra de PowerShell, consulte Objetos de contexto de Azure PowerShell.

Solución de problemas

Para soluciones a problemas comunes de instalación del módulo Az PowerShell, consulte Solución de problemas de instalación del módulo Az PowerShell.

Envío de comentarios

Para presentar un problema sobre el módulo Az PowerShell, consulte Presentación de un problema en GitHub.

Para enviar comentarios desde una sesión de PowerShell, use el cmdlet Send-Feedback.

Pasos siguientes

Para más información sobre la administración de los recursos de Azure con el módulo Az PowerShell, consulte Introducción a Azure PowerShell.