Jenis runbook Azure Automation

Batasan

• Untuk versi runtime PowerShell 7.2, aktivitas modul tidak diekstrak untuk modul yang diimpor. Gunakan ekstensi Azure Automation untuk kode VS untuk menyederhanakan pengalaman penulisan runbook.
• PowerShell 7.x tidak mendukung alur kerja. Untuk informasi selengkapnya, lihat Alur kerja PowerShell untuk detail selengkapnya.
• PowerShell 7.x saat ini tidak mendukung runbook yang ditandatangani.
• Integrasi kontrol sumber tidak mendukung PowerShell 7.2. Selain itu, runbook PowerShell 7.2 di kontrol sumber dibuat di akun Automation sebagai Runtime 5.1.
• Modul Az 8.3.0 diinstal secara default. Daftar lengkap modul komponen versi modul Az yang dipilih ditampilkan setelah versi Az dikonfigurasi lagi menggunakan portal Azure atau API.
• Modul PowerShell 7.2 yang diimpor akan divalidasi selama eksekusi pekerjaan. Pastikan bahwa semua dependensi untuk modul yang dipilih juga diimpor untuk keberhasilan eksekusi pekerjaan.
• Runbook Azure tidak mendukung Start-Job dengan -credential.
• Azure tidak mendukung semua parameter input PowerShell. Pelajari selengkapnya.

Masalah yang diketahui

• Runbook yang mengambil dependensi pada jalur file internal seperti C:\modules mungkin gagal karena perubahan infrastruktur backend layanan. Ubah kode runbook untuk memastikan tidak ada dependensi pada jalur file internal dan gunakan Get-ChildItem untuk mendapatkan informasi modul yang diperlukan.

• Get-AzStorageAccount cmdlet mungkin gagal dengan kesalahan: Perintah Get-AzStorageAccount ditemukan dalam modul Az.Storage, tetapi modul tidak dapat dimuat.

• Menjalankan skrip turunan menggunakan .\child-runbook.ps1 tidak didukung.
  Solusi sementara: Gunakan Start-AutomationRunbook (cmdlet internal) atau Start-AzAutomationRunbook (dari modul Az.Automation ) untuk memulai runbook lain dari runbook induk.

• Saat Anda menggunakan versi modul ExchangeOnlineManagement : 3.0.0 atau yang lebih tinggi, Anda dapat mengalami kesalahan. Untuk mengatasi masalah ini, pastikan Anda secara eksplisit mengunggah modul PowerShellGet dan PackageManagement .

• Saat Anda menggunakan New-AzAutomationVariable cmdlet dalam Modul Az.Automation untuk mengunggah variabel objek jenis, operasi tidak berfungsi seperti yang diharapkan.

  Solusi sementara: Konversi objek ke string JSON menggunakan cmdlet ConvertTo-Json lalu unggah variabel dengan string JSON sebagai nilainya. Solusi ini memastikan penanganan variabel yang tepat dalam lingkungan Azure Automation sebagai string JSON.

  Contoh - Membuat objek PowerShell yang telah menyimpan informasi di sekitar Azure VM

    # Retrieve Azure virtual machines with status information for the 'northeurope' region 
    $AzVM = Get-AzVM -Status | Where-Object {$_.Location -eq "northeurope"} 
  
    $VMstopatch = @($AzVM).Id 
    # Create an Azure Automation variable (This cmdlet will not fail, but the variable may not work as intended when used in the runbook.) 
    New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $VMstopatch 
  
    # Convert the object to a JSON string 
    $jsonString = $VMstopatch | ConvertTo-Json 
  
    # Create an Azure Automation variable with a JSON string value (works effectively within the automation runbook) 
    New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $jsonString 
  

Batasan

• Runbook tidak dapat menggunakan pemrosesan paralel untuk menjalankan beberapa tindakan secara paralel.
• Runbook tidak dapat menggunakan titik pemeriksaan untuk melanjutkan runbook jika ada kesalahan.
• Anda hanya dapat menyertakan runbook PowerShell Workflow dan runbook grafis sebagai runbook turunan dengan menggunakan cmdlet Start-AzAutomationRunbook yang menghasilkan pekerjaan baru.
• Runbook tidak dapat menggunakan pernyataan #Requires PowerShell, tidak didukung di kotak pasir Azure atau di Hybrid Runbook Workers dan dapat menyebabkan pekerjaan gagal.
• Runbook Azure tidak mendukung Start-Job dengan -credential.
• Azure tidak mendukung semua parameter input PowerShell. Pelajari selengkapnya.

Masalah yang diketahui

• Runbook yang mengambil dependensi pada jalur file internal seperti C:\modules mungkin gagal karena perubahan infrastruktur backend layanan. Ubah kode runbook untuk memastikan tidak ada dependensi pada jalur file internal dan gunakan Get-ChildItem untuk mendapatkan informasi modul yang diperlukan.

  Contoh skrip

  
  # Get information about module "Microsoft.Graph.Authentication"
  $ModuleName = "Microsoft.Graph.Authentication"
  
  $NewPath = "C:\usr\src\PSModules\$ModuleName"
  $OldPath = "C:\Modules\User\$ModuleName"
  
  if (Test-Path -Path $NewPath -PathType Container) {
      Get-ChildItem -Path $NewPath
  } elseif (Test-Path -Path $OldPath -PathType Container) {
      Get-ChildItem -Path $OldPath
  } else {
      Write-Output "Module $ModuleName not present."
  }
  # Getting the path to the Temp folder, if needed.
  $tmp = $env:TEMP
  
  

• Get-AzStorageAccount cmdlet mungkin gagal dengan kesalahan: Perintah Get-AzStorageAccount ditemukan dalam modul Az.Storage, tetapi modul tidak dapat dimuat.

• Runbook PowerShell tidak dapat mengambil aset variabel yang tidak terenkripsi dengan nilai kosong.

• Runbook PowerShell tidak dapat mengambil aset variabel dengan nama yang memuat *~*.

• Operasi Get-Process dalam loop di runbook PowerShell dapat crash setelah sekitar 80 pengulangan.

• Runbook PowerShell dapat gagal jika runbook mencoba menulis sejumlah besar data ke aliran output sekaligus. Anda biasanya dapat mengatasi masalah ini dengan hanya memberikan informasi yang diperlukan runbook untuk menangani objek berukuran besar. Misalnya, alih-alih menggunakan Get-Process tanpa batasan, Anda dapat memberikan parameter yang diperlukan output cmdlet seperti dalam Get-Process | Select ProcessName, CPU.

• Saat Anda menggunakan versi modul ExchangeOnlineManagement : 3.0.0 atau yang lebih tinggi, Anda mungkin mengalami kesalahan. Untuk mengatasi masalah ini, pastikan Anda secara eksplisit mengunggah modul PowerShellGet dan PackageManagement juga.

• Jika Anda mengimpor modul Az.Accounts dengan versi 2.12.3 atau yang lebih baru, pastikan Anda mengimpor modul Newtonsoft.Json v10 secara eksplisit jika runbook PowerShell 5.1 memiliki dependensi pada versi modul ini. Solusi untuk masalah ini adalah menggunakan runbook PowerShell 7.2.

• Saat Anda menggunakan New-AzAutomationVariable cmdlet dalam Modul Az.Automation untuk mengunggah variabel objek jenis, operasi tidak berfungsi seperti yang diharapkan.

  Solusi sementara: Konversi objek ke string JSON menggunakan cmdlet ConvertTo-Json lalu unggah variabel dengan string JSON sebagai nilainya. Solusi ini memastikan penanganan variabel yang tepat dalam lingkungan Azure Automation sebagai string JSON.

  Contoh - Membuat objek PowerShell yang telah menyimpan informasi di sekitar Azure VM

    # Retrieve Azure virtual machines with status information for the 'northeurope' region 
    $AzVM = Get-AzVM -Status | Where-Object {$_.Location -eq "northeurope"} 
  
    $VMstopatch = @($AzVM).Id 
    # Create an Azure Automation variable (This cmdlet will not fail, but the variable may not work as intended when used in the runbook.) 
    New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $VMstopatch 
  
    # Convert the object to a JSON string 
    $jsonString = $VMstopatch | ConvertTo-Json 
  
    # Create an Azure Automation variable with a JSON string value (works effectively within the automation runbook) 
    New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $jsonString 
  

Batasan

• PowerShell 7.1 tidak lagi didukung oleh produk induk PowerShell. Kami menyarankan Anda untuk membuat runbook baru di PowerShell 7.2 untuk dukungan jangka panjang dan memperbarui runbook yang sudah usang.
• Cmdlet PowerShell internal Azure Automation tidak didukung pada Pekerja Runbook Hibrida Linux. Anda harus mengimpor modul automationassets di awal runbook PowerShell Anda untuk mengakses fungsi sumber daya (aset) bersama akun Automation.
• Untuk versi runtime PowerShell 7, aktivitas modul tidak diekstraksi untuk modul yang diimpor.
• Jenis parameter runbook PSCredential tidak didukung dalam versi runtime PowerShell 7.
• PowerShell 7.x tidak mendukung alur kerja. Untuk informasi selengkapnya, lihat Alur Kerja PowerShell untuk detail selengkapnya.
• PowerShell 7.x saat ini tidak mendukung runbook yang ditandatangani.
• Integrasi kontrol sumber tidak mendukung runbook PowerShell 7.1 (pratinjau) Selain itu, runbook PowerShell 7.1 (pratinjau) dalam kontrol sumber dibuat di akun Automation sebagai Runtime 5.1.
• Manajemen modul PowerShell 7.1 tidak didukung melalui cmdlet Get-AzAutomationModule.
• Runbook gagal tanpa jejak log jika nilai input berisi karakter '.
• Runbook Azure tidak mendukung Start-Job dengan -credential.
• Azure tidak mendukung semua parameter input PowerShell. Pelajari selengkapnya.

Masalah yang diketahui

• Runbook yang mengambil dependensi pada jalur file internal seperti C:\modules mungkin gagal karena perubahan infrastruktur backend layanan. Ubah kode runbook untuk memastikan tidak ada dependensi pada jalur file internal dan gunakan Get-ChildItem untuk mendapatkan informasi modul yang diperlukan.

  Contoh skrip

  
  # Get information about module "Microsoft.Graph.Authentication"
  $ModuleName = "Microsoft.Graph.Authentication"
  
  $NewPath = "C:\usr\src\PSModules\$ModuleName"
  $OldPath = "C:\Modules\User\$ModuleName"
  
  if (Test-Path -Path $NewPath -PathType Container) {
      Get-ChildItem -Path $NewPath
  } elseif (Test-Path -Path $OldPath -PathType Container) {
      Get-ChildItem -Path $OldPath
  } else {
      Write-Output "Module $ModuleName not present."
  }
  # Getting the path to the Temp folder, if needed.
  $tmp = $env:TEMP
  
  

• Get-AzStorageAccount cmdlet mungkin gagal dengan kesalahan: Perintah Get-AzStorageAccount ditemukan dalam modul Az.Storage, tetapi modul tidak dapat dimuat.

• Menjalankan skrip turunan menggunakan .\child-runbook.ps1 tidak didukung dalam pratinjau ini. Solusi sementara: Gunakan Start-AutomationRunbook (cmdlet internal) atau Start-AzAutomationRunbook (dari Az.Automation modul) untuk memulai runbook lain dari runbook induk.

• Properti runbook yang menentukan preferensi pengelogan tidak didukung di runtime PowerShell 7. Solusi sementara: Secara eksplisit mengatur preferensi di awal runbook sebagai berikut -

      $VerbosePreference = "Continue"
  
      $ProgressPreference = "Continue"
  

• Hindari mengimpor modul Az.Accounts ke versi 2.4.0 untuk runtime PowerShell 7 karena mungkin ada perilaku yang tidak diharapkan menggunakan versi ini di Azure Automation.

• Anda mungkin mengalami masalah pemformatan dengan aliran output kesalahan untuk pekerjaan yang berjalan di runtime PowerShell 7.

• Saat Anda mengimpor modul PowerShell 7.1 yang bergantung pada modul lain, Anda mungkin menemukan bahwa tombol impor berwarna abu-abu bahkan ketika versi PowerShell 7.1 dari modul dependen diinstal. Misalnya, modul Az PowerShell. Komputasi versi 4.20.0, memiliki dependensi pada Az.Accounts menjadi >= 2.6.0. Masalah ini terjadi ketika modul dependen yang setara di PowerShell 5.1 tidak memenuhi persyaratan versi. Misalnya, Az.Accounts versi 5.1 adalah < 2.6.0.

• Saat Anda memulai runbook PowerShell 7 menggunakan webhook, runbook tersebut secara otomatis mengonversi parameter input webhook menjadi JSON yang tidak valid.

• Kami menyarankan agar Anda menggunakan versi modul ExchangeOnlineManagement : 3.0.0 atau yang lebih rendah karena versi: 3.0.0 atau yang lebih tinggi dapat menyebabkan kegagalan pekerjaan.

• Jika Anda mengimpor modul Az.Accounts dengan versi 2.12.3 atau yang lebih baru, pastikan Anda mengimpor modul Newtonsoft.Json v10 secara eksplisit jika runbook PowerShell 7.1 memiliki dependensi pada versi modul ini. Solusi untuk masalah ini adalah menggunakan runbook PowerShell 7.2.

• Saat Anda menggunakan New-AzAutomationVariable cmdlet dalam Modul Az.Automation untuk mengunggah variabel objek jenis, operasi tidak berfungsi seperti yang diharapkan.

  Solusi sementara: Konversi objek ke string JSON menggunakan cmdlet ConvertTo-Json lalu unggah variabel dengan string JSON sebagai nilainya. Solusi ini memastikan penanganan variabel yang tepat dalam lingkungan Azure Automation sebagai string JSON.

  Contoh - Membuat objek PowerShell yang telah menyimpan informasi di sekitar Azure VM

    # Retrieve Azure virtual machines with status information for the 'northeurope' region 
    $AzVM = Get-AzVM -Status | Where-Object {$_.Location -eq "northeurope"} 
  
    $VMstopatch = @($AzVM).Id 
    # Create an Azure Automation variable (This cmdlet will not fail, but the variable may not work as intended when used in the runbook.) 
    New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $VMstopatch 
  
    # Convert the object to a JSON string 
    $jsonString = $VMstopatch | ConvertTo-Json 
  
    # Create an Azure Automation variable with a JSON string value (works effectively within the automation runbook) 
    New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $jsonString 
  

• Untuk modul Python 3.10 (pratinjau), saat ini, hanya file roda yang menargetkan OS Linux cp310 yang didukung. Pelajari lebih lanjut
• Integrasi kontrol sumber tidak didukung.
• Paket kustom untuk Python 3.10 (pratinjau) hanya divalidasi selama runtime kerja. Pekerjaan diharapkan gagal jika paket tidak kompatibel dalam runtime atau jika dependensi paket yang diperlukan tidak diimpor ke akun otomatisasi.
• Saat ini, runbook Python 3.10 (pratinjau) hanya didukung dari portal Azure. Rest API dan PowerShell tidak didukung.

• Anda pasti sudah tidak asing lagi dengan pembuatan skrip Python.
• Integrasi kontrol sumber tidak didukung.
• Untuk modul Python 3.8, gunakan file roda yang menargetkan cp38-amd64.
• Untuk menggunakan pustaka pihak ketiga, Anda harus mengimpor paket ke akun Automation.
• Menggunakan cmdlet Start-AutomationRunbook di PowerShell/PowerShell Workflow untuk memulai runbook Python 3.8 tidak berfungsi. Anda dapat menggunakan cmdlet Start-AzAutomationRunbook dari modul Az.Automation atau cmdlet Start-AzureRmAutomationRunbook dari modul AzureRm.Automation untuk mengatasi batasan ini. 
• Azure Automation tidak mendukung sys.stderr.
• Paket automationassets Python tidak tersedia di pypi.org, sehingga tidak tersedia untuk diimpor ke komputer Windows.

• Python 2.7 tidak lagi didukung oleh produk induk Python. Kami menyarankan Anda untuk membuat runbook baru dalam versi yang didukung dan memperbarui runbook yang kedaluarsa.
• Anda pasti sudah tidak asing lagi dengan pembuatan skrip Python.
• Untuk modul Python 2.7.12, gunakan file roda cp27-amd6.
• Untuk menggunakan pustaka pihak ketiga, Anda harus mengimpor paket ke akun Automation.
• Azure Automation tidak mendukung sys.stderr.
• Paket automationassets Python tidak tersedia di pypi.org, sehingga tidak tersedia untuk diimpor ke komputer Windows.