Memigrasikan Azure PowerShell dari AzureRM ke Az
Semua versi modul AzureRM PowerShell telah usang. Modul Az PowerShell adalah modul PowerShell yang disarankan untuk berinteraksi dengan Azure.
Penting
Karena modul Az PowerShell sekarang memiliki semua kemampuan modul AzureRM PowerShell dan lebih banyak lagi, kami akan menghentikan modul AzureRM PowerShell pada 29 Februari 2024.
Untuk menghindari gangguan layanan, perbarui skrip Anda yang menggunakan modul AzureRM PowerShell untuk menggunakan modul Az PowerShell paling lambat 29 Februari 2024. Untuk memperbarui skrip Anda secara otomatis, ikuti panduan memulai cepat.
Mengapa ada modul baru?
Perubahan terbesar dan paling penting adalah bahwa PowerShell, yang didasarkan pada perpustakaan .NET Standard, telah menjadi produk lintas platform sejak diperkenalkan.
Seperti bahasa PowerShell, kami berkomitmen untuk menghadirkan dukungan Azure ke semua platform. Komitmen kami berarti bahwa modul Azure PowerShell perlu diperbarui untuk menggunakan .NET Standard dan kompatibel dengan PowerShell Core. Alih-alih memodifikasi modul AzureRM yang ada dan memperkenalkan perubahan kompleks untuk menambahkan dukungan ini, modul Az dibuat.
Membuat modul baru juga memungkinkan teknisi kami membuat desain, penamaan cmdlet, dan modul yang konsisten. Semua modul sekarang dimulai dengan awalan Az. dan semua cmdlet menggunakan konvensi penamaan Verb-AzNoun. Sebelumnya, nama cmdlet lebih panjang dan tidak konsisten.
Jumlah modul juga berkurang: Beberapa modul yang bekerja dengan layanan yang sama telah digabungkan. Sarana manajemen dan cmdlet data plane untuk layanan yang sama sekarang terkandung dalam satu modul. Bagi Anda yang mengelola dependensi dan impor secara manual, konsolidasi ini membuat segalanya jauh lebih sederhana.
Dengan membuat perubahan penting ini, tim telah berkomitmen untuk membuatnya lebih mudah dari sebelumnya dan pada lebih banyak platform daripada sebelumnya untuk menggunakan Azure dengan cmdlet PowerShell.
Meningkatkan ke 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 lebih lanjut tentang alasan modul Az PowerShell dibuat, lihat Memperkenalkan modul Az Azure PowerShell baru.
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-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 melakukan langkah migrasi, periksa versi AzureRM mana yang terinstal pada sistem Anda. Melakukan hal itu memungkinkan Anda memastikan skrip sudah berjalan pada rilis terbaru, dan memberi tahu Anda versi AzureRm mana yang harus dihapus instalan.
Untuk memeriksa versi AzureRM mana yang telah Anda terinstal, 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 1 (disarankan): Memigrasikan skrip PowerShell Anda secara otomatis
Opsi yang disarankan ini meminimalkan upaya yang diperlukan untuk memigrasikan skrip AzureRM ke Az.
Menginstal toolkit migrasi AzureRM ke Az
Install-Module -Name Az.Tools.Migration
Mengonversi skrip Anda secara otomatis
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. Proses migrasi tidak dapat berjalan otomatis hanya karena alias diaktifkan. Lihat daftar perubahan yang melanggar lengkap untuk menemukan tempat skrip Anda mungkin memerlukan pembaruan.
Opsi 3: Migrasikan skrip Anda dalam Visual Studio Code dengan ekstensi Azure PowerShell
Instal ekstensi Azure PowerShell untuk Visual Studio Code
Instal ekstensi Azure PowerShell untuk VSCode
Mengonversi skrip Anda secara manual
- Memuat skrip AzureRM Anda di VSCode
- Mulai migrasi dengan membuka palet perintah
Ctrl+Shift+Pdan pilihMigrate Azure PowerShell script - Pilih versi sumber
AzureRM - Ikuti tindakan yang disarankan untuk setiap perintah atau parameter yang digarisbawahi.