Bagikan melalui


Memigrasikan Azure PowerShell dari AzureRM ke Az

Peringatan

Modul AzureRM PowerShell telah resmi tidak digunakan lagi per 29 Februari 2024. Pengguna disarankan untuk bermigrasi dari AzureRM ke modul Az PowerShell untuk memastikan dukungan dan pembaruan yang berkelanjutan.

Meskipun modul AzureRM mungkin masih berfungsi, modul tersebut tidak lagi dipertahankan atau didukung, menempatkan penggunaan berkelanjutan berdasarkan kebijaksanaan dan risiko pengguna. Lihat sumber daya migrasi kami untuk panduan tentang transisi ke modul Az.

Menentukan apakah Anda menggunakan modul AzureRM PowerShell

Gunakan perintah berikut untuk menentukan apakah Anda memiliki modul AzureRM PowerShell yang terinstal:

Get-Module -Name AzureRM -ListAvailable

Anda juga dapat melakukan pencarian teks lengkap skrip Anda untuk pola *-AzureRM* untuk menentukan apakah salah satunya menggunakan modul AzureRM PowerShell.

Tingkatkan ke modul Az PowerShell

Skrip yang ditulis untuk cmdlet AzureRM tidak akan berfungsi secara otomatis dengan Az. Untuk mempermudah transisi, toolkit migrasi AzureRM ke Az dikembangkan. Migrasi ke set perintah baru memang tidak pernah mudah, tetapi artikel ini akan membantu Anda memulai transisi ke modul Az PowerShell. Untuk mempelajari selengkapnya tentang mengapa modul Az PowerShell dibuat, lihat Memperkenalkan modul Az PowerShell.

Nama cmdlet baru telah dirancang agar mudah dipelajari. Alih-alih menggunakan AzureRm atau Azure dalam nama cmdlet, gunakan Az. Misalnya, cmdlet lama New-AzureRMVm telah menjadi New-AzVm. Namun, migrasi lebih dari sekadar menjadi akrab dengan nama cmdlet baru, meskipun begitu. Ada modul yang diganti namanya, parameter, dan perubahan penting lainnya.

Untuk melihat daftar lengkap perubahan besar antara AzureRM dan Az, lihat perubahan lengkap dari AzureRM ke Az.

Pastikan skrip yang ada berfungsi dengan rilis AzureRM terbaru

Sebelum mengambil langkah-langkah migrasi apa pun, tentukan versi AzureRM apa yang diinstal pada sistem Anda. Melakukannya memungkinkan Anda memastikan skrip sudah berjalan pada rilis terbaru dan memberi tahu Anda versi AzureRM apa yang harus dihapus instalasinya.

Untuk menentukan versi AzureRM apa yang telah Anda instal, jalankan contoh berikut:

Get-Module -Name AzureRM -ListAvailable -All

Rilis AzureRM terbaru terbaru yang tersedia6.13.2. Jika Anda tidak menginstal versi ini, skrip yang ada mungkin memerlukan modifikasi tambahan untuk bekerja dengan modul Az di luar cakupan apa yang dijelaskan dalam artikel ini dan di daftar perubahan yang merusak .

Jika skrip Anda tidak berfungsi dengan AzureRM 6.13.2, perbarui skrip sesuai dengan panduan migrasi AzureRM 5.x hingga 6.x. Jika Anda menggunakan versi modul AzureRM yang lebih lama, ada panduan migrasi yang tersedia untuk setiap versi utama.

Opsi yang direkomendasikan ini meminimalkan upaya yang diperlukan untuk memigrasikan skrip AzureRM ke Az.

Dengan toolkit migrasi AzureRM ke Az, Anda dapat membuat rencana untuk menentukan perubahan apa yang akan dilakukan pada skrip Anda sebelum melakukan modifikasi apa pun kepada mereka dan sebelum menginstal modul Az PowerShell.

Secara otomatis memigrasikan skrip PowerShell dari AzureRM ke modul Az PowerShell mulai cepat memandu Anda melalui seluruh proses memperbarui skrip PowerShell Anda secara otomatis dari AzureRM ke modul Az PowerShell.

Opsi 2: Gunakan mode kompatibilitas dengan Enable-AzureRmAlias

Modul Az memiliki mode kompatibilitas untuk membantu Anda menggunakan skrip yang ada saat Anda memperbarui ke sintaks baru. Cmdlet Enable-AzureRmAlias mengaktifkan mode kompatibilitas melalui alias. Mode ini memungkinkan Anda menggunakan skrip yang ada dengan modifikasi minimal sambil bekerja menuju migrasi penuh ke Az. Secara default, Enable-AzureRmAlias hanya mengaktifkan alias kompatibilitas untuk sesi PowerShell saat ini. Gunakan parameter Scope untuk mempertahankan alias kompatibilitas di seluruh sesi PowerShell. Untuk informasi selengkapnya, lihat dokumentasi referensi Enable-AzureRmAlias.

Penting

Meskipun nama cmdlet diberi alias, mungkin masih ada parameter baru (atau diganti namanya) atau nilai pengembalian yang diubah untuk cmdlet Az. Jangan berharap mengaktifkan alias untuk mengurus migrasi untuk Anda. Lihat daftar perubahan pemisah penuh untuk menemukan di mana skrip Anda mungkin memerlukan pembaruan.

Dukungan untuk Enable-AzureRmAlias tidak akan dihentikan seiring dengan penghentian modul AzureRM PowerShell.

Langkah berikutnya