Editar runbooks de texto en Azure Automation

  • Artículo

Puede utilizar el editor de texto de Azure Automation para editar runbooks de PowerShell y runbooks del flujo de trabajo de PowerShell. Este editor tiene las características típicas de otros editores de código, como IntelliSense. También utiliza codificación de colores con características especiales adicionales que le ayudarán a acceder a los recursos comunes para los runbooks.

El editor de texto incluye una característica para insertar código para cmdlets, los recursos y los runbooks secundarios en un runbook. En lugar de escribir en el código personalmente, puede seleccionar entre una lista de recursos disponibles y el editor inserta el código adecuado en el runbook.

Cada runbook de Azure Automation tiene dos versiones: una de borrador y otra publicada. Edite la versión de borrador del runbook y después publíquela para que pueda ejecutarse. No se puede editar la versión publicada. Para obtener más información, vea Publicar un runbook.

En este artículo, se proporcionan pasos detallados para realizar diferentes funciones con este editor. No son aplicables a los runbooks gráficos. Para trabajar con estos runbooks, consulte Creación gráfica en Azure Automation.

Importante

No incluya la palabra clave "AzureRm" en ningún script diseñado para ejecutarse con el módulo Az. La inclusión de la palabra clave, incluso en un comentario, puede hacer que AzureRm se cargue y, a continuación, entre en conflicto con el módulo Az.

Edición de un runbook con Azure Portal

  1. En Azure Portal, seleccione su cuenta de Automation.
  2. En AUTOMATIZACIÓN DE PROCESOS, seleccione Runbooks para abrir la lista de runbooks.
  3. Elija el runbook que desea editar y, a continuación, haga clic en Editar.
  4. Edite el runbook.
  5. Haga clic en Guardar cuando termine las modificaciones.
  6. Haga clic en Publicar si desea publicar la última versión de borrador del runbook.

Inserción de un cmdlet en un runbook

  1. En el lienzo del editor de texto, coloque el cursor donde desee colocar el cmdlet.
  2. Expanda el nodo Cmdlets en el control Biblioteca.
  3. Expanda el módulo que contiene el cmdlet que desea usar.
  4. Haga clic con el botón derecho en el nombre del cmdlet para insertarlo y seleccione Agregar al lienzo. Si el cmdlet tiene más de un conjunto de parámetros, el editor agrega el conjunto predeterminado. También puede expandir el cmdlet para seleccionar un conjunto de parámetros diferente.
  5. Observe que el código del cmdlet se inserta con toda su lista de parámetros.
  6. Proporcione un valor adecuado en lugar del valor entre corchetes (<>) para los parámetros necesarios. Quite todos los parámetros que no sean necesarios.

Inserción del código de un runbook secundario en un runbook

  1. En el lienzo del editor de texto, coloque el cursor donde desee colocar el código del runbook secundario.
  2. Expanda el nodo Runbooks en el control Biblioteca.
  3. Haga clic con el botón derecho en el runbook para insertarlo y seleccione Agregar al lienzo.
  4. Se inserta el código para el runbook secundario con los marcadores de posición de los parámetros de runbook.
  5. Reemplace los marcadores de posición por valores adecuados para cada parámetro.

Inserción de un recurso en un runbook

  1. En el control Lienzo del editor de texto, coloque el cursor donde desee colocar el código del runbook secundario.
  2. Expanda el nodo Recursos en el control Biblioteca.
  3. Expanda el nodo del tipo de recurso deseado.
  4. Haga clic con el botón derecho en el nombre del recurso para insertarlo y seleccione Agregar al lienzo. Para recursos variables, seleccione Agregar "Obtener variable" a lienzo o Agregar "Establecer variable" a lienzo en función de si desea obtener o establecer la variable.
  5. Observe que el código del recurso se inserta en el runbook.

Edición de un runbook de Azure Automation mediante Windows PowerShell

Para editar un runbook con Windows PowerShell, use el editor de su elección y guarde el runbook en un archivo .ps1. Puede usar el cmdlet Export-AzAutomationRunbook para recuperar el contenido del runbook. Puede usar el cmdlet Import-AzAutomationRunbook para reemplazar el runbook de borrador existente por el modificado.

Recuperación del contenido de un runbook mediante Windows PowerShell

En los siguientes comandos de ejemplo, se muestra cómo se recupera el script para un runbook y se guarda en un archivo de script. En este ejemplo, se recupera la versión de borrador. También es posible recuperar la versión publicada del runbook, aunque esta no se puede cambiar.

$resourceGroupName = "MyResourceGroup"
$automationAccountName = "MyAutomatonAccount"
$runbookName = "Hello-World"
$scriptFolder = "c:\runbooks"

Export-AzAutomationRunbook -Name $runbookName -AutomationAccountName $automationAccountName -ResourceGroupName $resourceGroupName -OutputFolder $scriptFolder -Slot Draft

Modificación del contenido de un runbook mediante Windows PowerShell

En los siguientes comandos de ejemplo, se muestra cómo reemplazar el contenido existente de un runbook por el de un archivo de script.

$resourceGroupName = "MyResourceGroup"
$automationAccountName = "MyAutomatonAccount"
$runbookName = "Hello-World"
$scriptFolder = "c:\runbooks"

Import-AzAutomationRunbook -Path "$scriptfolder\Hello-World.ps1" -Name $runbookName -Type PowerShell -AutomationAccountName $automationAccountName -ResourceGroupName $resourceGroupName -Force
Publish-AzAutomationRunbook -Name $runbookName -AutomationAccountName $automationAccountName -ResourceGroupName $resourceGroupName

Pasos siguientes