Instalación del módulo de Azure PowerShell
El módulo Azure Az PowerShell es un módulo acumulativo. Durante la instalación, descargan todos los módulos AZ de PowerShell disponibles y los cmdlets que contienen se pueden usar. El módulo Azure Az PowerShell funciona con PowerShell 7.x y versiones posteriores en todas las plataformas. No hay ningún requisito adicional para Azure PowerShell cuando se ejecuta en PowerShell 7.x y versiones posteriores.
Para comprobar la versión de PowerShell, ejecute el siguiente comando desde una sesión de PowerShell:
$PSVersionTable.PSVersion
Antes de instalar el módulo de PowerShell de Azure Az, debe establecer la directiva de ejecución de scripts de PowerShell en RemoteSigned. Para ello, puede ejecutar el siguiente comando:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Métodos de instalación del módulo Az PowerShell
Puede instalar el módulo Az de Azure PowerShell mediante uno de los métodos siguientes:
- El cmdlet Install-Module
- El MSI de Azure PowerShell
- El contenedor Docker de Az de PowerShell
Nota:
El módulo Azure Az PowerShell está preinstalado en Azure Cloud Shell. Puede usarlo directamente desde el explorador, sin instalar nada localmente en el equipo. Obtendrá más información sobre Azure Cloud Shell en la lección siguiente.
El cmdlet Install-Module
El uso del cmdlet Install-Module es el método de instalación preferido para el módulo Azure Az PowerShell. Debe instalar este módulo solo para el usuario actual. Este es el ámbito de instalación recomendado. Este método funciona igual en plataformas Windows, macOS y Linux. Para instalar el módulo Az, ejecute el siguiente comando de una sesión de PowerShell local:
Install-Module -Name Az -Scope CurrentUser -Repository PSGallery -Force
Aunque PowerShell 7.x es la versión recomendada de PowerShell e Install-Module es la opción de instalación recomendada, también puede instalar el módulo Az en el entorno de PowerShell 5.1 en Windows. Si tiene Windows 10 versión 1607 o posteriores, ya tiene PowerShell 5.1 instalado. También debe asegurarse de que tiene instalado .NET Framework 4.7.2 o una versión más reciente y la versión más reciente de PowerShellGet. Para instalar la versión más reciente del módulo PowerShellGet en PowerShell 5.1, ejecute el siguiente comando:
Install-Module -Name PowerShellGet -Force
Después, puede instalar el módulo Az mediante el mismo comando que usa en PowerShell 7.1.
El MSI de Azure PowerShell
En algunos entornos no es posible conectarse a la Galería de PowerShell. En tales situaciones, puede instalar el módulo Az PowerShell sin conexión; para ello, descargue el paquete MSI de Azure PowerShell. Tenga en cuenta que el instalador MSI solo funciona para PowerShell 5.1 en Windows.
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.
El contenedor Docker de Az de PowerShell
También es posible ejecutar Azure PowerShell dentro de una imagen de Docker. Microsoft proporciona imágenes de Docker con Azure PowerShell preinstalado. Las imágenes publicadas requieren Docker 17.05 o una versión más reciente. La imagen de contenedor más reciente incluye la versión más reciente de PowerShell y los módulos de Azure PowerShell más recientes compatibles con el módulo Az.
Para descargar la imagen e iniciar una sesión interactiva de PowerShell, debe ejecutar los siguientes comandos:
docker pull mcr.microsoft.com/azure-powershell
docker run -it mcr.microsoft.com/azure-powershell pwsh
Empezar a trabajar con Azure PowerShell
Para empezar a trabajar en el entorno de Azure PowerShell, primero debe iniciar sesión con las credenciales de Azure. Este paso es distinto de cuando se trabaja solo en PowerShell. Las credenciales de Azure son las mismas que se usan para iniciar sesión en Azure Portal u otros recursos basados en Azure.
Para iniciar sesión en Azure desde Azure PowerShell, ejecute el siguiente comando:
Connect-AzAccount
Después de ejecutar este comando, se le pedirá que inicie sesión con sus credenciales de Azure. Después de autenticarse correctamente en Azure, puede empezar a usar comandos desde el módulo Az para administrar los recursos de Azure.