Presentación del módulo Az de Azure 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 de PowerShell sustituye a AzureRM y es la versión recomendada para interactuar con Azure.

Puede usar el módulo Az de 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 "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 (disponible en 2021)
  • 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.0.6 LTS, PowerShell 7.1.3, o cualquier versión superior, son las versiones recomendadas para usarlas con el módulo Azure Az PowerShell en todas las plataformas.

El módulo Az se basa en la biblioteca .NET Standard y funciona con PowerShell 7 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 Azure 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 implementarán en la versión más reciente de Az. Los problemas críticos se implementarán en las dos últimas versiones de Az.

Como los módulos de Az PowerShell ya tienen todas las funcionalidades de los de AzureRM PowerShell, incluso más, el 29 de febrero de 2024 se van a retirar estos últimos.

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

Recopilación de datos

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.