Melakukan Azure PowerShell dari AzureRM ke Az

Semua versi modul PowerShell AzureRM telah usang. Modul Az PowerShell kini merupakan modul PowerShell yang disarankan untuk berinteraksi dengan Azure.

Mengapa modul baru?

Perubahan terbesar dan paling penting adalah bahwa PowerShell,yang didasarkan pada pustaka .NET Standard, telah menjadi produk lintas platform sejak pengenalannya.

Seperti bahasa PowerShell, kami berkomitmen untuk menghadirkan dukungan Azure ke semua platform. Komitmen kami berarti bahwa Azure PowerShell modul diperlukan untuk menggunakan .NET Standard dan kompatibel dengan PowerShell Core. Modul Az dibuat untuk tidak mengubah modul AzureRM yang sudah ada dan memperkenalkan perubahan kompleks untuk menambahkan dukungan ini.

Membuat modul baru juga memungkinkan teknisi kami membuat desain, penamaan cmdlet, dan modul konsisten. Semua modul kini dimulai dengan Az. prefiks dan cmdlet semuanya Verb-AzNoun menggunakan konvensi penamaan. Sebelumnya, nama cmdlet lebih panjang dan tidak konsisten.

Jumlah modul juga dikurangi: Beberapa modul yang bekerja dengan layanan yang sama telah digabungkan. Cmdlet pesawat manajemen dan pesawat data untuk layanan yang sama kini dimuat dalam satu modul. Bagi Anda yang mengelola dependensi dan impor secara manual, konsolidasi ini membuat segalanya menjadi jauh lebih sederhana.

Dengan melakukan perubahan-perubahan penting ini, tim telah berkomitmen untuk memudahkan berbagai platform daripada sebelumnya yang memungkinkan untuk menggunakan Azure dengan cmdlet PowerShell.

Memutakhirkan ke Az PowerShell

Skrip yang ditulis untuk cmdlet AzureRM tidak akan secara otomatis berfungsi dengan Az. Untuk memudahkan transisi, toolkit migrasi AzureRM ke Az telah dikembangkan. Tidak ada migrasi ke kumpulan perintah baru yang memungkinkan, 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 Azure PowerShell az yang baru.

Nama cmdlet baru telah dirancang agar mudah untuk dipelajari. Daripada menggunakan AzureRm atau dalam nama Azure cmdlet, gunakan Az . Misalnya, cmdlet lama New-AzureRMVm telah menjadi New-AzVm . Namun, migrasi tidak hanya mengenal nama cmdlet yang baru. Terdapat modul, parameter, dan perubahan penting lainnya yang diubah namanya.

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

Memastikan bahwa skrip yang sudah ada berfungsi dengan rilis AzureRM terbaru

Sebelum melakukan langkah-langkah migrasi, periksa versi AzureRM yang diinstal di sistem Anda. Dengan demikian, Anda dapat memastikan bahwa skrip sudah berjalan pada rilis terbaru dan memberi tahu versi AzureRM mana yang harus dihapus instalannya.

Untuk memeriksa versi AzureRM yang telah diinstal, jalankan contoh berikut:

Get-Module -Name AzureRM -ListAvailable -All

Rilis terbaru AzureRM yang tersedia adalah 6.13.1. Jika Anda belum menginstal versi ini, skrip yang sudah ada mungkin memerlukan modifikasi tambahan untuk bekerja dengan modul Az yang melebihi lingkup apa yang dijelaskan di artikel ini dan dalam daftar perubahan terbaru.

Jika skrip Anda tidak berfungsi dengan AzureRM 6.13.1, perbarui 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 ini disarankan untuk meminimalkan upaya yang diperlukan untuk melakukan migrasi skrip AzureRM ke Az.

Instal toolkit migrasi AzureRM ke Az

Install-Module -Name Az.Tools.Migration

Mengonversi skrip secara otomatis

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

Mulai cepat migrasi skrip PowerShell secara otomatis dari AzureRM ke modul Az PowerShell akan memandu Anda sepanjang proses pembaruan skrip PowerShell 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 sudah ada saat anda memperbarui ke sintaks yang baru. Cmdlet Enable-AzureRmAlias mengaktifkan mode kompatibilitas melalui alias. Mode ini memungkinkan Anda menggunakan skrip yang sudah 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 Scope parameternya untuk tetap berada di alias kompatibilitas di seluruh sesi PowerShell. Untuk informasi selengkapnya, lihat Enable-AzureRmAlias referensi relatif.

Penting

Meskipun nama cmdlet alias, mungkin masih ada parameter baru (atau yang diganti namanya) atau mengubah nilai pengembalian untuk cmdlet Az. Jangan berharap mengaktifkan alias untuk menangani migrasi untuk Anda! Lihat daftar perubahan terkini untuk menemukan tempat skrip Anda mungkin memerlukan pembaruan.

Opsi 3: Melakukan migrasi skrip Visual Studio Code dengan ekstensi Azure PowerShell default

Menginstal ekstensi Azure PowerShell untuk Visual Studio Code

Menginstal ekstensi Azure PowerShell untuk VSCode

Mengonversi skrip secara manual

  1. Memuat skrip AzureRM Anda di VSCode
  2. Mulai migrasi dengan membuka palet Ctrl+Shift+P perintah, lalu pilih Migrate Azure PowerShell script
  3. Pilih versi sumber AzureRM
  4. Ikuti tindakan yang disarankan untuk setiap perintah atau parameter yang digarisbawahi.

Langkah berikutnya