Presentación del módulo Az PowerShell

Visió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 de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo de Az PowerShell para garantizar la compatibilidad y las actualizaciones continuas.

Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, quedando cualquier uso continuado a discreción y bajo el riesgo del usuario. Consulte nuestros recursos de migración de para obtener instrucciones sobre la transición al módulo Az.

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

• Instale el módulo de PowerShell.
• Use Azure Cloud Shell.
• Use el contenedor de Docker de Az PowerShell.

Funciones

El módulo Az PowerShell presenta las siguientes ventajas:

• Seguridad y estabilidad
  • Cifrado de caché de tokens
  • Prevención del ataque de tipo "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:

• Usar un entorno de PowerShell con Azure Cloud Shell. Azure Cloud Shell es un entorno de shell basado en navegador que incluye 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, instalar el módulo Az desde PowerShell 7 o posterior.

Para actualizar desde una instalación existente de AzureRM:

1. Desinstalar el 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. Consulte la sección siguiente o inicie la migración de AzureRM a Az para más información.

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:

• Introducción a la migración de AzureRM a Az
• lista completa de cambios importantes de AzureRM a Az 1.0.0
• El cmdlet Enable-AzureRmAlias

Compatibilidad

Az es el módulo de PowerShell más actual para Azure. Los problemas o 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 de .

Recogida 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 apreciamos la información que proporcionan estos datos, también entendemos que no todos quieren enviar datos de uso. Puede deshabilitar la recopilación de datos con el cmdlet Disable-AzDataCollection. También puede leer nuestra declaración de privacidad para obtener más información.