- 05/14/2020
- 6 minutos para leer
-
- m
- h
en Este artículo se explica cómo instalar el Azure PowerShell módulos usingPowerShellGet. Estas instrucciones funcionan en plataformas Windows, macOS y Linux.
Azure PowerShell también está disponible en Azure Cloud Shell y ahora está preinstalado en imágenes Docker.
Requisitos
Nota
PowerShell 7.,x y posterior es la versión recomendada de PowerShell para usar con Azure PowerShell en todas las plataformas.
Azure PowerShell funciona con PowerShell 6.2.4 y versiones posteriores en todas las plataformas. También es compatible con PowerShell 5.1 en Windows. Instale la versión más reciente de PowerShell disponible para su sistema operativo. Azure PowerShell no tiene requisitos adicionales cuando se ejecuta en PowerShell 6.2.4 y versiones posteriores.
para comprobar la versión de PowerShell, ejecute el comando:
$PSVersionTable.PSVersion
para usar Azure PowerShell en PowerShell 5.1 en Windows:
- Update toWindows PowerShell 5.1.,Si tiene Windows 10 versión 1607 o superior, ya tiene PowerShell 5.1 instalado.
- instale. NET Framework 4.7.2 o posterior.
- asegúrese de tener la última versión de PowerShellGet. Ejecute
Install-Module -Name PowerShellGet -Force
.
instale el módulo Azure PowerShell
advertencia
No admitimos que los módulos AzureRM y Az se instalen para PowerShell 5.1 en Windowsat al mismo tiempo. Si necesita mantener AzureRM disponible en su sistema, instale el módulo Az forPowerShell 6.2.4 o posterior.,
Instalar para el usuario actual
El método de instalación preferido es usar los cmdlets PowerShellGet. Instale el módulo Az solo para el usuario actual. Este es el alcance de instalación recomendado. Este método funciona de la misma manera en las plataformas Windows, macOS y Linux. Ejecute el siguiente comando desde una sesión de PowerShell:
de forma predeterminada, la galería de PowerShell no está configurada como repositorio de confianza para PowerShellGet., La primera vez que utilice PSGallery verá el siguiente mensaje:
Answer Yes
o Yes to All
para continuar con la instalación.
Instalar para todos los usuarios
Instalar el módulo para todos los usuarios en un sistema requiere privilegios elevados. Inicie PowerShellsession mediante Ejecutar como administrador en Windows o utilice el comando sudo
en macOS o Linux:
El módulo Az es un módulo acumulativo para los cmdlets de Azure PowerShell., Al instalarlo, se descargan todos los módulos de Az PowerShell generalmente disponibles y se ponen a disposición sus cmdlets para su uso.
instalar sin conexión
en algunos entornos, no es posible conectarse a la galería de PowerShell. En esas situaciones, aún puede instalar sin conexión utilizando uno de estos métodos:
-
descargue los módulos a otra ubicación de su red y úselos como fuente de instalación.Este método permite almacenar en caché los módulos de PowerShell en un solo servidor o recurso compartido de archivos que se implementarán con PowerShellGet en cualquier sistema desconectado., Aprenda cómo configurar un repositorio local e instalarlos en sistemas desconectados con el trabajo con repositorios PowerShellGet locales.
-
descargue el MSI de Azure PowerShell en una máquina conectada a la red y,a continuación, copie el instalador en sistemas sin acceso a PowerShell Gallery. Tenga en cuenta que el instalador de theMSI solo funciona para PowerShell 5.1 en Windows.,
-
guarde el módulo con Save-Module en un recurso compartido de archivos,o guárdelo en otro origen y cópielo manualmente en otras máquinas:
Save-Module -Name Az -Path '\\server\share\PowerShell\modules' -Force
solución de problemas
Estos son algunos de los problemas comunes que se observan al instalar el módulo Azure PowerShell. Si experimentas un problema que no aparece aquí, presenta un problema en GitHub.
El Proxy bloquea la conexión
Si obtiene errores de Install-Module
que indican que la galería de PowerShell es inalcanzable, es posible que esté detrás de un proxy., Los diferentes sistemas operativos y entornos de red tienen diferentes requisitos para configurar un proxy en todo el sistema. Póngase en contacto con el administrador del sistema para conocer la configuración del proxy y cómo configurarlos para su entorno.
Es posible que PowerShell no esté configurado para usar este proxy automáticamente. Con PowerShell 5.1 y posterior, configure la sesión de PowerShell para que use un proxy mediante los siguientes comandos:
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 mantenga entre sesiones, agregue los comandos a su perfil de PowerShell.
para instalar el paquete, su proxy debe permitir conexiones HTTPS a la siguiente dirección:
Sign in
To start working with Azure PowerShell, sign in with your Azure credentials.
Note
If you’ve disabled module autoloading, manually import the module with Import-Module -Name Az
.Debido a la forma en que el módulo está estructurado, esto puede tardar unos segundos.
deberá repetir estos pasos para cada nueva sesión de PowerShell que inicie. Para saber cómo mantener el inicio de sesión de Azure en las sesiones de PowerShell, consulte credenciales de usuario permanentes en las sesiones de PowerShell.,
actualizar el módulo de Azure PowerShell
para actualizar cualquier módulo de PowerShell, debe utilizar el mismo método utilizado para instalar el módulo. Por ejemplo, si originalmente usaste Install-Module
, entonces deberías usar Update-Module para obtener la última versión. Si originalmente usaste el paquete MSI entonces deberías descargar e instalar el nuevo paquete MSI.
los cmdlets PowerShellGet no pueden actualizar los módulos que se instalaron desde un paquete MSI. MSIpackages no actualiza los módulos que se instalaron usando PowerShellGet., Si tiene algún problema actualizando usando PowershellGet, entonces debe reinstalar, en lugar de actualizar. Reinstalar isdone de la misma manera que instalar, pero necesita agregar el parámetro -Force
:
a diferencia de las instalaciones basadas en MSI, instalar o actualizar usando PowerShellGet no elimina las versiones antiguas que pueden existir en su sistema. Para quitar versiones antiguas de Azure PowerShell del sistema,consulte Desinstalar el módulo Azure PowerShell. Para obtener más información sobre las instalaciones basadas en MSI, consulte Instalar Azure PowerShell con un MSI.,
Usar varias versiones de Azure PowerShell
Es posible instalar más de una versión de Azure PowerShell. Para comprobar si tiene instaladas multipleversiones de Azure PowerShell, utilice el siguiente comando:
Get-InstalledModule -Name Az -AllVersions | Select-Object -Property Name, Version
para quitar una versión de Azure PowerShell, consulte Desinstalar el módulo Azure PowerShell.
Si tiene más de una versión del módulo instalada, module autoload y Import-Module
cargan la última versión de forma predeterminada.,
Puede instalar o cargar una versión específica del módulo Az
usando el parámetro -RequiredVersion
:
Use múltiples repositorios con PowerShellGet
el parámetro de repositorio es necesario si ha agregado repositorios adicionales a Powershellgeten su sistema y el módulo Az se puede encontrar en más de uno de ellos.
proporcionar comentarios
Si encuentra un error en Azure PowerShell,Archive un problema en GitHub. Para proporcionar feedback desde la línea de comandos, utilice el cmdlet Send-Feedback.,
para obtener más información sobre los módulos de Azure PowerShell y sus características, consulte Inicio con Azure PowerShell. Si está familiarizado con AzurePowerShell y necesita migrar de AzureRM, seeMigrate de AzureRM a Az.