Instalación del módulo Service Management de Azure PowerShell

  • Artículo

Nota:

Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos de Azure heredados que usan las API de Azure Service Management (ASM). Este módulo heredado de PowerShell no se recomienda al crear nuevos recursos, ya que ASM está programado para la retirada. Para más información, consulte Retirada de Azure Service Manager.

El módulo Az de PowerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.

El módulo de administración de servicios de Azure PowerShell es un módulo consolidado. Al instalar el módulo de administración de servicios de Azure PowerShell, se descargan los módulos disponibles con carácter general para administrar recursos heredados de Azure que usan las Service Management API y hacen que sus cmdlets estén disponibles para su uso.

Requisitos previos

Importante

El módulo Service Management de Azure PowerShell solo funciona con Windows PowerShell. No es compatible con PowerShell versión 6 o posterior y no se ejecuta en Linux o macOS.

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

    $PSVersionTable.PSVersion

  • Actualice a Windows PowerShell 5.1.

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

  • Actualización de PowerShellGet para Windows PowerShell 5.1

Instalación

Use el cmdlet Install-Module para instalar el módulo de administración de servicios de Azure PowerShell:

Install-Module -Name Azure, Azure.Storage -Repository PSGallery -AllowClobber -Force

El módulo de administrador de recursos de Azure PowerShell comparte dependencias con los módulos del administrador de recursos de Azure PowerShell. Si ha instalado los módulos del administrador de recursos de Azure PowerShell, se requiere el parámetro AllowClobber como se muestra en el comando anterior. ya que esto permite que se actualicen las dependencias compartidas existentes. Sin este parámetro, no se puede realizar la instalación del módulo.

Después de instalar el módulo de administración de servicios de Azure PowerShell, importe el módulo:

Import-Module -Name Azure

Iniciar sesión

Para empezar a administrar los recursos de Azure heredados con el módulo de administración de servicios de Azure PowerShell, inicie sesión en PowerShell y ejecute Add-AzureAccount para iniciar sesión en Azure:

Add-AzureAccount

Tras iniciar sesión en Azure, el módulo de administración de servicios de Azure PowerShell crea un contexto para la sesión determinada. Dicho contexto contiene el entorno, la cuenta, el inquilino y la suscripción de Azure que se utilizan para todos los cmdlets de dicha sesión.

Solucionar problemas

Si recibe el error "El módulo especificado 'Azure.Storage' con la versión '4.3.0' no se cargó porque no se encontró ningún archivo de módulo válido en ningún directorio del módulo", debe instalar el módulo de PowerShell de Azure.Storage:

Install-Module -Name Azure.Storage -Repository PSGallery -AllowClobber -Force

Si recibe el error "Se encontró el comando 'Install-Module' en el módulo 'PowerShellGet', pero no se pudo cargar el módulo", debe establecer la directiva de ejecución de PowerShell en una directiva de ejecución remota firmada o menos restrictiva:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Consulte también

Para más información sobre los comandos del módulo de administración de servicios de Azure PowerShell, consulte la documentación de referencia del cmdlet.