Menginstal Azure PowerShell

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

Azure PowerShell juga tersedia di Azure Cloud Shell.

Persyaratan

Azure PowerShell berfungsi dengan PowerShell 5.1 atau yang lebih tinggi di Windows, atau PowerShell Core 6.x dan yang lebih baru di semua platform. Anda harus menginstal versi terbaru PowerShell yang tersedia untuk sistem operasi Anda. Azure PowerShell tidak memiliki persyaratan tambahan saat dijalankan di PowerShell 6.2.4 dan yang lebih baru.

Untuk memeriksa versi PowerShell Anda, jalankan perintah :

$PSVersionTable.PSVersion

Untuk menggunakan Azure PowerShell di PowerShell 5.1 di Windows:

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

Menginstal modul Azure PowerShell

Peringatan

Kami tidak mendukung modul AzureRM dan Az yang diinstal untuk PowerShell 5.1 di Windows secara bersamaan. Jika Anda perlu menjaga AzureRM tetap tersedia di sistem Anda, instal modul Az untuk PowerShell 6.2.4 atau yang lebih baru.

Menggunakan cmdlet PowerShellGet adalah metode penginstalan pilihan. Instal modul Az hanya untuk pengguna saat ini. Ini adalah cakupan penginstalan yang direkomendasikan. Metode ini berfungsi sama pada platform Windows, Linux, dan macOS. Jalankan perintah berikut dari sesi PowerShell:

if (Get-Module -Name AzureRM -ListAvailable) {
    Write-Warning -Message ('Az module not installed. Having both the AzureRM and ' +
      'Az modules installed at the same time is not supported.')
} else {
    Install-Module -Name Az -AllowClobber -Scope CurrentUser
}

Secara default, galeri PowerShell tidak dikonfigurasi sebagai repositori tepercaya untuk PowerShellGet. Pertama kali Anda menggunakan PSGallery, Anda melihat perintah berikut:

Untrusted repository

You are installing the modules from an untrusted repository. If you trust this repository, change
its InstallationPolicy value by running the `Set-PSRepository` cmdlet.

Are you sure you want to install the modules from 'PSGallery'?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"):

Jawab Yes atau Yes to All lanjutkan dengan penginstalan.

Menginstal modul untuk semua pengguna pada sistem memerlukan hak istimewa yang ditingkatkan. Mulai sesi PowerShell menggunakan Jalankan sebagai administrator di Windows atau gunakan sudo perintah di macOS atau Linux:

if (Get-Module -Name AzureRM -ListAvailable) {
    Write-Warning -Message ('Az module not installed. Having both the AzureRM and ' +
      'Az modules installed at the same time is not supported.')
} else {
    Install-Module -Name Az -AllowClobber -Scope AllUsers
}

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

Pasang offline

Di beberapa lingkungan, Tidak dimungkinkan untuk terhubung ke Galeri PowerShell. Dalam situasi tersebut, Anda masih dapat menginstal offline menggunakan salah satu metode berikut:

  • Unduh modul ke lokasi lain di jaringan Anda dan gunakan sebagai sumber penginstalan. Metode ini memungkinkan Anda untuk 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.

  • Unduh Azure PowerShell MSI ke komputer yang terhubung ke jaringan, lalu salin alat penginstal ke sistem tanpa akses ke Galeri PowerShell. Perlu diingat bahwa penginstal MSI hanya berfungsi untuk PowerShell 5.1 di Windows.

  • Simpan modul dengan Save-Module ke berbagi file, atau simpan ke sumber lain dan salin secara manual ke komputer lain:

    Save-Module -Name Az -Path '\\server\share\PowerShell\modules' -Force
    

Pemecahan masalah

Berikut adalah beberapa masalah umum yang terlihat saat menginstal modul Azure PowerShell. Jika Anda mengalami masalah yang tidak tercantum di sini, ajukan masalah di GitHub.

Koneksi diblokir oleh proksi

Jika Anda mendapatkan kesalahan dari Install-Module yang menunjukkan bahwa Galeri PowerShell tidak dapat dijangkau, Anda mungkin berada di belakang server proksi. Sistem operasi dan lingkungan jaringan yang berbeda memiliki persyaratan yang berbeda untuk mengonfigurasi proksi di seluruh sistem. Hubungi administrator sistem 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 System.Net.WebClient
$webClient.Proxy.Credentials = [System.Net.CredentialCache]::DefaultNetworkCredentials

Jika kredensial 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 perlu mengizinkan koneksi HTTPS ke alamat berikut:

  • https://www.powershellgallery.com

Masuk akun

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

# Connect to Azure with a browser sign in token
Connect-AzAccount

Nota

Jika Anda telah menonaktifkan pemuatan otomatis modul, impor modul secara manual dengan Import-Module -Name Az. Karena cara modul disusun, ini dapat memakan waktu beberapa detik.

Anda harus mengulangi langkah-langkah ini untuk setiap sesi PowerShell baru yang Anda mulai. Untuk mempelajari cara mempertahankan masuk Azure Anda di seluruh sesi PowerShell, lihat Mempertahankan kredensial pengguna di seluruh sesi PowerShell.

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, maka 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 mengalami masalah saat memperbarui menggunakan PowershellGet, maka Anda harus menginstal ulang, daripada memperbarui. Penginstalan ulang dilakukan dengan cara yang sama seperti menginstal, tetapi Anda perlu menambahkan -Force parameter:

if (Get-Module -Name AzureRM -ListAvailable) {
    Write-Warning -Message ('Az module not installed. Having both the AzureRM and ' +
      'Az modules installed at the same time is not supported.')
} else {
    Install-Module -Name Az -AllowClobber -Force
}

Tidak seperti penginstalan berbasis MSI, menginstal atau memperbarui menggunakan PowerShellGet tidak menghapus versi lama yang mungkin ada di sistem Anda. Untuk menghapus versi lama Azure PowerShell dari sistem Anda, lihat Menghapus instalan modul Azure PowerShell. Untuk informasi selengkapnya tentang penginstalan berbasis MSI, lihat Menginstal Azure PowerShell dengan MSI.

Menggunakan beberapa versi Azure PowerShell

Dimungkinkan untuk menginstal lebih dari satu versi Azure PowerShell. Untuk memeriksa apakah Anda memiliki beberapa versi Azure PowerShell yang terinstal, gunakan perintah berikut:

Get-InstalledModule -Name Az -AllVersions | Select-Object -Property Name, Version

Untuk menghapus versi Azure PowerShell, lihat Menghapus instalan modul Azure PowerShell.

Jika Anda memiliki lebih dari satu versi modul yang terinstal, muat otomatis modul dan Import-Module muat versi terbaru secara default.

Anda dapat menginstal atau memuat versi Az modul tertentu dengan menggunakan -RequiredVersion parameter :

# Install Az version 3.6.1
Install-Module -Name Az -RequiredVersion 3.6.1
# Load Az version 3.6.1
Import-Module -Name Az -RequiredVersion 3.6.1

Berikan umpan balik

Jika Anda menemukan bug di Azure PowerShell, ajukan masalah di GitHub. Untuk memberikan umpan balik dari baris perintah, gunakan cmdlet Kirim-Umpan Balik .

Langkah Berikutnya

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