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 PowerShell presenta las siguientes ventajas:

  • Seguridad y estabilidad
    • Cifrado de caché de tokens
    • Prevención del tipo de ataque man in the middle
    • Compatibilidad con la autenticación con ADFS 2019
    • Autenticación de nombre de usuario y 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 mantenerse al día con las características más recientes de Azure en PowerShell, 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:

  • Use un PowerShell entorno con Azure Cloud Shell. Azure Cloud Shell es un entorno de shell basado en explorador que incluye el módulo Az instalado y Enable-AzureRM los alias de compatibilidad 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 posterior.

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 de Az PowerShell
  3. OPCIONAL: Habilite el modo de compatibilidad para agregar alias para cmdlets de AzureRM con Enable-AzureRMAlias mientras está familiarizado 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 los scripts todavía se basan en el módulo AzureRM, tenemos 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.

Dado que los módulos de Az PowerShell ahora tienen todas las funcionalidades de los módulos de PowerShell de AzureRM y mucho más, hemos dejado de usar los módulos de AzureRM PowerShell a partir del 29 de febrero de 2024.

Para evitar interrupciones del servicio, actualice los scripts que usan módulos de PowerShell de AzureRM para usar módulos 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 datos recopilados para identificar patrones de uso para identificar problemas comunes y mejorar la experiencia de 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.

  • Last updated on