Aracılığıyla paylaş

Azure Otomasyonu'de metin runbook'larını düzenleme

  • Makale

PowerShell runbook'larını ve PowerShell İş Akışı runbook'larını düzenlemek için Azure Otomasyonu'deki metin düzenleyicisini kullanabilirsiniz. Bu düzenleyici, IntelliSense gibi diğer kod düzenleyicilerinin tipik özelliklerine sahiptir. Ayrıca runbook'larda ortak olan kaynaklara erişmenize yardımcı olmak için ek özel özellikler içeren renk kodlaması kullanır.

Metin düzenleyicisi, bir runbook'a cmdlet'ler, varlıklar ve alt runbook'lar için kod ekleme özelliği içerir. Kodu kendiniz yazmak yerine, kullanılabilir kaynaklar listesinden seçim yapabilirsiniz ve düzenleyici runbook'a uygun kodu ekler.

Azure Otomasyonu'daki her runbook'un Taslak ve Yayımlanan adlı iki sürümü vardır. Runbook'un Taslak sürümünü düzenler ve yürütülebilmesi için yayımlarsınız. Yayımlanan sürüm düzenlenemez. Daha fazla bilgi için bkz . Runbook yayımlama.

Bu makalede, bu düzenleyiciyle farklı işlevler gerçekleştirmeye yönelik ayrıntılı adımlar sağlanır. Bunlar grafik runbook'lar için geçerli değildir. Bu runbook'larla çalışmak için bkz. Azure Otomasyonu'de grafik yazma.

Önemli

Az modülüyle yürütülmek üzere tasarlanmış betiklere "AzureRm" anahtar sözcüğünü eklemeyin. Anahtar sözcüğün bir açıklamaya dahil edilmesi, AzureRm'nin yüklenmesine ve ardından Az modülüyle çakışmasına neden olabilir.

Azure portalı ile runbook'u düzenleme

  1. Azure portalında Otomasyon hesabınızı seçin.
  2. İŞLEM OTOMASYONU'nun altında Runbook'lar'ı seçerek runbook'ların listesini açın.
  3. Düzenlenecek runbook'u seçin ve düzenle'ye tıklayın.
  4. Runbook'u düzenleyin.
  5. Düzenlemeleriniz tamamlandığında Kaydet 'e tıklayın.
  6. Runbook'un en son taslak sürümünü yayımlamak istiyorsanız Yayımla'ya tıklayın.

Runbook'a cmdlet ekleme

  1. Metin düzenleyicisinin tuvalinde, imleci cmdlet'ini yerleştirmek istediğiniz yere getirin.
  2. Kitaplık denetiminde Cmdlet'ler düğümünü genişletin.
  3. Kullanılacak cmdlet'i içeren modülü genişletin.
  4. Eklemek için cmdlet adına sağ tıklayın ve Tuvale ekle'yi seçin. Cmdlet'in birden fazla parametre kümesi varsa, düzenleyici varsayılan kümeyi ekler. Farklı bir parametre kümesi seçmek için cmdlet'ini de genişletebilirsiniz.
  5. Cmdlet kodunun parametre listesinin tamamıyla eklendiğini unutmayın.
  6. Gerekli parametreler için köşeli ayraçlarla (<>) çevrili değerin yerine uygun bir değer sağlayın. İhtiyacınız olmayan parametreleri kaldırın.

Bir runbook'a alt runbook için kod ekleme

  1. Metin düzenleyicisinin tuvalinde, imleci alt runbook'un kodunu yerleştirmek istediğiniz yere getirin.
  2. Kitaplık denetiminde Runbook'lar düğümünü genişletin.
  3. Eklemek için runbook'a sağ tıklayın ve Tuvale ekle'yi seçin.
  4. Alt runbook'un kodu, herhangi bir runbook parametresi için yer tutucularla eklenir.
  5. Yer tutucuları her parametre için uygun değerlerle değiştirin.

Runbook'a varlık ekleme

  1. Metin düzenleyicisinin Tuval denetiminde, imleci alt runbook'un kodunu yerleştirmek istediğiniz yere getirin.
  2. Kitaplık denetimindeki Varlıklar düğümünü genişletin.
  3. İstenen varlık türü için düğümü genişletin.
  4. Eklenecek varlık adına sağ tıklayın ve Tuvale ekle'yi seçin. Değişken varlıkları için, değişkeni almak mı yoksa ayarlamak mı istediğinize bağlı olarak Tuvale "Değişken Al" veya Tuvale "Değişken Ayarla" ekle'yi seçin.
  5. Varlığın kodunun runbook'a eklendiğini unutmayın.

Windows PowerShell kullanarak Azure Otomasyonu runbook'larını düzenleme

Bir runbook'u Windows PowerShell ile düzenlemek için istediğiniz düzenleyiciyi kullanın ve runbook'u bir .ps1 dosyasına kaydedin. Runbook'un içeriğini almak için Export-AzAutomationRunbook cmdlet'ini kullanabilirsiniz. Var olan taslak runbook'u değiştirilen runbook ile değiştirmek için Import-AzAutomationRunbook cmdlet'ini kullanabilirsiniz.

Windows PowerShell kullanarak runbook'un içeriğini alma

Aşağıdaki örnek komutlarda bir runbook için betiğin nasıl alınacağı ve bir betik dosyasına kaydedileceği gösterilmektedir. Bu örnekte Taslak sürümü alınmaktadır. Runbook'un Yayımlanan sürümünü almak da mümkündür, ancak bu sürüm değiştirilemez.

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

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

Windows PowerShell kullanarak runbook'un içeriğini değiştirme

Aşağıdaki örnek komutlar, bir runbook'un mevcut içeriğinin bir betik dosyasının içeriğiyle nasıl değiştirileceğini gösterir.

$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

Sonraki adımlar