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. Silakan merujuk ke 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* guna menentukan apakah salah satunya menggunakan modul AzureRM PowerShell.

Meningkatkan ke modul Az PowerShell

Skrip yang ditulis untuk cmdlet AzureRM tidak akan secara otomatis berfungsi dengan Az. Untuk mempermudah transisi, toolkit migrasi AzureRM ke Az dikembangkan. Tidak ada migrasi ke set perintah baru selalu 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 menjadi akrab dengan nama cmdlet baru. Ada modul, parameter, dan perubahan penting lainnya yang diganti namanya.

Untuk melihat daftar lengkap perubahan yang dapat menyebabkan gangguan antara AzureRM dan Az, lihat perubahan lengkap dari AzureRM ke Az.

Memastikan 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 Terbaru yang tersedia dari AzureRM adalah 6.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 dalam daftar perubahan yang melanggar.

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 disarankan 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 membuat modifikasi apa pun pada skrip tersebut dan sebelum menginstal modul Az PowerShell.

Mulai cepat Modul Memigrasikan skrip PowerShell secara otomatis dari AzureRM ke Az PowerShell memandu Anda melalui seluruh proses memperbarui skrip PowerShell Anda secara otomatis dari AzureRM ke modul Az PowerShell.

Opsi 2: Menggunakan mode kompatibilitas dengan Enable-AzureRmAlias

Modul Az memiliki mode kompatibilitas untuk membantu Anda menggunakan skrip yang ada saat memperbarui ke sintaksis baru. Cmdlet Enable-AzureRmAlias memungkinkan mode kompatibilitas melalui alias. Mode ini memungkinkan Anda menggunakan skrip yang ada dengan modifikasi minimal saat 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 merupakan alias, mungkin masih ada parameter baru (atau berganti nama) atau nilai pengembalian yang diubah untuk cmdlet Az. Jangan berharap mengaktifkan alias untuk mengurus migrasi untuk Anda. Lihat daftar perubahan yang melanggar lengkap untuk menemukan tempat skrip Anda mungkin memerlukan pembaruan.

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

Langkah berikutnya