Ejecución de comandos de la CLI de Azure en runbooks de PowerShell 7.4

Puede ejecutar comandos de la CLI de Azure en runbooks vinculados con el entorno en tiempo de ejecución de PowerShell 7.4.

Nota:

Los comandos de la CLI de Azure versión 2.64.0 están disponibles como un paquete predeterminado en el entorno en tiempo de ejecución de PowerShell 7.4.

Requisitos previos

• Una cuenta de Azure Automation (en cualquier región pública admitida, excepto las regiones Sureste de Brasil y las nubes Gov).

Creación de entornos de ejecución

Azure Portal

Para crear un entorno en tiempo de ejecución en Azure Portal, siga estos pasos:

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

2. En la página Información general , seleccione Probar experiencia del entorno en tiempo de ejecución, si aún no está en la nueva experiencia.

3. En Automatización de procesos, seleccione Entornos en tiempo de ejecución (versión preliminar) y, a continuación, Crear.

4. En la pestaña Aspectos básicos , proporcione los detalles siguientes:

   1. Escriba Nombre para el entorno en tiempo de ejecución. Debe comenzar con una letra y solo puede contener letras, números, caracteres de subrayado y guiones.
   2. En la lista desplegable Lenguaje, seleccione PowerShell.
   3. En Versión de tiempo de ejecución para el lenguaje de secuencias de comandos, seleccione 7.4.
   4. Escriba la descripción adecuada.

5. En la pestaña Paquetes , en la lista desplegable Versión del paquete , verá que Az versión 12.3.0 y la CLI de Azure versión 2.64.0 ya están presentes.

6. Seleccione +Agregar desde la galería para agregar más paquetes desde la galería y seleccione Siguiente.

7. En la pestaña Revisar y crear , revise las entradas y seleccione Crear.

   Aparece una notificación para confirmar que se ha creado correctamente un entorno en tiempo de ejecución.

REST API

PUT
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>?api-version=2024-10-23
{ 
  "properties": { 
    "runtime": { 
        "language": "PowerShell",  
        "version": "7.4" 
        }, 
        "defaultPackages": { 
            "Az": "12.3.0",
            "Azure CLI": "2.64.0"
        } 
     }, 
    "name": "<runtimeEnvironmentName>"
}

Crear Runbook

Azure Portal

Puede crear un nuevo runbook de PowerShell que admita comandos de la CLI de Azure y esté asociado con el entorno en tiempo de ejecución de PowerShell 7.4.

Para crear un runbook, siga estos pasos:

1. En la cuenta de Automation, en Automatización de procesos, seleccione Runbooks.

2. Seleccione Crear.

3. En la pestaña Aspectos básicos, puede crear un nuevo runbook o cargar un archivo desde el equipo local o desde la Galería de PowerShell.

   1. Escriba un Nombre para el runbook. El nombre debe empezar por una letra, y debe contener solo letras, números, caracteres de subrayado y guiones.
   2. En la lista desplegable Tipo de runbook, seleccione el tipo de runbook que desea crear.
   3. Seleccione Entorno de ejecución de PowerShell 7.4 creado anteriormente.
   4. Escriba la descripción adecuada.

4. Agregue código de runbook en la página Editar runbook y seleccione Guardar.

5. Pruebe la ejecución del runbook en el panel de pruebas. Después de confirmar los resultados, seleccione Publicar para publicar el runbook y ejecutarlo.

REST API

PUT 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runbooks/<runbookName>?api-version=2024-10-23


{ 
  "properties": { 
        "runbookType": "PowerShell", 
        "runtimeEnvironment": <runtimeEnvironmentName>, 
        "publishContentLink": { 
            "uri": "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-automation-runbook-getvms/Runbooks/Get-AzureVMTutorial.ps1" 
        } 
    }, 
   "location": "East US"
}

Pasos siguientes

• Consulte Administración del entorno en tiempo de ejecución para ver las distintas operaciones a través del portal y la API REST.