Actualización de módulos de Azure PowerShell en Automation

Este artículo describe cómo actualizar módulos de Azure PowerShell (Az) en Azure Automation. El módulo Az powerShell es un conjunto de cmdlets para administrar recursos de Azure directamente desde PowerShell. Azure Automation proporciona por defecto módulos comunes de PowerShell en cada cuenta de Automation. Para más información, véase Módulos predeterminados. A medida que el equipo de Azure actualiza los módulos de Azure periódicamente, se pueden producir cambios con los cmdlets incluidos. Por ejemplo, cambiar el nombre de un parámetro o desactivar completamente un cmdlet. Estos cambios pueden afectar a los libros de operaciones y procesos de automatización existentes si los módulos no se actualizan adecuadamente. Para ayudar a gestionar estas actualizaciones, Azure Automation ofrece dos métodos para actualizar los módulos de Az:

• Actualizar los módulos de Az a través del portal de Azure
• Actualizar los módulos de Az mediante un libro de operaciones

Nota:

No se pueden eliminar módulos globales, que son los módulos que Automation proporciona de forma integrada.

Importante

La nueva experiencia del entorno de runtime permite administrar módulos y paquetes configurando el entorno de ejecución del trabajo. En la nueva experiencia, los blades de Módulos y Paquetes no están disponibles. Para administrar los módulos y paquetes, consulte Administración del entorno de runtime y los runbooks asociados.

Configuración de una cuenta de Automation

Para evitar que incidan en los runbooks y los procesos que automatizan, asegúrese de probarlos y validarlos cuando realice actualizaciones. Si no tiene una cuenta de Automation dedicada pensada para este propósito, considere la posibilidad de crear una para que pueda probar muchos escenarios diferentes durante el desarrollo de los runbooks. Estas pruebas deben incluir cambios iterativos, por ejemplo, la actualización de los módulos de PowerShell.

Asegúrese de que la cuenta de Automation ha agregado una identidad administrada asignada por el sistema o una identidad administrada asignada por el usuario.

Si desarrolla sus scripts de forma local, se recomienda tener localmente las mismas versiones del módulo que tiene en la cuenta de Automation al realizar pruebas, a fin de asegurarse de que obtendrá los mismos resultados. Después de validar los resultados y aplicar los cambios necesarios, puedes mover los cambios a producción.

Nota:

Es posible que una cuenta de Automation nueva no contenga los módulos más recientes.

Actualización de módulos de Azure

Las siguientes secciones explican cómo puede actualizar los módulos Az, ya sea a través del portal (recomendado) o del runbook.

Actualizar los módulos de Az a través del portal de Azure

Actualmente, la actualización de los módulos Az solo está disponible a través del portal. Las actualizaciones mediante PowerShell y la plantilla de ARM estarán disponibles en el futuro. Solo se actualizarán los módulos de Azure predeterminados al realizar los pasos siguientes:

1. Inicie sesión en Azure Portal y vaya a su cuenta de Automation.

2. En Recursos compartidos, seleccione Módulos.

3. Selecciona Actualización de módulos de Azure.

4. Seleccione el módulo que se va a actualizar. Por defecto, muestra el módulo de Arizona.

5. En la lista desplegable, selecciona Versión del módulo y Versión de ejecución.

6. Selecciona Actualizar para actualizar el módulo de Az a la versión que seleccionaste. En la página Módulos, puede ver la lista tal como se muestra a continuación:

   

Si selecciona una versión anterior a la versión del módulo de Azure existente importada en la cuenta de Automation, la operación de actualización realizará una reversión a la versión inferior seleccionada.

Para comprobar la operación de actualización, compruebe la propiedad Versión del módulo y Estado de los módulos actualizados que se muestran en la lista de módulos en Módulos de PowerShell.

El equipo de Azure actualiza regularmente la versión del módulo y ofrece la opción de actualizar los módulos predeterminados de Az seleccionando la versión del módulo en la lista desplegable.

Actualización de módulos de Az mediante runbook

Para actualizar los módulos de Azure en la cuenta de Automation:

1. Utilice el runbook Update-AutomationAzureModulesForAccount, disponible como código abierto.
2. Descargue desde el repositorio de GitHub para empezar a usar este runbook para actualizar los módulos de Azure.
3. Puede importarlo en la cuenta de Automation o ejecutarlo como un script. Para aprender a importar un runbook en la cuenta de Automation, consulte Importación de un runbook.

Nota:

Se recomienda actualizar los módulos de Az a través de Azure portal. También puede hacerlo mediante el Update-AutomationAzureModulesForAccount script, disponible como código abierto y proporcionado como referencia. Sin embargo, en caso de error de runbook, debe modificar los parámetros del runbook según sea necesario o depurar el script según el escenario.

El runbook Update-AutomationAzureModulesForAccount admite la actualización de los módulos Azure, AzureRM y Az de forma predeterminada. Revise Update Azure modules runbook README para obtener más información sobre cómo actualizar Az. Módulos de automatización con este runbook. Hay otros factores importantes que debes tener en cuenta al usar los módulos de Az en tu cuenta de Automation. Para más información, consulte Administrar módulos en Azure Automation.

Uso del código de runbook de actualización como script de PowerShell normal

Puede usar el código de runbook como script de PowerShell normal en lugar de un runbook. Para ello, inicia sesión en Azure usando primero el cmdlet Connect-AzAccount y luego pasa -Login $false al script.

Uso del runbook de actualización en nubes soberanas

Para usar este runbook en nubes soberanas, use el parámetro AzEnvironment para pasar el entorno correcto al runbook. Los valores aceptables son AzureCloud (Azure nube pública), AzureChinaCloud, AzureGermanCloud y AzureUSGovernment. Puedes obtener estos valores usando Get-AzEnvironment | select Name. Si no pasa un valor a este cmdlet, el runbook toma como valor predeterminado AzureCloud.

Utilice el runbook de actualización para actualizar una versión específica del módulo

Si quiere usar una versión específica del módulo de Azure PowerShell en lugar del módulo más reciente disponible en el Galería de PowerShell, pase estas versiones al parámetro opcional ModuleVersionOverrides del runbook Update-AutomationAzureModulesForAccount. Para obtener ejemplos, consulte el runbook Update-AutomationAzureModulesForAccount.ps1. Los módulos de Azure PowerShell que no se mencionan en el parámetro ModuleVersionOverrides se actualizan automáticamente con las versiones más recientes del módulo en Galería de PowerShell. Si no se pasa nada al parámetro ModuleVersionOverrides, todos los módulos se actualizan con las versiones de módulo más recientes de la Galería de PowerShell. Este comportamiento es el mismo para el botón Update Azure Modules en el portal de Azure.

Pasos siguientes

• Para más detalles sobre el uso de módulos, consulte Gestionar módulos en Azure Automation.
• Para más información sobre el runbook de actualización, consulte el runbook Actualizar módulos de Azure.
• Para solucionar problemas al actualizar los módulos de Azure PowerShell administrados como recursos compartidos en Azure Automation, consulte Troubleshoot Azure Automation problemas de recursos compartidos.