Gambaran umum Azure Windows VM Agent

Microsoft Azure Windows VM Agent adalah proses yang aman dan ringan yang mengelola interaksi komputer virtual (VM) dengan pengontrol fabric Azure. Azure Windows VM Agent memiliki peran utama dalam mengaktifkan dan menjalankan ekstensi komputer virtual Azure. Ekstensi mesin virtual memungkinkan konfigurasi mesin virtual pasca penyebaran, seperti menginstal dan mengonfigurasi perangkat lunak. Ekstensi VM juga mengaktifkan fitur pemulihan seperti mengatur ulang kata sandi administratif VM. Tanpa Azure Windows VM Agent, Anda tidak dapat menjalankan ekstensi VM.

Artikel ini menjelaskan cara menginstal dan mendeteksi Azure Windows VM Agent.

Catatan

Coba bantuan VM untuk diagnostik yang lebih cepat. Kami menyarankan agar Anda menjalankan VM assist untuk Windows atau VM assist untuk Linux. Alat diagnostik berbasis skrip ini membantu Anda mengidentifikasi masalah umum yang memengaruhi Agen Tamu Azure VM dan kesehatan VM secara keseluruhan.

Jika Anda mengalami masalah performa dengan komputer virtual, sebelum menghubungi dukungan, jalankan alat-alat ini.

Prasyarat

Azure Windows VM Agent mendukung arsitektur x64 dan ARM64 untuk sistem operasi Windows ini:

Versi OS x64 ARM64
Windows 10 Didukung Tidak didukung
Windows 11 Didukung Didukung
Server Windows 2016 Didukung Tidak didukung
Windows Server 2016 Core Didukung Tidak didukung
Windows Server 2019 Didukung Tidak didukung
Windows Server 2019 Core Didukung Tidak didukung
Windows Server 2022 Didukung Tidak didukung
Windows Server 2022 Core Didukung Tidak didukung
Windows Server 2025 Didukung Tidak didukung
Windows Server 2025 Core Didukung Tidak didukung

Penting

  • Azure Windows VM Agent memerlukan setidaknya Windows Server 2016 (64-bit) untuk dijalankan, dengan .NET Framework 4.0. Lihat Dukungan versi minimum untuk agen komputer virtual di Azure.

  • Pastikan VM Anda memiliki akses ke alamat IP 168.63.129.16. Untuk informasi selengkapnya, lihat Apa itu alamat IP 168.63.129.16?.

  • Jika Anda hanya memiliki satu IP privat di NIC VM Anda, kami sangat menyarankan agar DHCP diaktifkan di VM tamu. Jika Anda memerlukan alamat IP privat statis, Anda harus mengonfigurasinya melalui portal Azure atau PowerShell, dan memastikan opsi DHCP di dalam VM diaktifkan. Pelajari selengkapnya tentang menyiapkan alamat IP statis dengan menggunakan PowerShell. Ini akan memastikan bahwa konfigurasi IP akan selalu cocok dengan apa yang dikonfigurasi pada VM di Azure.

  • Jika Anda memiliki beberapa IP privat yang ditetapkan ke NIC VM Anda, pastikan Anda dengan hati-hati mengikuti langkah-langkah untuk menetapkan konfigurasi IP dengan benar. Setelah ini, jika Agen Tamu tidak dapat berkomunikasi dengan 168.63.129.16, periksa apakah IP utama di Windows cocok dengan IP utama di NIC VM Anda di Azure.

  • Menjalankan Azure Windows VM Agent dalam VM virtualisasi berlapis dapat menyebabkan perilaku yang tidak dapat diprediksi, sehingga tidak didukung dalam skenario dev/test tersebut.

Menginstal Agen Azure Windows VM

Gambar Azure Marketplace

Azure Windows VM Agent diinstal secara otomatis pada VM Windows apa pun yang disediakan dari citra Marketplace Azure. Saat Anda menyebarkan gambar Marketplace Azure dari portal Azure, PowerShell, Azure CLI, atau templat Azure Resource Manager, Azure Windows VM Agent juga diinstal.

Paket Agen Azure Windows VM memiliki dua bagian:

  • Agen Penyediaan Windows Azure (PA)
  • Agen Tamu Azure Windows (WinGA)

Untuk mem-boot VM, Anda harus menginstal PA pada VM. Namun, WinGA tidak perlu diinstal. Pada waktu penyebaran VM, Anda dapat memilih untuk tidak memasang WinGA. Contoh berikut menunjukkan cara memilih provisionVmAgent opsi dengan templat Azure Resource Manager:

{
	"resources": [{
		"name": ["parameters('virtualMachineName')"],
		"type": "Microsoft.Compute/virtualMachines",
		"apiVersion": "2016-04-30-preview",
		"location": ["parameters('location')"],
		"dependsOn": ["[concat('Microsoft.Network/networkInterfaces/', parameters('networkInterfaceName'))]"],
		"properties": {
			"osProfile": {
				"computerName": ["parameters('virtualMachineName')"],
				"adminUsername": ["parameters('adminUsername')"],
				"adminPassword": ["parameters('adminPassword')"],
				"windowsConfiguration": {
					"provisionVmAgent": "false"
				}
			}
		}
	}]
}

Jika Anda tidak memiliki agen yang terinstal, Anda tidak dapat menggunakan beberapa layanan Azure, seperti Azure Backup atau Azure Security. Layanan-layanan tersebut memerlukan ekstensi untuk diinstal. Jika Anda menjalankan VM tanpa WinGA, Anda dapat menginstal versi terbaru agen kemudian.

Penginstalan manual

Untuk menginstal Azure Windows VM Agent secara manual, unduh alat penginstal dan pilih rilis terbaru. Anda juga dapat mencari versi tertentu di halaman GitHub untuk rilis Azure Windows VM Agent. Azure Windows VM Agent didukung pada Windows Server 2016 (64 bit) dan yang lebih baru.

Catatan

  • Jika VM dibuat dari gambar kustom atau Marketplace tanpa ProvisionVMAgent diaktifkan, penting untuk memperbarui AllowExtensionOperations ke true setelah Anda menginstal Azure Windows VM Agent secara manual.
  • Ini TIDAK diperlukan jika VM dibuat dari disk khusus. Misalnya, jika VM dibuat langsung dari disk yang ada.
$vm = Get-AzVM -Name <VM Name> -ResourceGroupName <Resource Group Name>
$vm.OSProfile.AllowExtensionOperations = $true
$vm | Update-AzVM

Mendeteksi Agen Azure Windows VM

PowerShell

Anda dapat menggunakan modul Azure Resource Manager PowerShell untuk mendapatkan informasi tentang Azure VM. Untuk melihat informasi tentang VM, seperti status provisi untuk Azure Windows VM Agent, gunakan Get-AzVM:

Get-AzVM

Contoh output ringkas berikut menunjukkan properti yang ProvisionVMAgent bersarang di dalam OSProfile. Anda dapat menggunakan properti ini untuk menentukan apakah agen VM telah disebarkan ke VM.

OSProfile                  :
  ComputerName             : myVM
  AdminUsername            : myUserName
  WindowsConfiguration     :
    ProvisionVMAgent       : True
    EnableAutomaticUpdates : True

Gunakan skrip berikut untuk mengembalikan daftar ringkas nama VM (menjalankan OS Windows) dan status Agen Azure Windows VM:

$vms = Get-AzVM

foreach ($vm in $vms) {
    $agent = $vm | Select -ExpandProperty OSProfile | Select -ExpandProperty Windowsconfiguration | Select ProvisionVMAgent
    Write-Host $vm.Name $agent.ProvisionVMAgent
}

Gunakan skrip berikut untuk mengembalikan daftar ringkas nama VM (menjalankan OS Linux) dan status Agen VM Azure Windows:

$vms = Get-AzVM

foreach ($vm in $vms) {
    $agent = $vm | Select -ExpandProperty OSProfile | Select -ExpandProperty Linuxconfiguration | Select ProvisionVMAgent
    Write-Host $vm.Name $agent.ProvisionVMAgent
}

Deteksi manual

Saat Anda masuk ke VM Windows, Anda dapat menggunakan Task Manager untuk memeriksa proses yang sedang berjalan. Untuk memeriksa Agen VM Azure Windows, buka Task Manager, pilih tab Detail , dan cari proses bernama WindowsAzureGuestAgent.exe. Kehadiran proses ini menunjukkan bahwa agen VM telah dipasang.

Tingkatkan Agen VM Windows Azure

Agen VM Windows Azure untuk Windows di-upgrade secara otomatis pada citra yang diluncurkan dari Marketplace Azure. Versi baru disimpan di Azure Storage, jadi pastikan Anda tidak memiliki firewall yang memblokir akses. Saat VM baru diterapkan ke Azure, mereka menerima agen VM terbaru pada waktu penyediaan VM. Jika Anda menginstal agen secara manual atau menyebarkan gambar VM kustom, Anda perlu memperbarui secara manual untuk menyertakan agen VM baru pada waktu pembuatan gambar.

Pengumpulan log otomatis oleh Agen Tamu Azure Windows

Agen Tamu Windows Azure memiliki fitur untuk mengumpulkan beberapa log secara otomatis. Proses CollectGuestLogs.exe mengontrol fitur ini. Ini tersedia untuk layanan cloud platform sebagai layanan (PaaS) dan mesin virtual (VM) infrastruktur sebagai layanan (IaaS). Tujuannya adalah untuk mengumpulkan log diagnostik dengan cepat dan otomatis dari VM, sehingga dapat digunakan untuk analisis offline.

Log yang dikumpulkan adalah log peristiwa, log OS, log Azure, dan beberapa kunci registri. Agen menghasilkan file ZIP yang ditransfer ke host VM. Tim teknik dan profesional dukungan kemudian dapat menggunakan file ZIP ini untuk menyelidiki masalah atas permintaan pelanggan yang memiliki VM.

Sertifikat Azure Windows Guest Agent dan OSProfile

Azure Windows VM Agent memasang sertifikat yang dirujuk dalam nilai OSProfile dari sebuah VM atau set skala mesin virtual. Jika Anda menghapus sertifikat ini secara manual dari snap-in Sertifikat Microsoft Management Console (MMC) di dalam VM tamu, Agen Tamu Azure Windows akan menambahkannya kembali. Untuk menghapus sertifikat secara permanen, Anda harus menghapusnya dari OSProfile, lalu menghapusnya dari dalam sistem operasi tamu.

Untuk komputer virtual, gunakan Remove-AzVMSecret untuk menghapus sertifikat dari OSProfile.

Untuk informasi selengkapnya tentang sertifikat untuk set skala komputer virtual, lihat Azure Virtual Machine Scale Sets - Bagaimana cara menghapus sertifikat yang tidak digunakan lagi?.

Langkah berikutnya

Untuk informasi selengkapnya tentang ekstensi Mesin Virtual, lihat Ekstensi dan fitur mesin virtual Azure.

  • Last updated on