Menginstal modul Azure Az PowerShell

  • Artikel
  • 5 menit untuk membaca

Artikel ini menjelaskan cara menginstal modul Azure Az PowerShell menggunakan PowerShellGet. Instruksi ini bekerja pada platform Windows, macOS, dan Linux.

Modul Azure Az PowerShell diinstal sebelumnya di Azure Cloud Shell dan di citra Docker.

Modul Azure Az PowerShell adalah modul rollup. Menginstalnya berarti mengunduh modul Az PowerShell yang tersedia secara umum, dan membuat cmdlet-nya tersedia untuk digunakan.

Persyaratan

Catatan

PowerShell 7.0.6 LTS, PowerShell 7.1.3, atau lebih tinggi adalah versi PowerShell yang direkomendasikan untuk digunakan dengan modul Azure Az PowerShell di semua platform.

Azure PowerShell tidak memiliki persyaratan tambahan saat dijalankan di PowerShell 7.0.6 LTS dan PowerShell 7.1.3 atau versi yang lebih baru.

Untuk memeriksa versi PowerShell Anda, jalankan perintah berikut dari dalam sesi PowerShell:

$PSVersionTable.PSVersion

Kebijakan eksekusi skrip PowerShell harus berupa diatur ke ditandai jarak jauh atau kurang membatasi. Get-ExecutionPolicy -List dapat digunakan untuk menentukan kebijakan eksekusi saat ini. Untuk informasi selengkapnya, lihat about_Execution_Policies.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Penginstalan

Menggunakan cmdlet Install-Module adalah metode penginstalan yang diutamakan untuk modul Az PowerShell. Pasang modul Az hanya untuk pengguna saat ini. Ini adalah cakupan penginstalan yang direkomendasikan. Metode ini bekerja sama pada platform Windows, macOS, dan Linux. Jalankan perintah dari sesi PowerShell berikut ini:

Install-Module -Name Az -Scope CurrentUser -Repository PSGallery -Force

Opsi Penginstalan Lainnya

Saat PowerShell 7.0.6 LTS, PowerShell 7.1.3, atau versi yang lebih baru adalah versi PowerShell yang direkomendasikan, dan Install-Module adalah opsi penginstalan yang direkomendasikan, terdapat opsi penginstalan tambahan jika diperlukan.

Penginstalan di Windows PowerShell

Penting

Jika Anda menginstal modul AzureRM PowerShell, lihat bagian koeksistensi Az dan AzureRM dari artikel ini sebelum melanjutkan.

Modul Azure Az PowerShell juga didukung untuk penggunaan dengan PowerShell 5.1 di Windows. Untuk menggunakan modul Azure Az PowerShell di PowerShell 5.1 di Windows:

  1. Perbarui ke Windows PowerShell 5.1. Jika menggunakan Windows 10 versi 1607 atau lebih tinggi, Anda telah menginstal PowerShell 5.1.
  2. Instal .NET Framework 4.7.2 or versi lebih baru.
  3. Pastikan Anda telah menginstal PowerShellGet versi terbaru. Jalankan Install-Module -Name PowerShellGet -Force.

Penginstalan Offline

Di beberapa lingkungan, tidak mungkin untuk terhubung ke Galeri PowerShell. Dalam situasi tersebut, Anda dapat menginstal modul Az PowerShell secara offline menggunakan salah satu metode ini:

  • Unduh Azure PowerShell MSI. Perlu diingat bahwa penginstal MSI hanya berfungsi untuk PowerShell 5.1 di Windows.
  • Unduh modul ke lokasi lain di jaringan Anda dan gunakan sebagai sumber penginstalan. Metode ini memungkinkan Anda menyimpan modul PowerShell pada satu server atau berbagi file untuk disebarkan dengan PowerShellGet ke sistem yang terputus. Pelajari cara menyiapkan repositori lokal dan menginstal pada sistem yang terputus dengan Bekerja dengan repositori PowerShellGet lokal.
  • Simpan modul dengan Simpan-Modul ke berbagi file, atau simpan ke sumber lain dan salin secara manual ke mesin lain.

Masuk

Untuk mulai bekerja dengan Azure PowerShell, masuk dengan info masuk Azure Anda.

Connect-AzAccount

Setelah menjalankan perintah ini, jendela browser baru akan muncul dan Anda dapat masuk ke akun Azure Anda.

Memperbarui modul Azure PowerShell

Untuk memperbarui modul PowerShell apa pun, Anda harus menggunakan metode yang sama yang digunakan untuk menginstal modul. Misalnya, jika Anda awalnya menggunakan Install-Module, Anda harus menggunakan Update-Module untuk mendapatkan versi terbaru. Jika Anda awalnya menggunakan paket MSI, Anda harus mengunduh dan menginstal paket MSI baru.

Cmdlet PowerShellGet tidak dapat memperbarui modul yang diinstal dari paket MSI. Paket MSI tidak memperbarui modul yang diinstal menggunakan PowerShellGet. Jika Anda memiliki masalah saat memperbarui menggunakan PowerShellGet, Anda harus menginstal ulang, bukan memperbarui. Menginstal ulang dilakukan dengan cara yang sama seperti saat menginstal. Pastikan Anda menggunakan parameter Force dengan Install-Module saat menginstal ulang.

Tidak seperti penginstalan berbasis MSI, menginstal atau memperbarui menggunakan PowerShellGet tidak menghapus versi lama yang mungkin ada di sistem Anda.

Catatan

Penghapusan instalan dapat menjadi rumit jika Anda memiliki lebih dari satu versi modul Az PowerShell yang terinstal. Karena kompleksitas ini, kami hanya mendukung penghapusan instalan semua versi modul Az PowerShell yang saat ini terinstal.

Untuk menghapus semua versi modul Az PowerShell dari sistem Anda, lihat Menghapus instalan modul Azure PowerShell. Untuk informasi selengkapnya tentang instalasi berbasis MSI, lihat Menginstal Azure PowerShell dengan MSI.

Pemecahan Masalah

Berikut beberapa masalah umum yang muncul saat menginstal Azure Az PowerShell. Jika masalah Anda tidak tercantum di sini, ajukan masalah di GitHub.

Koeksistensi Az dan AzureRM

Peringatan

Kami tidak mendukung modul AzureRM dan Az diinstal untuk PowerShell 5.1 di Windows pada saat yang bersamaan.

Dalam skenario di mana Anda ingin menginstal AzureRM dan modul Az PowerShell di sistem yang sama, AzureRM harus diinstal hanya di cakupan pengguna untuk Windows PowerShell. Pasang modul Az PowerShell untuk PowerShell 7.0.6 LTS, PowerShell 7.1.3, atau versi yang lebih tinggi di sistem yang sama.

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.

Visual Studio

Versi Visual Studio yang lebih lama dapat menginstal Azure PowerShell sebagai bagian dari beban kerja pengembangan Azure, yang menginstal modul AzureRM. Azure PowerShell dapat dihapus menggunakan alat penginstal Visual Studio atau dengan menggunakan "Hapus instalan" di fitur Aplikasi&. Jika Anda telah menginstal PowerShell 7.x, Anda mungkin harus menginstal secara manual modul Azure Az PowerShell.

Koneksi blok proksi

Jika Anda mendapatkan kesalahan dari Install-Module di mana Galeri PowerShell tidak dapat dijangkau, Anda mungkin berada di belakang proksi. Sistem operasi dan lingkungan jaringan yang berbeda memiliki persyaratan yang berbeda untuk mengonfigurasi proksi di seluruh sistem. Hubungi administrator sistem Anda untuk pengaturan proksi Anda dan cara mengonfigurasinya untuk lingkungan Anda.

PowerShell sendiri mungkin tidak dikonfigurasi untuk menggunakan proksi ini secara otomatis. Dengan PowerShell 5.1 dan yang lebih baru, konfigurasikan sesi PowerShell untuk menggunakan proksi menggunakan perintah berikut:

$webClient = New-Object -TypeName System.Net.WebClient
$webClient.Proxy.Credentials = [System.Net.CredentialCache]::DefaultNetworkCredentials

Jika info masuk sistem operasi Anda dikonfigurasi dengan benar, konfigurasi ini merutekan permintaan PowerShell melalui proksi. Agar pengaturan ini bertahan di antara sesi, tambahkan perintah ke profil PowerShell Anda.

Untuk menginstal paket, proksi Anda harus memungkinkan koneksi HTTPS ke www.powershellgallery.com.

Berikan umpan balik

Jika Anda menemukan bug di modul Azure Az PowerShell, ajukan masalah di GitHub. Untuk memberikan umpan balik di sesi PowerShell, gunakan cmdlet Send-Feedback.

Langkah berikutnya

Untuk mempelajari selengkapnya tentang modul Azure Az PowerShell dan fiturnya, lihat Memulai dengan Azure PowerShell. Jika Anda terbiasa dengan Azure PowerShell dan perlu bermigrasi dari AzureRM, lihat Memigrasi dari AzureRM ke Az.