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

Este artículo explica cómo instalar los módulos de Azure PowerShell con PowerShellGet.This article tells you 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. Para el módulo Az, en estos momentos no se admite ningún otro método de instalación.For the Az module, currently no other installation methods are supported.

RequisitosRequirements

Azure PowerShell funciona con PowerShell 5.1 o versiones posteriores en Windows o con PowerShell Core 6.x y versiones posteriores en cualquier plataforma.Azure PowerShell works with PowerShell 5.1 or higher on Windows, or PowerShell Core 6.x and later on all platforms. Si no está seguro de si dispone de PowerShell o si está en macOS o Linux, instale la versión más reciente de PowerShell Core.If you aren't sure if you have PowerShell, or are on macOS or Linux, install the latest version of PowerShell Core.

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

$PSVersionTable.PSVersion

Para ejecutar Azure PowerShell en PowerShell 5.1 en Windows:To run Azure PowerShell in PowerShell 5.1 on Windows:

  1. Actualice a Windows PowerShell 5.1 si es necesario.Update to Windows PowerShell 5.1 if needed. Si tiene Windows 10, ya tiene PowerShell 5.1 instalado.If you're on Windows 10, you already have PowerShell 5.1 installed.
  2. Instale .NET Framework 4.7.2 o posterior.Install .NET Framework 4.7.2 or later.

No hay ningún requisito adicional para Azure PowerShell cuando se usa PowerShell Core.There are no additional requirements for Azure PowerShell when using PowerShell Core.

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

Advertencia

No puede tener los módulos AzureRM y Az instalados para PowerShell 5.1 para Windows al mismo tiempo.You can't have both the AzureRM and Az modules installed for PowerShell 5.1 for Windows at the same time. Si necesita mantener AzureRM disponible en el sistema, instale el módulo Az para PowerShell Core 6.x o versiones posteriores.If you need to keep AzureRM available on your system, install the Az module for PowerShell Core 6.x or later. Para ello, instale PowerShell Core 6.x o versiones posteriores y, a continuación, siga estas instrucciones en un terminal de PowerShell Core.To do this, install PowerShell Core 6.x or later and then follow these instructions in a PowerShell Core terminal.

El método de instalación recomendado es instalar solo para el usuario activo:The recommended install method is to only install for the active user:

Install-Module -Name Az -AllowClobber -Scope CurrentUser

Si desea instalar para todos los usuarios de un sistema, necesitará privilegios de administrador.If you want to install for all users on a system, this requires administrator privileges. Desde una sesión de PowerShell con privilegios elevados, ejecute como administrador o con el comando sudo en macOS o Linux:From an elevated PowerShell session either run as administrator or with the sudo command on macOS or Linux:

Install-Module -Name Az -AllowClobber -Scope AllUsers

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.

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 disponibles de Azure Resource Manager y hace que sus cmdlets estén disponibles para su uso.Installing it downloads all of the available Azure Resource Manager modules, and makes their cmdlets available for use.

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, please 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, los cuales no se tratan con detalle aquí.Different operating systems will have different requirements for configuring a system-wide proxy, which are not covered in detail here. Póngase en contacto con el administrador del sistema para la configuración del proxy y para saber cómo configurarlos para su sistema operativo.Contact your system administrator for your proxy settings and how to configure them for your OS.

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, configure el servidor proxy que se va a usar para una sesión de PowerShell con el siguiente comando:With PowerShell 5.1 and later, configure the proxy to use for a PowerShell session with the following command:

(New-Object System.Net.WebClient).Proxy.Credentials = `
  [System.Net.CredentialCache]::DefaultNetworkCredentials

Si las credenciales del sistema operativo están configuradas correctamente, esto enrutará las solicitudes de PowerShell a través del proxy.If your operating system credentials are configured correctly, this will route PowerShell requests through the proxy. Con el fin de que esta configuración se conserve entre sesiones, agregue el comando a un perfil de PowerShell.In order to have this setting persist between sessions, add the command to a PowerShell profile.

Para instalar el paquete, el servidor proxy debe permitir las conexiones HTTPS a las siguientes direcciones:In order 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, tendrá que importar manualmente el módulo con Import-Module Az.If you've disabled module autoloading, you need to manually import the module with Import-Module 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

Debido a cómo se empaqueta el módulo Az, el comando Update-Module no actualiza la instalación correctamente.Because of how the Az module is packaged, the Update-Module command won't update your installation correctly. AZ es técnicamente un metamódulo que incluye todos los submódulos que contienen los cmdlets para interactuar con los servicios de Azure.Az is technically a meta-module, encompassing all of the submodules that contain cmdlets to interact with Azure services. Esto significa que para actualizar el módulo Azure PowerShell, deberá reinstalar en lugar de simplemente actualizar.That means that to update the Azure PowerShell module, you will need to reinstall, rather than just update. Esto se hace de la misma manera que la instalación, pero es posible que deba agregar el argumento -Force:This is done in the same way as installing, but you may need to add the -Force argument:

Install-Module -Name Az -AllowClobber -Force

Aunque esto puede sobrescribir los módulos instalados, puede tener versiones antiguas en el sistema.Although this can overwrite installed modules, you may still have older versions left on your system. Si desea quitar las versiones anteriores de Azure PowerShell de su sistema, consulte Desinstalación del módulo de Azure PowerShell.To learn how to remove old versions of Azure PowerShell from your system, see Uninstall the Azure PowerShell module.

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 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.

Para instalar o cargar una versión específica del módulo Az, puede usar el argumento -RequiredVersion:You can install or load a specific version of the Az module by using the -RequiredVersion argument:

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

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.

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.