Gambaran umum modul Az.Tools.Migration PowerShell

Modul Az.Tools.Migration PowerShell memfasilitasi transisi dari modul AzureRM yang lebih lama ke modul Az yang lebih baru, yang direkomendasikan untuk manajemen Azure.

Penting

Modul AzureRM PowerShell tidak digunakan lagi per 29 Februari 2024.

Microsoft memperkenalkan Az.Tools.Migration sebagai respons terhadap umpan balik pelanggan, terutama mengenai upaya yang diperlukan untuk memperbarui skrip yang awalnya ditulis untuk AzureRM. Mengenali bahwa banyak pelanggan telah berinvestasi dalam membuat skrip kompleks untuk lingkungan Azure, Az.Tools.Migration dibuat untuk menyederhanakan dan mengotomatiskan proses migrasi, sehingga mengurangi beban kerja manual dan potensi kesalahan selama peningkatan skrip.

Cara menggunakan modul Az.Tools.Migration

Proses penggunaan Az.Tools.Migration melibatkan beberapa langkah:

1. Memperbarui ke AzureRM versi 6.13.1: Sebelum menggunakan Az.Tools.Migration, pengguna harus memastikan skrip mereka diperbarui ke AzureRM versi 6.13.1, versi terakhir sebelum migrasi ke modul Az .

2. Menginstal Az.Tools.Migration: Modul dapat diinstal dari Galeri PowerShell dengan Install-Module -Name Az.Tools.Migration perintah .

3. Membuat Paket Peningkatan:New-AzUpgradeModulePlan Cmdlet menghasilkan rencana peningkatan. Ini tidak mengubah skrip yang ada tetapi menyediakan jalur peningkatan dengan membuat rencana yang merinci file tertentu dan titik offset yang memerlukan pembaruan. Cmdlet ini mengambil parameter seperti FilePath dan DirectoryPath untuk menargetkan skrip atau folder tertentu.

4. Meninjau Paket Peningkatan: Sebelum menjalankan peningkatan, sangat penting untuk meninjau rencana untuk setiap masalah potensial yang dapat mencegah peningkatan otomatis, seperti perintah yang menggunakan splatting, dan memperbaikinya secara manual jika perlu.

5. Melakukan Peningkatan: Setelah meninjau dan menyelesaikan masalah apa pun, peningkatan aktual dilakukan menggunakan Invoke-AzUpgradeModulePlan cmdlet. Cmdlet ini dapat memodifikasi file yang ada atau, lebih aman, menyimpan perubahan ke file baru dengan _az_upgraded ditambahkan ke namanya untuk mempertahankan skrip asli.

Untuk memastikan migrasi yang lancar, disarankan untuk mencadangkan skrip sebelum melakukan peningkatan karena cmdlet Invoke-AzUpgradeModulePlan dapat merusak jika opsi -FileEditMode SaveChangesToNewFiles tidak digunakan.

Pengguna didorong untuk memberikan umpan balik atau melaporkan masalah dengan proses migrasi pada repositori GitHub untuk azure-powershell-migration.