Azure Otomasyonu'nda runbook yönetimi

Azure Otomasyonu'a, yeni bir runbook oluşturarak ya da mevcut bir runbook'u bir dosyadan veya Runbook Galerisi'nden içeri aktararak bir runbook ekleyebilirsiniz. Bu makale, runbook yönetimine ilişkin bilgiler ile runbook tasarımına yönelik önerilen örüntüleri ve en iyi uygulamaları sunar. Topluluk runbook'larına ve modüllerine erişmenin tüm ayrıntılarını Azure Otomasyonu için Runbook ve modül galerilerinde bulabilirsiniz.

Runbook oluştur

Azure portalını veya PowerShell'i kullanarak Azure Otomasyonu'da yeni bir runbook oluşturun. Runbook oluşturulduktan sonra, şu bilgilerden yararlanarak runbook'u düzenleyebilirsiniz:

Azure portalında runbook oluşturun

  1. Azure Portal’ında oturum açın.
  2. Otomasyon Hesapları'nı arayın ve seçin.
  3. Otomasyon Hesapları sayfasında, listeden Otomasyon hesabınızı seçin.
  4. Runbook listesini açmak için Otomasyon hesabından, İşlem Otomasyonu altında Runbooklar seçeneğini belirleyin.
  5. Runbook oluştur seçeneğine tıklayın.
    1. Runbook'u adlandırın.
    2. Runbook türü açılan listesinden. Türünü seçin. Runbook adı bir harfle başlamalıdır ve harfler, rakamlar, alt çizgiler ve kısa çizgiler içerebilir
    3. Çalışma zamanı sürümünü seçin
    4. Geçerli Açıklamayı girin
  6. Runbook oluşturmak için Oluştur’a tıklayın.

PowerShell ile runbook oluşturma

Boş bir runbook oluşturmak için New-AzAutomationRunbook cmdlet'ini kullanın. Type için tanımlanan runbook türlerinden birini belirtmek için New-AzAutomationRunbookparametresini kullanın.

Aşağıdaki örnekte yeni bir boş runbook'un nasıl oluşturulacağı gösterilmektedir.

$params = @{
    AutomationAccountName = 'MyAutomationAccount'
    Name                  = 'NewRunbook'
    ResourceGroupName     = 'MyResourceGroup'
    Type                  = 'PowerShell'
}
New-AzAutomationRunbook @params

Runbook'u içeri aktarma

Kendi runbook’unuzu oluşturmak için bir PowerShell veya PowerShell İş Akışı (.ps1) betiğini, grafik bir runbook’u (.graphrunbook) ya da bir Python 2 veya Python 3 betiğini (.py) içeri aktarabilirsiniz. Aşağıdaki hususları göz önünde bulundurarak, içeri aktarma sırasında oluşturulan runbook türünü belirtirsiniz.

  • İş akışı içermeyen bir .ps1 dosyasını PowerShell runbook'unaveya PowerShell İş Akışı runbook'una aktarabilirsiniz. Bir PowerShell İş Akışı runbook'una aktarırsanız, iş akışına dönüştürülür. Bu durumda, yapılan değişiklikleri açıklamak için açıklamalar runbook'a eklenir.

  • Yalnızca PowerShell İş Akışı içeren bir .ps1 dosyasını PowerShell İş Akışı runbook'una aktarabilirsiniz. Dosyada birden çok PowerShell iş akışı varsa içeri aktarma işlemi başarısız olur. Her iş akışını kendi dosyasına kaydetmeniz ve her bir iş akışını ayrı olarak içeri aktarmanız gerekir.

  • PowerShell betik altyapısı bunu tanıyamadığından, PowerShell İş Akışı içeren bir .ps1 dosyasını PowerShell runbook'una içeri aktarmayın.

  • Bir .graphrunbook dosyasını yalnızca yeni bir grafik runbook'a aktarabilirsiniz.

Azure portalından runbook'u içeri aktarma

Bir betik dosyasını Azure Otomasyonu içeri aktarmak için aşağıdaki yordamı kullanabilirsiniz.

Not

Portalı kullanarak bir .ps1 dosyasını yalnızca PowerShell İş Akışı runbook'una aktarabilirsiniz.

  1. Azure portal'da Otomasyon Hesapları'nı bulun ve seçin.
  2. Otomasyon Hesapları sayfasında, listeden Otomasyon hesabınızı seçin.
  3. Otomasyon hesabında İşlem Otomasyonu'nun altındaki Runbook'lar'ı seçerek runbook listesini açın.
  4. Runbook içeri aktar'a tıklayın. Aşağıdaki seçeneklerden birini belirleyebilirsiniz:
    1. Dosyaya gözat - yerel makinenizden bir dosya seçer.
    2. Galeriden göz at - Galerideki mevcut bir runbook’a göz atabilir ve seçebilirsiniz.
  5. Dosyayı seçin.
  6. Ad alanı etkinleştirilmişse, runbook adını değiştirebilirsiniz. Ad bir harfle başlamalıdır ve harf, sayı, alt çizgi ve kısa çizgi içerebilir.
  7. Runbook türü otomatik olarak doldurulur, ancak geçerli kısıtlamaları dikkate aldıktan sonra türü değiştirebilirsiniz.
  8. Çalışma zamanı sürümü otomatik olarak doldurulur veya açılan listeden sürümü seçin.
  9. İçe aktar'a tıklayın. Yeni runbook, Otomasyon hesabının runbook'lar listesinde görüntülenir.
  10. Çalıştırabilmeniz için önce runbook’u yayımlamanız gerekir.

Not

Grafiksel runbook'u içeri aktardıktan sonra onu başka bir türe dönüştürebilirsiniz. Ancak, grafiksel bir runbook’u metin tabanlı bir runbook’a dönüştüremezsiniz.

PowerShell kullanarak runbook'u içeri aktarma

Bir betik dosyasını taslak runbook olarak içeri aktarmak için Import-AzAutomationRunbook cmdlet'ini kullanın. Runbook zaten varsa, cmdlet ile Force parametresini kullanmadığınız sürece içe aktarma başarısız olur.

Aşağıdaki örnek, bir betik dosyasının runbook'a nasıl aktarılacağını gösterir.

$params = @{
    AutomationAccountName = 'MyAutomationAccount'
    Name                  = 'Sample_TestRunbook'
    ResourceGroupName     = 'MyResourceGroup'
    Type                  = 'PowerShell'
    Path                  = 'C:\Runbooks\Sample_TestRunbook.ps1'
}
Import-AzAutomationRunbook @params

Kaynakları işleme

Runbook’unuz bir kaynak oluşturuyorsa, betik kaynağı oluşturmaya çalışmadan önce kaynağın zaten var olup olmadığını kontrol etmelidir. İşte temel bir örnek.

$vmName = 'WindowsVM1'
$rgName = 'MyResourceGroup'
$myCred = Get-AutomationPSCredential 'MyCredential'

$vmExists = Get-AzResource -Name $vmName -ResourceGroupName $rgName
if (-not $vmExists) {
    Write-Output "VM $vmName does not exist, creating"
    New-AzVM -Name $vmName -ResourceGroupName $rgName -Credential $myCred
} else {
    Write-Output "VM $vmName already exists, skipping"
}

Etkinlik günlüğünden ayrıntıları alma

Otomasyon hesabının Etkinlik günlüğü bölümünden, runbook'u başlatan kişi veya hesap gibi runbook ayrıntılarına erişebilirsiniz. Aşağıdaki PowerShell örneği, belirtilen runbook'u çalıştıracak son kullanıcıyı sağlar.

$rgName = 'MyResourceGroup'
$accountName = 'MyAutomationAccount'
$runbookName = 'MyRunbook'
$startTime = (Get-Date).AddDays(-1)

$params = @{
    ResourceGroupName = $rgName
    StartTime         = $startTime
}
$JobActivityLogs = (Get-AzLog @params).Where( { $_.Authorization.Action -eq 'Microsoft.Automation/automationAccounts/jobs/write' })

$JobInfo = @{}
foreach ($log in $JobActivityLogs) {
    # Get job resource
    $JobResource = Get-AzResource -ResourceId $log.ResourceId

    if ($null -eq $JobInfo[$log.SubmissionTimestamp] -and $JobResource.Properties.Runbook.Name -eq $runbookName) {
        # Get runbook
        $jobParams = @{
            ResourceGroupName     = $rgName
            AutomationAccountName = $accountName
            Id                    = $JobResource.Properties.JobId
        }
        $Runbook = Get-AzAutomationJob @jobParams | Where-Object RunbookName -EQ $runbookName

        # Add job information to hashtable
        $JobInfo.Add($log.SubmissionTimestamp, @($Runbook.RunbookName, $Log.Caller, $JobResource.Properties.jobId))
    }
}
$JobInfo.GetEnumerator() | Sort-Object Key -Descending | Select-Object -First 1

İlerleme izleme

Runbook'larınızı kolayca yeniden kullanılabilen ve yeniden başlatabileceğiniz mantıkla modüler olacak şekilde yazmak iyi bir uygulamadır. Runbook'taki ilerleme durumunu izleme, sorun olduğunda runbook mantığının doğru şekilde yürütülmesini sağlar.

Depolama hesabı, veritabanı veya paylaşılan dosyalar gibi bir dış kaynak kullanarak runbook'un ilerleme durumunu izleyebilirsiniz. İlk olarak gerçekleştirilen son eylemin durumunu denetlemek için runbook'unuzda mantık oluşturun. Ardından, denetim sonuçlarına göre mantık, runbook'taki belirli görevleri atlayabilir veya yürütmeye devam edebilir.

Eşzamanlı işleri engelleme

Bazı runbook'lar aynı anda birden fazla işte çalıştıklarında beklenmedik davranabilir. Bu durumda, bir runbook'un halihazırda çalışan bir iş olup olmadığını belirleyecek bir mantık içermesi önemlidir. İşte temel bir örnek.

# Ensures you do not inherit an AzContext in your runbook
Disable-AzContextAutosave -Scope Process

# Connect to Azure with system-assigned managed identity 
$AzureContext = (Connect-AzAccount -Identity).context

# set and store context 
$AzureContext = Set-AzContext -SubscriptionName $AzureContext.Subscription -DefaultProfile $AzureContext

# Check for already running or new runbooks 
$runbookName = "runbookName" 
$resourceGroupName = "resourceGroupName" 
$automationAccountName = "automationAccountName"

$jobs = Get-AzAutomationJob -ResourceGroupName $resourceGroupName -AutomationAccountName $automationAccountName -RunbookName $runbookName -DefaultProfile $AzureContext

# Ranking all the active jobs
$activeJobs = $jobs | where {$_.status -eq 'Running' -or $_.status -eq 'Queued' -or $_.status -eq 'New' -or $_.status -eq 'Activating' -or $_.status -eq 'Resuming'} | Sort-Object -Property CreationTime 
$jobRanking = @() 
$rank = 0 
ForEach($activeJob in $activeJobs) 
{         
    $rank = $rank + 1 
    $activeJob | Add-Member -MemberType NoteProperty -Name jobRanking -Value $rank -Force 
    $jobRanking += $activeJob 
}
    
$AutomationJobId = $PSPrivateMetadata.JobId.Guid 
$currentJob = $activeJobs | where {$_.JobId -eq $AutomationJobId} 
$currentJobRank = $currentJob.jobRanking 

# Only allow the Job with Rank = 1 to start processing. 
If($currentJobRank -ne "1") 
{ 
    Write-Output "$(Get-Date -Format yyyy-MM-dd-hh-mm-ss.ffff) Concurrency check failed as Current Job Ranking is not 1 but $($currentJobRank) therefore exiting..." 
    Exit 
} Else
{
    Write-Output "$(Get-Date -Format yyyy-MM-dd-hh-mm-ss.ffff) Concurrency check passed. Start processing.." 
} 

Runbook'un sistem tarafından atanan yönetilen kimlikle yürütülmesini istiyorsanız, kodu olduğu gibi bırakın. Kullanıcı tarafından atanan bir yönetilen kimlik kullanmayı tercih ediyorsanız:

  1. 5. satırdan $AzureContext = (Connect-AzAccount -Identity).context ögesini kaldırın,
  2. Bunu $AzureContext = (Connect-AzAccount -Identity -AccountId <ClientId>).context ile değiştirin ve
  3. İstemci Kimliğini girin.

Not

PowerShell 7.2 karma işleri için 28. satırda değişiklik yapın. $PSPrivateMetadata.JobId.Guid öğesini $env:PSPrivateMetaData ile değiştirin.

Zamana bağlı komut dosyasında geçici hataları işleyin

Runbook’larınız sağlam olmalı ve yeniden başlatılmalarına veya başarısız olmalarına neden olabilecek geçici hatalar da dahil olmak üzere hataları işleyebilmelidir. Bir runbook başarısız olursa Azure Otomasyonu bunu yeniden dener.

Runbook'unuz normalde belirli bir süre kısıtı içinde çalışıyorsa, betiğin çalışma süresini denetleyecek bir mantık içermesini sağlayın. Bu denetim yalnızca belirli zamanlarda başlatma, kapatma veya ölçeği genişletme gibi işlemlerin çalıştırılmasını sağlar.

Not

Azure korumalı alan işlemindeki yerel saat UTC olarak ayarlanır. Runbook'larınızdaki tarih ve saat hesaplamaları bu olguyu dikkate almalıdır.

Geçici hataları önlemek için runbook'ta yeniden deneme mantığı

Runbook'lar genellikle ARM, Azure Kaynak Grafı, SQL hizmetleri ve diğer web hizmetleri aracılığıyla Azure gibi uzak sistemlere çağrı yapar. Runbook’ların çağırdığı sistem meşgulse, geçici olarak kullanılamıyorsa veya yük altında kısıtlama uyguluyorsa, çağrılarda çalışma zamanı hataları oluşabilir. Runbook'lara dayanıklılık kazandırmak için, çağrıları yaparken yeniden deneme mantığını uygulamanız gerekir; böylece runbook'lar geçici sorunlarla başarısız olmadan başa çıkabilir.

Daha fazla bilgi için Bkz . Yeniden deneme düzeni ve Genel REST ve yeniden deneme yönergeleri.

Örnek 1: Runbook'unuz yalnızca bir veya iki çağrı yapıyorsa

$searchServiceURL = "https://$searchServiceName.search.windows.net"
$resource = Get-AzureRmResource -ResourceType "Microsoft.Search/searchServices" -ResourceGroupName $searchResourceGroupName -ResourceName  $searchServiceName -ApiVersion 2015-08-19
$searchAPIKey = (Invoke-AzureRmResourceAction -Action listAdminKeys -ResourceId $resource.ResourceId -ApiVersion 2015-08-19 -Force).PrimaryKey

Invoke-AzureRmResourceAction öğesini çağırdığınızda geçici hatalarla karşılaşabilirsiniz. Bu gibi bir senaryoda, cmdlet'ine yapılan çağrının etrafında aşağıdaki temel deseni uygulamanızı öneririz.

$searchServiceURL = "https://$searchServiceName.search.windows.net"
$resource = Get-AzureRmResource -ResourceType "Microsoft.Search/searchServices" -ResourceGroupName $searchResourceGroupName -ResourceName  $searchServiceName -ApiVersion 2015-08-19

    # Adding in a retry
    $Stoploop = $false
    $Retrycount = 0
 
    do {
        try   {
               $searchAPIKey = (Invoke-AzureRmResourceAction -Action listAdminKeys -ResourceId $resource.ResourceId -ApiVersion 2015-08-19 -Force).PrimaryKey
               write-verbose "Invoke-AzureRmResourceAction on $resource.ResourceId completed"
               $Stoploop = $true
              }
        catch {
               if ($Retrycount -gt 3)
                 {
                  Write-verbose "Could not Invoke-AzureRmResourceAction on $resource.ResourceId after 3 retrys."
                  $Stoploop = $true
                 }
               else  
                 {
                  Write-verbose "Could not Invoke-AzureRmResourceAction on $resource.ResourceId retrying in 30 seconds..."
                  Start-Sleep -Seconds 30
                  $Retrycount = $Retrycount + 1
                 }
               }
        }
    While ($Stoploop -eq $false)

Not

Çağrıyı yeniden deneme işlemi, her denemede 30 saniye bekleyerek en fazla üç kez yapılır.

Örnek 2 : Runbook sık sık uzak çağrılar yapıyorsa

Runbook sık sık uzak çağrılar yapıyorsa geçici çalışma zamanı sorunlarıyla karşılaşabilir. Gerçekleştirilen her çağrı için yeniden deneme mantığını uygulayan bir fonksiyon oluşturun ve yapılacak çağrıyı, yürütülecek bir betik bloğu olarak bu fonksiyona geçirin.

Function ResilientRemoteCall {

         param(
               $scriptblock
               )
        
         $Stoploop = $false
         $Retrycount = 0
 
         do {
             try   {
                    Invoke-Command -scriptblock $scriptblock 
                    write-verbose "Invoked $scriptblock completed"
                    $Stoploop = $true
                   }
             catch {
                    if ($Retrycount -gt 3)
                      {
                       Write-verbose "Invoked $scriptblock failed 3 times and we will not try again."
                       $Stoploop = $true
                      }
                    else  
                      {
                       Write-verbose "Invoked $scriptblock failed  retrying in 30 seconds..."
                       Start-Sleep -Seconds 30
                       $Retrycount = $Retrycount + 1
                      }
                    }
             }
         While ($Stoploop -eq $false)
}

Ardından her uzak çağrıyı işlevine şu şekilde geçirebilirsiniz:

ResilientRemoteCall { Get-AzVm }
veya

ResilientRemoteCall { $searchAPIKey = (Invoke-AzureRmResourceAction -Action listAdminKeys -ResourceId $resource.ResourceId -ApiVersion 2015-08-19 -Force).PrimaryKey}

Birden fazla abonelik ile çalışma

Runbook'unuzun aboneliklerle çalışabilmesi gerekir. Örneğin, runbook birden çok aboneliği işlemek için Disable-AzContextAutosave cmdlet'ini kullanır. Bu cmdlet, kimlik doğrulama bağlamının aynı korumalı alanda çalışan başka bir runbook'tan alınmamasını sağlar.

# Ensures you do not inherit an AzContext in your runbook
Disable-AzContextAutosave -Scope Process

# Connect to Azure with system-assigned managed identity
$AzureContext = (Connect-AzAccount -Identity).context

# set and store context
$AzureContext = Set-AzContext -SubscriptionName $AzureContext.Subscription `
    -DefaultProfile $AzureContext

$childRunbookName = 'childRunbookDemo'
$resourceGroupName = "resourceGroupName"
$automationAccountName = "automationAccountName"

$startParams = @{
    ResourceGroupName     = $resourceGroupName
    AutomationAccountName = $automationAccountName
    Name                  = $childRunbookName
    DefaultProfile        = $AzureContext
}
Start-AzAutomationRunbook @startParams

Runbook'un sistem tarafından atanan yönetilen kimlikle yürütülmesini istiyorsanız, kodu olduğu gibi bırakın. Kullanıcı tarafından atanan bir yönetilen kimlik kullanmayı tercih ediyorsanız:

  1. 5. satırdan $AzureContext = (Connect-AzAccount -Identity).context ögesini kaldırın,
  2. Bunu $AzureContext = (Connect-AzAccount -Identity -AccountId <ClientId>).context ile değiştirin ve
  3. İstemci Kimliğini girin.

Özel betikle çalışma

Not

Log Analytics aracısının yüklü olduğu ana bilgisayarda özel betikleri ve runbook'ları normalde çalıştıramazsınız.

Özel betik kullanmak için:

  1. Otomasyon hesabı oluşturun.
  2. Hibrit Runbook Worker rolünü dağıtın.

Bir runbook’u test edin

Bir runbook'u test ettiğinizde, Taslak sürüm çalıştırılır ve gerçekleştirdiği tüm eylemler de tamamlanır. İş geçmişi oluşturulmaz, ancak çıkış ve uyarı ile hata akışları Test çıktısıbölmesinde görüntülenir. ayrıntılı akışa gönderilen iletiler, yalnızca VerbosePreference değişkeni Continue olarak ayarlanmışsa Çıkış bölmesinde görüntülenir.

Taslak sürümü çalıştırılıyor olsa da runbook normal şekilde yürütülür ve ortamdaki kaynaklar üzerinde gerekli işlemleri gerçekleştirir. Bu nedenle runbook'ları yalnızca üretim dışı kaynaklarda test etmelisiniz.

Not

Tüm runbook yürütme eylemleri, işlem adı Bir Azure Otomasyonu işi oluştur olacak şekilde otomasyon hesabının Etkinlik Günlüğü'ne kaydedilir. Ancak runbook'un taslak sürümünün yürütüldüğü bir test bölmesindeki runbook yürütme işlemi, etkinlik günlüklerine Azure Otomasyonu runbook taslağı yazma işlemi adıyla kaydedilir. İşlem ve JSON sekmesini seçerek ../runbooks/(runbook name)/draft/testjob ile biten kapsamı görüntüleyin.

Her runbook türünü test etme yordamı aynıdır. Azure portal metin düzenleyici ile grafik düzenleyici arasında test etmede fark yoktur.

  1. Runbook'un Taslak sürümünü metin düzenleyicisinde veya grafik düzenleyicideaçın.
  2. Test sayfasını açmak için Test'etıklayın.
  3. Runbook'un parametreleri varsa bunlar sol bölmede listelenir ve burada test için kullanılacak değerleri sağlayabilirsiniz.
  4. Testi Karma Runbook Çalışanı üzerinde çalıştırmak istiyorsanız, Çalıştırma Ayarları'nı Karma Çalışanı olarak değiştirin ve hedef grubun adını seçin. Aksi takdirde, testi bulutta çalıştırmak için varsayılan Azure'ı koruyun.
  5. Testi başlatmak için Başlat'a tıklayın.
  6. PowerShell Workflow veya grafik runbook’u test edilirken durdurmak ya da askıya almak için Çıkış bölmesinin altındaki düğmeleri kullanabilirsiniz. Bir runbook'u askıya aldığınızda, askıya alınmadan önce mevcut etkinliği tamamlar. Runbook askıya alındıktan sonra, onu durdurabilir veya yeniden başlatabilirsiniz.
  7. Runbook çıktısını Çıktı bölmesinde inceleyin.

Çalıştırma kitabı yayımla

Yeni bir runbook oluşturduğunuzda veya içeri aktardığınızda runbook'u çalıştırmadan önce yayımlamanız gerekir. Azure Otomasyonu'daki her runbook'un taslak sürümü ve Yayımlanmış sürümü vardır. Yalnızca Yayımlanan sürüm çalıştırılabilir ve yalnızca Taslak sürüm düzenlenebilir. Yayımlanan sürüm Taslak sürümdeki herhangi bir değişiklikten etkilenmez. Taslak sürümün kullanıma sunulması gerektiğinde, Taslak sürümü yayımlayarak mevcut Yayımlanmış sürümün üzerine yazarsınız.

Azure portalında runbook'u yayımlayın

  1. Azure portal'da Otomasyon Hesapları'nı bulun ve seçin.
  2. Otomasyon Hesapları sayfasında, listeden Otomasyon hesabınızı seçin.
  3. Otomasyon hesabınızdaki çalışma kitabını açın.
  4. Düzenle'yi tıklatın.
  5. Yayımla'ya tıklayın ve doğrulama iletisine yanıt olarak Evet'i seçin.

PowerShell ile runbook yayımlama

Runbook'unuzu yayımlamak için Publish-AzAutomationRunbook cmdlet'ini kullanın.

$accountName = "MyAutomationAccount"
$runbookName = "Sample_TestRunbook"
$rgName = "MyResourceGroup"

$publishParams = @{
    AutomationAccountName = $accountName
    ResourceGroupName     = $rgName
    Name                  = $runbookName
}
Publish-AzAutomationRunbook @publishParams

Azure portalda runbook zamanlama

Runbook'unuz yayımlandığında, bunu işlem için zamanlayabilirsiniz:

  1. Azure portal'da Otomasyon Hesapları'nı bulun ve seçin.
  2. Otomasyon Hesapları sayfasında, listeden Otomasyon hesabınızı seçin.
  3. Runbook'lar listenizden istediğiniz runbook'u seçin.
  4. Kaynaklar seçeneğinin altında Planlamalar seçeneğini seçin.
  5. Planlama ekle seçeneğini işaretleyin.
  6. Runbook Planla bölmesinde Runbook'unuza planlama ekle seçeneğini işaretleyin.
  7. Planlama bölmesinde Yeni planlama oluştur seçeneğini işaretleyin.
  8. Yeni planlama bölmesine bir isim, açıklama ve diğer parametreleri girin.
  9. Zamanlama oluşturulduktan sonra, bunu vurgulayın ve Tamam'a tıklayın. Şimdi runbook'unuza bağlanmalıdır.
  10. Runbook’un durumunu bildiren bir e-posta için posta kutunuzu kontrol edin.

Silinen runbook'u geri yükleyin

Silinen bir runbook'u PowerShell betikleri aracılığıyla kurtarabilirsiniz. Runbook’u kurtarmak için aşağıdaki koşulların sağlandığından emin olun:

  • Geri yüklenecek runbook'lar geçtiğimiz 29 gün içinde silindi.
  • Bu runbook için otomasyon hesabı mevcut.
  • Otomasyon Katkıda Bulunan rol izni, Otomasyon hesabının sistem tarafından atanan yönetilen kimliğine verilir.

PowerShell betiği

  • Silinen runbook’ları geri yüklemek için PowerShell betiğini Automation hesabınızda bir iş olarak çalıştırın.
  • GitHub'dan PowerShell betiğini indirin. Alternatif olarak, Runbook Galerisi'nden Otomasyon runbook'unu Geri Yükle adlı PowerShell betiğini içeri aktarabilirsiniz. Geri yüklenecek runbook’un adını girin ve silinen runbook’ları geri yüklemek için onu Azure Otomasyonu’nda bir iş olarak çalıştırın.
  • Son 29 gün içinde silinen runbook'ların adlarını belirlemek için GitHub'dan betiği indirin veya Runbook Galerisi'nden Silinmiş Otomasyon Runbook'unu Listele adlı PowerShell betiğini içeri aktarın.

İş durumlarını görüntüleme

Azure portalında durumları görüntüleme

Azure Otomasyonu'da işlerin işlenmesine ilişkin ayrıntılar İşler bölümünde sağlanır. Runbook işlerinizi görmeye hazır olduğunuzda Azure portalını kullanın ve Otomasyon hesabınıza erişin. Sağda, İş İstatistikleri bölümünde tüm runbook işlerinin özetini görebilirsiniz.

İş İstatistikleri kutucuğu

Özet, yürütülen her iş için iş durumunun sayısını ve grafik gösterimini görüntüler.

Kutucuğa tıklanması, yürütülen tüm işlerin özetlenmiş listesini içeren İşler sayfasını gösterir. Bu sayfada her işin durumu, runbook adı, başlangıç zamanı ve tamamlanma zamanı gösterilir.

İşler sayfasının ekran görüntüsü.

İşleri filtrele'yi seçerek iş listesini filtreleyebilirsiniz. Belirli bir runbook’a, iş durumuna veya açılan listeden bir seçeneğe göre filtreleyin ve arama için bir zaman aralığı belirtin.

İş durumunu filtreleme

Alternatif olarak, Otomasyon hesabınızdaki Runbook'lar sayfasından bu runbook'u seçip İşler'i seçerek belirli bir runbook'un iş özeti ayrıntılarını görüntüleyebilirsiniz. Bu eylem İşler sayfasını sunar. Buradan bir iş kaydına tıklayarak ayrıntılarını ve çıktısını görüntüleyebilirsiniz.

Hatalar düğmesinin vurgulandığı İşler sayfasının ekran görüntüsü.

PowerShell kullanarak iş durumlarını alma

Bir runbook için oluşturulan görevleri ve belirli bir görevin ayrıntılarını almak için Get-AzAutomationJob cmdlet'ini kullanın. Bir runbook’u Start-AzAutomationRunbook kullanarak başlatırsanız, ortaya çıkan işi döndürür. İş çıktısını almak için Get-AzAutomationJobOutput kullanın.

Aşağıdaki örnek, örnek bir runbook için en son işi alır ve durumunu, runbook parametreleri için sağlanan değerleri ve iş çıktısını görüntüler.

$getJobParams = @{
    AutomationAccountName = 'MyAutomationAccount'
    ResourceGroupName     = 'MyResourceGroup'
    Runbookname           = 'Test-Runbook'
}
$job = (Get-AzAutomationJob @getJobParams | Sort-Object LastModifiedDate -Desc)[0]
$job | Select-Object JobId, Status, JobParameters

$getOutputParams = @{
    AutomationAccountName = 'MyAutomationAccount'
    ResourceGroupName     = 'MyResourceGroup'
    Id                    = $job.JobId
    Stream                = 'Output'
}
Get-AzAutomationJobOutput @getOutputParams

Aşağıdaki örnek, belirli bir işin çıkışını alır ve her kaydı döndürür. Kayıtlardan biri için bir özel durum varsa, betik özel durumu değer yerine yazar. Özel durumlar çıkış sırasında normal olarak günlüğe kaydedilmeyecek ek bilgiler sağlayabildiği için bu davranış yararlıdır.

$params = @{
    AutomationAccountName = 'MyAutomationAccount'
    ResourceGroupName     = 'MyResourceGroup'
    Stream                = 'Any'
}
$output = Get-AzAutomationJobOutput @params

foreach ($item in $output) {
    $jobOutParams = @{
        AutomationAccountName = 'MyAutomationAccount'
        ResourceGroupName     = 'MyResourceGroup'
        Id                    = $item.StreamRecordId
    }
    $fullRecord = Get-AzAutomationJobOutputRecord @jobOutParams

    if ($fullRecord.Type -eq 'Error') {
        $fullRecord.Value.Exception
    } else {
        $fullRecord.Value
    }
}

Sonraki adımlar