Compartir a través de

Presentación del módulo Az PowerShell

Información general

El módulo Az powerShell es un conjunto de cmdlets para administrar recursos de Azure directamente desde PowerShell. PowerShell proporciona características eficaces para la automatización que se pueden aprovechar para administrar los recursos de Azure, por ejemplo, en el contexto de una canalización de CI/CD.

El módulo Az PowerShell es el reemplazo de AzureRM y es el módulo recomendado que se usará para interactuar con Azure.

Advertencia

El módulo AzureRM PowerShell ha quedado oficialmente obsoleto a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no recibirá mantenimiento ni soporte técnico, lo que significa que su uso continuado queda a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Puede usar el módulo Az PowerShell con uno de los métodos siguientes:

Características

El módulo Az de PowerShell ofrece las siguientes ventajas:

  • Seguridad y estabilidad
    • Cifrado de caché de tokens
    • Prevención del ataque de tipo "hombre en el medio"
    • Soporte para la autenticación de ADFS 2019
    • Autenticación de nombre de usuario y de contraseña en PowerShell 7
    • Compatibilidad con características como la evaluación continua de acceso
  • Compatibilidad con todos los servicios de Azure
    • Todos los servicios de Azure disponibles con carácter general tienen un módulo de PowerShell compatible correspondiente
    • Varias correcciones de errores y actualizaciones de la versión de API desde AzureRM
  • Nuevas funcionalidades
    • Compatibilidad con Cloud Shell y multiplataforma
    • Puede obtener y usar el token de acceso para acceder a los recursos de Azure
    • Cmdlet disponible para operaciones REST avanzadas con recursos de Azure

Nota:

PowerShell 7.2 o posterior es la versión recomendada de PowerShell para su uso con el módulo Az de PowerShell en todas las plataformas.

El módulo Az PowerShell se basa en la biblioteca de .NET Standard y funciona con PowerShell 7.2 y versiones posteriores en todas las plataformas, como Windows, Linux y macOS. También es compatible con Windows PowerShell 5.1.

Nos comprometemos a incorporar compatibilidad con Azure a todas las plataformas y todos los módulos de Az PowerShell son multiplataforma.

Actualización del entorno a Az

Para disponer de las características más recientes de Azure en PowerShell, se debe migrar al módulo Az. Si no está listo para instalar el módulo Az como sustituto de AzureRM, tiene un par de opciones disponibles para experimentar con Az:

  • Usar un entorno de PowerShell con Azure Cloud Shell. Azure Cloud Shell es un entorno de shell basado en explorador que viene con el módulo Az instalado y los alias de compatibilidad Enable-AzureRM habilitados.
  • Mantenga instalado el módulo AzureRM en Windows PowerShell 5.1 e instale el módulo Az en PowerShell 7 o posterior. Windows PowerShell 5.1 y PowerShell 7 y versiones posteriores usan colecciones independientes de módulos. Siga las instrucciones para instalar la versión más reciente de PowerShell y, a continuación, instale el módulo Az desde PowerShell 7 o versiones posteriores.

Para actualizar desde una instalación existente de AzureRM:

  1. Desinstalación del módulo AzureRM de Azure PowerShell
  2. instalación del módulo Az PowerShell
  3. OPCIONAL: Habilite el modo de compatibilidad para agregar alias a los cmdlets de AzureRM con Enable-AzureRMAlias mientras se familiariza con el nuevo conjunto de comandos. Para más información, consulte la sección siguiente o Iniciar la migración de AzureRM a Az.

Migración de scripts existentes de AzureRM a Az

Si sus scripts siguen basándose en el módulo AzureRM, hay varios recursos que le ayudarán con la migración:

Compatibilidad

Az es el módulo de PowerShell más actual para Azure. Los problemas o las solicitudes de características se pueden registrar directamente en el repositorio de GitHub o a través del soporte técnico de Microsoft si tiene un contrato de soporte técnico. Las solicitudes de características se implementan en la versión más reciente de Az. Los problemas críticos se implementan en las dos últimas versiones de Az.

Como los módulos de Az PowerShell ya tienen todas las funcionalidades de los de AzureRM PowerShell, a partir del 29 de febrero de 2024 los módulos AzureRM PowerShell estarán en desuso.

Para evitar interrupciones del servicio, actualice los scripts que usan los módulos AzureRM PowerShell para que utilicen los de Az PowerShell. Para actualizar automáticamente los scripts, siga la guía de inicio rápido.

Recopilación de datos

Azure PowerShell recopila datos de telemetría de forma predeterminada. Microsoft agrega los datos recopilados para identificar patrones de uso con el fin de identificar problemas comunes y mejorar la experiencia con Azure PowerShell. Microsoft Azure PowerShell no recopila datos personales ni privados. Por ejemplo, los datos de uso ayudan a identificar problemas como cmdlets con poco éxito y ayudan a priorizar nuestro trabajo.

Aunque la información que ofrecen estos datos es muy útil, también sabemos que no todos quieren enviar los datos de uso. Puede deshabilitar la recopilación de datos con el Disable-AzDataCollection cmdlet . También puede leer nuestra declaración de privacidad para obtener más información.