Presentación del módulo Az PowerShell

Información general

El módulo Az de PowerShell es un conjunto de cmdlets para administrar los recursos de Azure directamente desde PowerShell. PowerShell ofrece características de automatización eficaces que se pueden usar 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 sustituto de AzureRM y es el módulo recomendado 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 de PowerShell con uno de los métodos siguientes:

Funciones

El módulo Az de PowerShell ofrece 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 de ADFS 2019
    • Autenticación de nombre de usuario y de contraseña en PowerShell 7
    • Compatibilidad con características como la evaluación de acceso continuo
  • 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
  • Funcionalidades nuevas
    • Compatibilidad con Cloud Shell y multiplataforma
    • Permite obtener y usar tokens de acceso para acceder a los recursos de Azure
    • Cmdlet disponible para operaciones de 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 se basa en la biblioteca .NET Standard y funciona con PowerShell 7.2 y versiones posteriores en todas las plataformas, como Windows, macOS y Linux. También es compatible con Windows PowerShell 5.1.

Estamos comprometidos a ofrecer soporte técnico de Azure en todas las plataformas, y todos los módulos Az de PowerShell incluyen compatibilidad 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.
  • Puede mantener el módulo AzureRM instalado en Windows PowerShell 5.1 e instalar el módulo Az en PowerShell 7 o versiones posteriores. Windows PowerShell 5.1 y PowerShell 7 y versiones posteriores utilizan colecciones de módulos independientes. 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. Desinstale el módulo AzureRM de Azure PowerShell
  2. Instale el módulo Az de 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 los 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 pueden registrarse 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.

datos, recopilación

Azure PowerShell recopila los 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 tales como los cmdlets con un éxito reducido, y ayudan a priorizar el 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 cmdlet Disable-AzDataCollection. También puede leer nuestra declaración de privacidad para obtener más información.