Memigrasikan Azure PowerShell dari AzureRM ke 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 1 (disarankan): Memigrasikan skrip PowerShell Anda secara otomatis

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.

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

Langkah berikutnya

• Secara otomatis memigrasikan skrip PowerShell
• Memperkenalkan modul Az PowerShell
• Perubahan antara AzureRM dan Az
• Menginstal modul Az PowerShell
• Hapus instalan AzureRM