Instalación sin conexión de Azure PowerShell

Artículo
01/17/2025

En algunos entornos, no es posible conectarse a Internet ni a la Galería de PowerShell. En esas situaciones, puede instalar el módulo de Az PowerShell sin conexión mediante uno de estos métodos.

Nota

Las opciones de instalación sin conexión que se indican en este artículo requieren al menos un sistema con acceso a Internet para descargar el módulo Az de PowerShell, que puede ser diferente del sistema en el que tiene pensado instalar el módulo.

Prerrequisitos

Instalación de una versión compatible de powerShell versión 7 o posterior
Windows PowerShell 5.1 también es compatible si estás utilizando un sistema operativo Windows.

Multiplataforma

Las siguientes opciones de instalación para el módulo Az PowerShell están disponibles multiplataforma en todas las plataformas, como Windows, Linux y macOS.

Instalación desde el archivo tar

Sugerencia

La utilidad de línea de comandos tar es necesaria para usar esta opción de instalación. Está disponible de forma predeterminada en windows 10 versión 1803 o posterior, la mayoría de las distribuciones de Linux y las versiones actuales de macOS.

En un sistema con acceso a Internet, defina la ruta de acceso de destino donde desea guardar el archivo tar.
```
$downloadFolderPath = "$home/Downloads"
```

Compruebe que existe la carpeta de descarga. De lo contrario, cree la carpeta.

if (-not (Test-Path -Path $downloadFolderPath -PathType Container)) {
    New-Item -Path $downloadFolderPath -ItemType Directory
}

Determine la dirección URL del archivo tar para la versión más reciente del módulo de Az PowerShell en GitHub.

$tarSourceUrl = (
    Invoke-RestMethod -Uri https://api.github.com/repos/azure/azure-powershell/releases/latest |
    Select-Object -ExpandProperty assets | Where-Object content_type -eq 'application/x-gzip'
).browser_download_url

Almacene el nombre de archivo tar y la ruta de acceso de archivo de destino en variables.

$fileName = Split-Path -Path $tarSourceUrl -Leaf
$downloadFilePath = Join-Path -Path $downloadFolderPath -ChildPath $fileName

Descargue el archivo tar desde GitHub mediante PowerShell.

Invoke-WebRequest -Uri $tarSourceUrl -OutFile $downloadFilePath

Desbloquee el archivo descargado si ejecuta un sistema operativo Windows.
```
if ($PSVersionTable.PSVersion.Major -le 5 -or $IsWindows -eq $true) {
    Unblock-File -Path $downloadFilePath
}
```
Nota

Copie el archivo tar en el sistema sin conexión. Defina las variables $downloadFilePath y $downloadFolderPath o especifique valores reales en lugar de usar las variables en los siguientes comandos del sistema sin conexión.

Extraiga el contenido del archivo tar.

tar zxf $downloadFilePath -C $downloadFolderPath

Ejecute el script InstallModule.ps1 que es uno de los archivos extraídos en el sistema sin conexión donde desea instalar el módulo Az PowerShell.
```
.$downloadFolderPath/InstallModule.ps1
```

Guardar y copiar la instalación

Descargue el módulo Az powerShell con Save-Module o Save-PSResource a una ubicación de red mediante un sistema con acceso a Internet y a la Galería de PowerShell. Estos comandos guardan el módulo Az y sus dependencias en la ubicación especificada. Use los módulos guardados como origen de instalación y cópielos en el sistema sin conexión.

Instalación desde un repositorio privado

Cree un repositorio privado en la red local y úselo como origen de instalación para el sistema sin conexión. Para obtener más información, consulte Uso de repositorios privados de PowerShellGet.

Este método permite almacenar en caché los módulos de PowerShell en un único servidor o recurso compartido de archivos para ser implementados con PowerShellGet o Microsoft.PowerShell.PSResourceGet en cualquier sistema desconectado.

Windows

En Windows, también tiene la opción de instalar el módulo Az PowerShell con un MSI si usa Windows PowerShell versión 5.1.

Importante

Tenga en cuenta que el instalador msi solo funciona para Windows PowerShell 5.1.

Instalar Azure PowerShell en Windows con el instalador msi.

Solución de problemas

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

Consulte también

Pasos siguientes

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

Compartir a través de