Bagikan melalui

Mengaktifkan ekstensi Azure VM dengan menggunakan Azure CLI

  • Artikel

Artikel ini menjelaskan cara menyebarkan, meningkatkan, memperbarui, dan menghapus instalan ekstensi komputer virtual (VM) yang didukung oleh server berkemampuan Azure Arc. Ini menunjukkan kepada Anda cara melakukan tugas-tugas ini pada komputer hibrid Linux atau Windows dengan menggunakan Azure CLI.

Catatan

Server dengan dukungan Azure Arc tidak mendukung penyebaran dan pengelolaan ekstensi VM ke komputer virtual Azure. Untuk Azure VM, lihat artikel gambaran umum ekstensi VM.

Prasyarat

Memasang ekstensi Azure CLI

Perintah ConnectedMachine tidak dikirimkan sebagai bagian dari Azure CLI. Sebelum Anda menggunakan Azure CLI untuk menyambungkan ke Azure dan mengelola ekstensi VM di server hibrid yang dikelola oleh server berkemampuan Azure Arc, Anda perlu memuat ekstensi ConnectedMachine.

Anda dapat melakukan operasi manajemen ini dari stasiun kerja Anda. Anda tidak perlu menjalankannya di server dengan dukungan Azure Arc.

Jalankan perintah berikut untuk menginstal ekstensi Azure CLI ConnectedMachine:

az extension add --name connectedmachine

Mengaktifkan ekstensi

Untuk mengaktifkan ekstensi VM di server yang didukung Azure Arc Anda, gunakan az connectedmachine extension create dengan parameter , , --extension-name, --type--location, settings, dan --publisher --machine-name.

Contoh berikut mengaktifkan Ekstensi Skrip Kustom pada server Azure Arc yang diaktifkan:

az connectedmachine extension create --machine-name "myMachineName" --name "CustomScriptExtension" --location "regionName" --type "CustomScriptExtension" --publisher "Microsoft.Compute" --settings "{\"commandToExecute\":\"powershell.exe -c \\\"Get-Process | Where-Object { $_.CPU -gt 10000 }\\\"\"}" --type-handler-version "1.10" --resource-group "myResourceGroup"

Contoh berikut mengaktifkan ekstensi VM Azure Key Vault di server dengan dukungan Azure Arc:

az connectedmachine extension create --resource-group "resourceGroupName" --machine-name "myMachineName" --location "regionName" --publisher "Microsoft.Azure.KeyVault" --type "KeyVaultForLinux or KeyVaultForWindows" --name "KeyVaultForLinux or KeyVaultForWindows" --settings '{"secretsManagementSettings": { "pollingIntervalInS": "60", "observedCertificates": ["observedCert1"] }, "authenticationSettings": { "msiEndpoint": "http://localhost:40342/metadata/identity" }}'

Contoh berikut mengaktifkan ekstensi Microsoft Antimalware di server Windows yang didukung Azure Arc:

az connectedmachine extension create --resource-group "resourceGroupName" --machine-name "myMachineName" --location "regionName" --publisher "Microsoft.Azure.Security" --type "IaaSAntimalware" --name "IaaSAntimalware" --settings '"{\"AntimalwareEnabled\": \"true\"}"'

Contoh berikut mengaktifkan ekstensi Datadog di server Windows dengan dukungan Azure Arc:

az connectedmachine extension create --resource-group "resourceGroupName" --machine-name "myMachineName" --location "regionName" --publisher "Datadog.Agent" --type "DatadogWindowsAgent" --settings '{"site": "us3.datadoghq.com"}' --protected-settings '{"api_key": "YourDatadogAPIKey" }'

Buat daftar ekstensi yang dipasang

Untuk mendapatkan daftar ekstensi VM di server berkemampuan Azure Arc Anda, gunakan az connectedmachine extension list dengan --machine-name parameter dan --resource-group .

Berikut contohnya:

az connectedmachine extension list --machine-name "myMachineName" --resource-group "myResourceGroup"

Secara default, output dari perintah Azure CLI ada di JavaScript Object Notation (JSON). Untuk mengubah output default ke daftar atau tabel, misalnya, gunakan az config set core.output=table. Anda juga dapat menambahkan --output ke perintah apa pun untuk perubahan satu kali dalam format output.

Contoh berikut menunjukkan sebagian output JSON dari perintah az connectedmachine extension -list:

[
  {
    "autoUpgradingMinorVersion": "false",
    "forceUpdateTag": null,
    "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.HybridCompute/machines/SVR01/extensions/DependencyAgentWindows",
    "location": "regionName",
    "name": "DependencyAgentWindows",
    "namePropertiesInstanceViewName": "DependencyAgentWindows",

Memperbarui konfigurasi ekstensi

Beberapa ekstensi VM memerlukan pengaturan konfigurasi sehingga Anda dapat menginstalnya di server yang diaktifkan Azure Arc (seperti Ekstensi Skrip Kustom). Untuk meningkatkan konfigurasi ekstensi, gunakan az connectedmachine extension update.

Contoh berikut menunjukkan cara mengonfigurasi Ekstensi Skrip Kustom:

az connectedmachine extension update --name "CustomScriptExtension" --type "CustomScriptExtension" --publisher "Microsoft.HybridCompute" --settings "{\"commandToExecute\":\"powershell.exe -c \\\"Get-Process | Where-Object { $_.CPU -lt 100 }\\\"\"}" --type-handler-version "1.10" --machine-name "myMachine" --resource-group "myResourceGroup"

Memutakhirkan ekstensi

Saat versi baru dari ekstensi mesin virtual yang didukung dirilis, Anda dapat meningkatkannya ke rilis terbaru tersebut. Untuk meningkatkan ekstensi VM, gunakan az connectedmachine upgrade-extension dengan --machine-nameparameter , , --resource-groupdan --extension-targets .

Untuk parameter --extension-targets, Anda perlu menentukan ekstensi dan versi terbaru yang tersedia. Untuk menentukan versi terbaru yang tersedia untuk ekstensi, buka halaman Ekstensi untuk server berkemampuan Azure Arc yang dipilih di portal Azure atau jalankan az vm extension image list. Anda dapat menentukan beberapa ekstensi dalam satu permintaan peningkatan dengan menyediakan keduanya:

  • Daftar ekstensi yang dipisahkan koma, yang ditentukan oleh penerbit dan jenisnya (dipisahkan oleh titik)
  • Versi target untuk setiap ekstensi

Anda dapat meninjau versi ekstensi VM yang diinstal kapan saja dengan menjalankan perintah az connectedmachine extension list. Nilai properti typeHandlerVersion mewakili versi ekstensi.

Menghapus ekstensi

Untuk menghapus ekstensi VM yang diinstal dari server yang didukung Azure Arc Anda, gunakan az connectedmachine extension delete dengan --extension-nameparameter , , --machine-namedan --resource-group .

Konten terkait