Bagikan melalui

Memecahkan masalah Konfigurasi Status Azure Automation

  • Artikel

Catatan

Konfigurasi Status Azure Automation akan dihentikan pada 30 September 2027, silakan transisi ke Konfigurasi Komputer Azure pada tanggal tersebut. Untuk informasi selengkapnya, lihat pengumuman posting blog. Layanan Azure Machine Configuration menggabungkan fitur Ekstensi DSC, Konfigurasi Status Azure Automation, dan fitur yang paling umum diminta dari umpan balik pelanggan. Azure Machine Configuration juga menyertakan dukungan komputer hibrid melalui server yang didukung Arc.

Artikel ini menyediakan informasi tentang pemecahan masalah dan penyelesaian masalah yang terjadi saat Anda mengompilasi atau menyebarkan konfigurasi di Konfigurasi Status Azure Automation. Untuk informasi umum tentang fitur Konfigurasi Status, lihat Gambaran umum Konfigurasi Status Azure Automation.

Mendiagnosis masalah

Saat Anda menerima kesalahan kompilasi atau penyebaran untuk konfigurasi, berikut adalah beberapa langkah untuk membantu Anda mendiagnosis masalah tersebut.

1. Pastikan konfigurasi Anda berhasil dikompilasi pada komputer lokal

Konfigurasi Status Azure Automation dibuat di Konfigurasi Status yang Diinginkan (DSC) PowerShell. Anda dapat menemukan dokumentasi untuk bahasa dan sintaks DSC di PowerShell DSC Docs.

Dengan mengompilasi konfigurasi DSC pada komputer lokal, Anda dapat menemukan dan mengatasi kesalahan umum, seperti:

  • Modul yang hilang.
  • Kesalahan sintaks.
  • Kesalahan logika.

2. Lihat log DSC pada node Anda

Jika konfigurasi Anda berhasil dikompilasi, tetapi gagal saat diterapkan ke node, Anda dapat menemukan informasi terperinci dalam log DSC. Untuk informasi tentang tempat menemukan log ini, lihat Di mana Log Kejadian DSC.

Modul xDscDiagnostics dapat membantu Anda dalam mengurai informasi terperinci dari log DSC. Jika Anda menghubungi dukungan, mereka memerlukan log ini untuk mendiagnosis masalah Anda.

Anda dapat menginstal modul xDscDiagnostics pada komputer lokal Anda dengan mengikuti instruksi di Menginstal modul versi stabil.

Untuk menginstal modul xDscDiagnostics di mesin Azure Anda, gunakan Invoke-AzVMRunCommand. Anda juga bisa menggunakan opsi Jalankan perintah di portal Azure dengan mengikuti langkah-langkah dalam Menjalankan skrip PowerShell di Windows VM Anda dengan Jalankan Perintah.

Untuk informasi tentang menggunakan xDscDiagnostics, lihat Menggunakan xDscDiagnostics untuk menganalisis log DSC. Lihat juga xDscDiagnostics Cmdlets.

3. Pastikan bahwa simpul dan ruang kerja Automation telah memerlukan modul

DSC bergantung pada modul yang diinstal pada node. Saat Anda menggunakan Konfigurasi Status Azure Automation, impor modul yang diperlukan ke akun Otomatisasi Anda dengan mengikuti langkah-langkah dalam Mengimpor Modul. Konfigurasi juga dapat memiliki dependensi pada versi modul tertentu. Untuk informasi selengkapnya, lihat Memecahkan masalah modul.

Skenario: Konfigurasi dengan karakter khusus tidak dapat dihapus dari portal

Masalah

Saat Anda mencoba menghapus konfigurasi DSC dari portal, Anda akan melihat kesalahan berikut:

An error occurred while deleting the DSC configuration '<name>'. Error-details: The argument
configurationName with the value <name> is not valid. Valid configuration names can contain only
letters, numbers, and underscores. The name must start with a letter. The length of the name must be
between 1 and 64 characters.

Penyebab

Kesalahan ini adalah masalah sementara. Coba lagi nanti.

Resolusi

Gunakan cmdlet Remove-AzAutomationDscConfiguration untuk menghapus konfigurasi.

Skenario: Gagal mendaftarkan Agen DSC

Masalah

Anda menerima kesalahan saat menggunakan Set-DscLocalConfigurationManager atau cmdlet DSC lainnya.

Registration of the Dsc Agent with the server
https://<location>-agentservice-prod-1.azure-automation.net/accounts/00000000-0000-0000-0000-000000000000
failed. The underlying error is: Failed to register Dsc Agent with AgentId
00000000-0000-0000-0000-000000000000 with the server
https://<location>-agentservice-prod-1.azure-automation.net/accounts/00000000-0000-0000-0000-000000000000/Nodes(AgentId='00000000-0000-0000-0000-000000000000').
    + CategoryInfo          : InvalidResult: (root/Microsoft/...gurationManager:String) [], CimException
    + FullyQualifiedErrorId : RegisterDscAgentCommandFailed,Microsoft.PowerShell.DesiredStateConfiguration.Commands.RegisterDscAgentCommand
    + PSComputerName        : <computerName>

Penyebab

Masalah jaringan dapat menyebabkan kesalahan ini. Periksa pengaturan firewall Anda atau apakah komputer berada di belakang server proksi.

Resolusi

Pastikan mesin Anda memiliki akses ke titik akhir yang tepat untuk DSC, lalu coba lagi. Untuk daftar port dan alamat yang diperlukan, lihat Perencanaan jaringan.

Skenario: Laporan status mengembalikan kode respons Tidak Sah

Masalah

Saat Anda mendaftarkan node dengan Konfigurasi Status Azure Automation, Anda menerima salah satu pesan kesalahan berikut:

The attempt to send status report to the server https://{your Automation account
URL}/accounts/xxxxxxxxxxxxxxxxxxxxxx/Nodes(AgentId='xxxxxxxxxxxxxxxxxxxxxxxxx')/SendReport returned
unexpected response code Unauthorized.

VM has reported a failure when processing extension 'Microsoft.Powershell.DSC / Registration of the
Dsc Agent with the server failed.

Penyebab

Berikut ini adalah kemungkinan penyebabnya:

  • Sertifikat yang buruk atau kedaluwarsa. Lihat Mendaftarkan ulang node.

  • Konfigurasi proksi yang tidak mengizinkan akses ke *.azure-automation.net. Untuk informasi selengkapnya, lihat Konfigurasi jaringan privat.

  • Saat Anda menonaktifkan autentikasi lokal di Azure Automation. Lihat Menonaktifkan autentikasi lokal. Untuk memperbaikinya, lihat Mengaktifkan kembali autentikasi lokal.

  • Waktu komputer klien berkisar menit tidak akurat dari waktu aktual. Gunakan perintah berikut untuk memeriksa waktu: w32tm /stripchart /computer:time.windows.com /samples:6.

Resolusi

Gunakan langkah-langkah berikut untuk mendaftarkan kembali node DSC yang gagal.

Langkah 1: Batalkan pendaftaran node

  1. Di portal Azure, buka >Home Automation Accounts> (akun Automation Anda) >Konfigurasi status (DSC).
  2. Pilih Node, dan pilih node yang mengalami masalah.
  3. Pilih Batalkan pendaftaran untuk membatalkan pendaftaran node.

Langkah 2: Hapus instalasi ekstensi DSC dari node

  1. Di portal Azure, buka Ekstensi Home>Virtual Machine> (node gagal). >
  2. Pilih Microsoft.Powershell.DSC, ekstensi DSC PowerShell.
  3. Pilih Hapus instalasi untuk menghapus instalasi ekstensi.

Langkah 3: Hapus semua sertifikat yang buruk atau kedaluwarsa dari node

Pada node yang gagal dari prompt PowerShell yang ditinggikan, jalankan perintah ini:

$certs = @()
$certs += dir cert:\localmachine\my | ?{$_.FriendlyName -like "DSC"}
$certs += dir cert:\localmachine\my | ?{$_.FriendlyName -like "DSC-OaaS Client Authentication"}
$certs += dir cert:\localmachine\CA | ?{$_.subject -like "CN=AzureDSCExtension*"}
"";"== DSC Certificates found: " + $certs.Count
$certs | FL ThumbPrint,FriendlyName,Subject
If (($certs.Count) -gt 0)
{
    ForEach ($Cert in $certs)
    {
        RD -LiteralPath ($Cert.Pspath)
    }
}

Langkah 4: Daftarkan ulang node yang gagal

  1. Di portal Azure, buka >Home Automation Accounts> (akun Automation Anda) >Konfigurasi status (DSC).
  2. Pilih Node.
  3. Pilih Tambahkan.
  4. Pilih node yang gagal.
  5. Pilih Sambungkan, dan pilih opsi yang Anda inginkan.

Skenario: Node dalam status gagal dengan kesalahan "Tidak ditemukan"

Masalah

Node memiliki laporan dengan status Gagal dan berisi kesalahan:

The attempt to get the action from server
https://<url>//accounts/<account-id>/Nodes(AgentId=<agent-id>)/GetDscAction failed because a valid
configuration <guid> cannot be found.

Penyebab

Kesalahan ini biasanya terjadi ketika node ditetapkan ke nama konfigurasi, misalnya, ABC, bukan nama konfigurasi node (file MOF), misalnya, ABC.WebServer.

Resolusi

  • Pastikan Anda menetapkan node dengan nama konfigurasi node dan bukan nama konfigurasi.
  • Anda dapat menetapkan konfigurasi node ke node dengan menggunakan portal Azure atau dengan cmdlet PowerShell.
    • Di portal Azure, buka >Home Automation Accounts> (akun Automation Anda) >Konfigurasi status (DSC). Kemudian pilih node dan pilih Tetapkan konfigurasi node.
    • Gunakan cmdlet Set-AzAutomationDscNode.

Skenario: Tidak ada konfigurasi node (file MOF) yang dibuat saat konfigurasi dikompilasi

Masalah

Pekerjaan kompilasi DSC Anda menangguhkan kesalahan:

Compilation completed successfully, but no node configuration **.mof** files were generated.

Penyebab

Ketika ekspresi yang mengikuti kata kunci Node dalam konfigurasi DSC mengevaluasi ke $null, tidak ada konfigurasi node yang dihasilkan.

Resolusi

Gunakan salah satu solusi berikut untuk memperbaiki masalah:

  • Pastikan bahwa ekspresi di samping kata kunci Node dalam definisi konfigurasi tidak mengevaluasi ke Null.
  • Jika Anda melewati ConfigurationData saat mengompilasi konfigurasi, pastikan Anda meneruskan nilai yang diharapkan konfigurasi dari data konfigurasi.

Skenario: Laporan node DSC menjadi terjebak dalam status Sedang Berlangsung

Masalah

Output agen DSC:

No instance found with given property values

Penyebab

Masalah ini dapat terjadi jika Instrumentasi Manajemen Windows (WMI) rusak pada simpul.

Resolusi

Ikuti instruksi dalam Masalah umum dan batasan DSC.

Skenario: Tidak dapat menggunakan kredensial dalam konfigurasi DSC

Masalah

Pekerjaan kompilasi DSC Anda ditangguhkan dengan kesalahan:

System.InvalidOperationException error processing property 'Credential' of type <some resource
name>: Converting and storing an encrypted password as plaintext is allowed only if
PSDscAllowPlainTextPassword is set to true.

Penyebab

Masalah ini dapat terjadi ketika Anda menggunakan kredensial dalam konfigurasi tetapi tidak menyediakan yang tepat ConfigurationData untuk diatur PSDscAllowPlainTextPassword ke true untuk setiap konfigurasi simpul.

Resolusi

Pastikan untuk meneruskan pengaturan PSDscAllowPlainTextPassword , yang tepat ConfigurationDatake true untuk setiap konfigurasi node. Lihat Mengompilasi konfigurasi DSC di Konfigurasi Status Azure Automation.

Skenario: Kesalahan "Ekstensi pemrosesan kegagalan" saat mengaktifkan mesin dari ekstensi DSC

Masalah

Saat Anda mengaktifkan mesin dengan menggunakan ekstensi DSC, terjadi kegagalan yang berisi kesalahan:

VM has reported a failure when processing extension 'Microsoft.Powershell.DSC'. Error message: \"DSC
COnfiguration 'RegistrationMetaConfigV2' completed with error(s). Following are the first few:
Registration of the Dsc Agent with the server <url> failed. The underlying error is: The attempt to
register Dsc Agent with Agent Id <ID> with the server <url> return unexpected response code
BadRequest. .\".

Penyebab

Kesalahan ini biasanya terjadi bila node diberi nama konfigurasi node yang tidak ada di layanan.

Resolusi

Pastikan bahwa nama node yang sama persis dengan nama dalam layanan, atau jangan sertakan nama konfigurasi node. Ini memungkinkan simpul tetapi tidak menetapkan konfigurasi simpul.

Skenario: Kesalahan "Satu atau beberapa kesalahan terjadi" saat mendaftarkan node dengan menggunakan PowerShell

Masalah

Saat Anda mendaftarkan node dengan menggunakan Register-AzAutomationDSCNode atau Register-AzureRMAutomationDSCNode, Anda menerima kesalahan berikut:

One or more errors occurred.

Penyebab

Kesalahan ini terjadi ketika Anda mencoba mendaftarkan simpul dalam langganan yang berbeda dari yang digunakan oleh akun Automation.

Resolusi

Perlakukan simpul lintas langganan sebagai simpul yang ditentukan untuk cloud atau lokal terpisah. Daftarkan node dengan menggunakan salah satu opsi ini untuk mengaktifkan mesin:

Skenario: Pesan kesalahan "Penyediaan telah gagal"

Masalah

Saat Anda mendaftarkan node, Anda akan melihat kesalahan:

Provisioning has failed

Penyebab

Pesan ini terjadi saat ada masalah dengan konektivitas antara node dan Azure.

Resolusi

Tentukan apakah node Anda berada dalam jaringan privat virtual (VPN) atau memiliki masalah lain saat terhubung dengan Azure. Lihat Memecahkan masalah penyebaran fitur.

Skenario: Kegagalan dengan kesalahan umum saat menerapkan konfigurasi di Linux

Masalah

Saat Anda menerapkan konfigurasi di Linux, terjadi kegagalan yang berisi kesalahan:

This event indicates that failure happens when LCM is processing the configuration. ErrorId is 1.
ErrorDetail is The SendConfigurationApply function did not succeed.. ResourceId is [resource]name
and SourceInfo is ::nnn::n::resource. ErrorMessage is A general error occurred, not covered by a
more specific error code..

Penyebab

Jika lokasi /tmp diatur ke noexec, versi DSC saat ini gagal menerapkan konfigurasi.

Resolusi

Hapus opsi noexec dari lokasi /tmp.

Skenario: Nama konfigurasi node yang tumpang tindih dapat mengakibatkan rilis yang buruk

Masalah

Saat Anda menggunakan skrip konfigurasi tunggal untuk menghasilkan beberapa konfigurasi node dan beberapa nama konfigurasi node adalah subset dari nama lain, layanan kompilasi akhirnya akan menetapkan konfigurasi yang salah. Masalah ini hanya terjadi bila Anda menggunakan satu skrip untuk menghasilkan konfigurasi dengan data konfigurasi per node, dan hanya ketika terjadi tumpang tindih nama di awal string. Contohnya adalah skrip konfigurasi tunggal yang digunakan untuk menghasilkan konfigurasi berdasarkan data node yang diteruskan sebagai hashtable menggunakan cmdlet, dan data node menyertakan server bernama server dan 1server.

Penyebab

Ini adalah masalah yang diketahui dengan layanan kompilasi.

Resolusi

Solusi terbaik adalah mengompilasi secara lokal atau dalam pipeline CI/CD dan mengunggah file MOF konfigurasi node langsung ke layanan. Jika kompilasi dalam layanan adalah sebuah persyaratan, solusi terbaik berikutnya adalah membagi pekerjaan kompilasi sehingga tidak ada tumpang tindih nama.

Skenario: Kesalahan batas waktu gateway pada unggahan konfigurasi DSC

Masalah

Anda menerima kesalahan GatewayTimeout saat mengunggah konfigurasi DSC.

Penyebab

Konfigurasi DSC yang membutuhkan waktu lama untuk dikompilasi dapat menyebabkan kesalahan ini.

Resolusi

Anda dapat membuat konfigurasi DSC diurai lebih cepat dengan secara eksplisit menyertakan parameter ModuleName untuk setiap panggilan Import-DSCResource.

Skenario: Kesalahan saat onboarding komputer

Masalah

Anda menerima agent has a problem kesalahan saat anda onboarding mesin.

Penyebab

Ini adalah masalah yang sudah diketahui. Anda tidak dapat menetapkan konfigurasi yang sama lagi karena simpul tetap dalam status tertunda.

Resolusi

Untuk mengatasi masalah ini, terapkan konfigurasi pengujian yang berbeda dan coba konfigurasi asli lagi.

Langkah berikutnya

Jika Anda tidak melihat masalah di sini atau tidak dapat mengatasi masalah Anda, coba salah satu saluran dukungan berikut:

  • Dapatkan jawaban dari para ahli Azure melalui Forum Internet Azure.
  • Sambungkan dengan @AzureSupport, akun resmi Microsoft Azure untuk meningkatkan pengalaman pelanggan. Dukungan Azure menghubungkan komunitas Azure dengan jawaban, dukungan, dan para ahli.
  • Ajukan insiden dukungan Azure. Buka situs web dukungan Azure, lalu pilih Dapatkan Dukungan.