Mengedit runbook tekstual di Azure Automation

  • Artikel

Anda dapat menggunakan editor tekstual di Azure Automation untuk mengedit runbook PowerShell dan runbook Alur Kerja PowerShell. Editor ini memiliki fitur khas editor kode lain, seperti IntelliSense. Ini juga menggunakan pengodean warna dengan fitur khusus tambahan untuk membantu Anda dalam mengakses sumber daya yang umum untuk runbook.

Editor tekstual menyertakan fitur untuk menyisipkan kode untuk cmdlet, aset, dan runbook anak ke dalam runbook. Alih-alih mengetik kode sendiri, Anda dapat memilih dari daftar sumber daya yang tersedia dan editor menyisipkan kode yang sesuai ke dalam runbook.

Setiap runbook di Azure Automation memiliki dua versi, Draf dan Dipublikasikan. Anda mengedit versi Draf dari runbook lalu menerbitkannya sehingga dapat dieksekusi. Versi Yang Dipublikasikan tak bisa diedit. Untuk informasi selengkapnya, lihat Menerbitkan runbook.

Artikel ini memberikan langkah-langkah terperinci untuk melakukan fungsi yang berbeda dengan editor ini. Ini tidak berlaku untuk runbook grafis. Untuk bekerja dengan runbook ini, lihat Penulisan grafis di Azure Automation.

Penting

Jangan sertakan kata kunci "AzureRm" dalam skrip apa pun yang dirancang untuk dieksekusi dengan modul Az. Penyertaan kata kunci, bahkan dalam komentar, dapat menyebabkan AzureRm dimuat dan kemudian mengalami konflik dengan modul Az.

Mengedit runbook dengan portal Azure

  1. Di portal Azure, buka akun Otomatisasi Anda.
  2. Di bawah OTOMATISASI PROSES, pilih Runbook untuk membuka daftar runbook.
  3. Pilih runbook yang akan diedit lalu klik Edit.
  4. Edit runbook.
  5. Klik Simpan begitu pengeditan selesai.
  6. Klik Terbitkan jika Anda ingin menerbitkan versi draf runbook terbaru.

Menyisipkan cmdlet ke dalam runbook

  1. Di kanvas editor tekstual, letakkan kursor di tempat Anda ingin menempatkan cmdlet.
  2. Perluas node Cmdlets di kontrol Pustaka.
  3. Perluas modul yang berisi cmdlet yang akan digunakan.
  4. Klik kanan nama cmdlet yang akan disisipkan dan pilih Tambahkan ke kanvas. Jika cmdlet memiliki lebih dari satu set parameter, editor menambahkan set default. Anda juga dapat memperluas cmdlet untuk memilih kumpulan parameter yang berbeda.
  5. Perhatikan bahwa kode untuk cmdlet disisipkan dengan seluruh daftar parameternya.
  6. Berikan nilai yang sesuai sebagai ganti nilai yang dikelilingi oleh tanda kurung sudut (<>) untuk parameter yang diperlukan. Hapus parameter yang tidak Anda perlukan.

Menyisipkan kode untuk runbook anak ke dalam runbook

  1. Di kanvas editor tekstual, posisikan kursor di tempat Anda ingin menempatkan kode untuk runbook anak.
  2. Perluas node Runbook di kontrol Pustaka.
  3. Klik kanan runbook yang akan disisipkan dan memilih Tambahkan ke kanvas.
  4. Kode untuk runbook anak disisipkan dengan tempat penampung untuk parameter runbook.
  5. Ganti tempat penampung dengan nilai yang sesuai untuk setiap parameter.

Menyisipkan aset ke dalam runbook

  1. Di kontrol Kanvas editor tekstual, posisikan kursor di tempat Anda ingin menempatkan kode untuk runbook anak.
  2. Perluas node Aset di kontrol Pustaka.
  3. Perluas node untuk tipe aset yang diinginkan.
  4. Klik kanan nama aset yang akan disisipkan dan pilih Tambahkan ke kanvas. Untuk aset variabel, pilih Tambahkan "Dapatkan Variabel" ke kanvas atau Tambahkan "Atur Variabel" ke kanvas, tergantung apakah Anda ingin mendapatkan atau mengatur variabel.
  5. Perhatikan bahwa kode untuk aset disisipkan ke dalam runbook.

Mengedit runbook Azure Automation menggunakan Windows PowerShell

Untuk mengedit runbook dengan Windows PowerShell, gunakan editor pilihan Anda dan simpan runbook ke file .ps1. Anda dapat menggunakan cmdlet Export-AzAutomationRunbook untuk mengambil isi runbook. Anda dapat menggunakan cmdlet Import-AzAutomationRunbook untuk mengganti runbook draf yang ada dengan yang dimodifikasi.

Mengambil konten runbook menggunakan Windows PowerShell

Sampel perintah berikut menunjukkan cara mengambil skrip untuk runbook dan menyimpannya ke file skrip. Dalam contoh ini, versi Draf diambil. Ada kemungkinan juga untuk mengambil versi runbook yang dipublikasikan, meskipun versi ini tidak dapat diubah.

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

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

Mengubah konten runbook menggunakan Windows PowerShell

Contoh perintah berikut menunjukkan cara mengganti konten runbook yang ada dengan konten file skrip.

$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

Langkah berikutnya