Azure Az PowerShell modülünü yükleme

Bu makalede, PowerShellGetkullanılarak Azure Az PowerShell modülü nasıl yüklenir? Bu yönergeler Windows macOS ve Linux platformlarında çalışır.

Azure Az PowerShell modülü, Azure Bulut Kabuğu'da ve Docker resimlerde önceden yüklenmiş olarak bulunur.

Azure Az PowerShell modülü bir toplama modülüdür. Bu modüller yükleyerek genel olarak kullanılabilen Az PowerShell modüllerini indirir ve cmdlet'lerini kullanılabilir yapar.

Gereksinimler

Not

Tüm platformlarda Azure Az PowerShell modülüyle kullanmak için PowerShell 7.0.6 LTS, PowerShell 7.1.3 veya daha yeni sürümü önerilir.

Azure PowerShell PowerShell 7.0.6 LTS ve PowerShell 7.1.3 veya üzerinde çalıştırabilirsiniz.

PowerShell sürümünizi kontrol etmek için, PowerShell oturumunda aşağıdaki komutu çalıştırın:

$PSVersionTable.PSVersion

PowerShell betik yürütme ilkesi uzaktan imzalı veya daha az kısıtlayıcı olarak ayar olmalı. Get-ExecutionPolicy -List geçerli yürütme ilkesi belirlemek için kullanılabilir. Daha fazla bilgi için bkz. about_Execution_Policies.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Yükleme

Az PowerShell modülü için tercih edilen yükleme yöntemi Install-Module cmdlet'ini kullanmaktır. Yalnızca geçerli kullanıcı için Az modülünü yükleyin. Bu, önerilen yükleme kapsamıdır. Bu yöntem macOS, Windows Linux platformlarında da aynı şekilde çalışır. PowerShell oturumunda aşağıdaki komutu çalıştırın:

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

Diğer Yükleme Seçenekleri

PowerShell 7.0.6 LTS, PowerShell 7.1.3 veya daha yenisi de PowerShell'in önerilen sürümüdür ve önerilen yükleme seçeneği ise gerekirse ek yükleme Install-Module seçenekleri vardır.

Yükleme Windows PowerShell

Önemli

AzureRM PowerShell modülü yüklüyse, devam etmeden önce bu makalenin Az ve AzureRM birlikte kullanım bölümüne bakın.

Azure Az PowerShell modülü, powershell üzerinde PowerShell 5.1 ile Windows. PowerShell 5.1'de Azure Az PowerShell modülünü kullanmak Windows:

  1. Windows PowerShell 5.1'e güncelleştirin. 1607 veya Windows 10 veya daha yeni bir sürümünüz varsa, PowerShell 5.1 zaten yüklüdür.
  2. .NET Framework 4.7.2 veya sonraki bir sürümü yükleyin.
  3. PowerShellGet'in en son sürümünün yüklü olduğundan emin olun. Çalıştır Install-Module -Name PowerShellGet -Force .

Çevrimdışı Yükleme

Bazı ortamlarda, PowerShell Galerisi'ne bağlanmak mümkün değildir. Böyle durumlarda, şu yöntemlerden birini kullanarak Az PowerShell modülünü çevrimdışı yükleyebilirsiniz:

  • Azure PowerShell MSI'i indirin. MSI yükleyicisi'nin yalnızca PowerShell 5.1 için Windows.
  • Modülleri ağınız içinde başka bir konuma indirin ve bunu yükleme kaynağı olarak kullanın. Bu yöntem, PowerShellget ile dağıtılacak tek bir sunucu veya dosya paylaşımında PowerShell modüllerini tüm bağlantısı kesik sistemlerde önbelleğe a,sağlar. Yerel PowerShellGet depoları ile çalışma ile yerel bir depo ayarlamayı ve bağlantısı kesik sistemlere yüklemeyi öğrenin.
  • Modülü Dosya paylaşımına Kaydet Modülü ile kaydedin veya başka bir kaynaktan başka bir kaynaktan el ile başka makinelere kopyalayın.

Oturum Aç

Diğer kullanıcılarla çalışmaya Azure PowerShell için Azure kimlik bilgilerinizle oturum açma.

Connect-AzAccount

Bu komutu yürüttkten sonra yeni bir tarayıcı penceresi açılır ve Azure hesabınızla oturum açabilirsiniz.

Modül Azure PowerShell güncelleştirme

Herhangi bir PowerShell modülünü güncelleştirmek için, modülü yüklemek için kullanılan yöntemle aynı yöntemi kullan gerekir. Örneğin, başlangıçta 'ı Install-Module kullandıysanız, en son sürümü almak için Güncelleştirme Modülü'dür. Başlangıçta MSI paketini kullandıysanız, yeni MSI paketini indirmeli ve yüklelisiniz.

PowerShellGet cmdlet'leri, bir MSI paketinden yüklenmiş modülleri güncelleştiramaz. MSI paketleri PowerShellGet kullanılarak yüklenmiş modülleri güncelleştirmez. PowerShellGet kullanarak güncelleştirme sorunlarınız varsa, 'ı güncelleştirmek yerine yeniden yüklemeniz gerekir. Yeniden yükleme, yükleme ile aynı şekilde yapılır. Yeniden yüklenirken Force parametreyi birlikte Install-Module kullanın.

MSI tabanlı yüklemelerin aksine, PowerShellGet kullanarak yüklemek veya güncelleştirmek, sistemde mevcut olan eski sürümleri kaldırmaz.

Not

Az PowerShell modülünün birden fazla sürümünü yüklemişsanız, kaldırma işlemi karmaşık olabilir. Bu karmaşıklık nedeniyle, yalnızca yüklü olan Az PowerShell modülünün tüm sürümlerini kaldırmayı destekliyoruz.

Az PowerShell modülünün tüm sürümlerini sistemiden kaldırmak için bkz. Az PowerShell Azure PowerShell kaldırma. MSI tabanlı yüklemeler hakkında daha fazla bilgi için bkz. MSI Azure PowerShell yükleme.

Sorun giderme

Burada, Azure Az PowerShell modülünü yüklerken görülen bazı yaygın sorunlar yer alır. Burada listelenmiyorsa, sorun 12 saat içinde GitHub.

Az ve AzureRM birlikte kullanılabilirlik

Uyarı

Aynı anda hem AzureRM hem de Az modüllerinin PowerShell 5.1 için Windows desteklenemmektedir.

Hem AzureRM'i hem de Az PowerShell modülünü aynı sisteme yüklemek istediğiniz bir senaryoda, AzureRM'nin yalnızca aşağıdaki kullanıcılar için kullanıcı kapsamına Windows PowerShell. Aynı sistem üzerinde PowerShell 7.0.6 LTS, PowerShell 7.1.3 veya daha yüksek bir sürümü için Az PowerShell modülünü yükleyin.

Önemli

Az PowerShell modülleri artık AzureRM PowerShell modüllerinin tüm özelliklerine ve daha fazlasına sahip olduğundan, 29 Şubat 2024'te AzureRM PowerShell modüllerini kullanımdan kaldırmamız gerekir.

Hizmet kesintilerini önlemek için AzureRM PowerShell modüllerini kullanan betiklerinizi 29 Şubat 2024'e kadar Az PowerShell modüllerini kullanacak şekilde güncelleştirin. Betiklerinizi otomatik olarak güncelleştirmek için hızlı başlangıç kılavuzunu izleyin.

Visual Studio

İş yüklerinin Visual Studio sürümleri Azure PowerShell AzureRM modülünü yüken Azure geliştirme iş yükünün bir parçası olarak yüklü olabilir. Azure PowerShell yükleme, Visual Studio yükleyicisi kullanılarak veya Uygulamalar ve Özellikler'de "Kaldır" & kaldırılabilir. PowerShell 7.x'i zaten yüklemişsanız, Azure Az PowerShell modülünü el ile yüklemeniz gerekebilir.

Ara sunucu bağlantısını engeller

Install-ModulePowerShell Galerisi'nin ulaşılamama hatasıyla ilgili hatalar asanız, bir proxy arkasındayabilirsiniz. Farklı işletim sistemlerinin ve ağ ortamının sistem çapında bir ara sunucu yapılandırmak için farklı gereksinimleri vardır. Proxy ayarlarınız ve bunları ortamınız için nasıl yapılandıracakları hakkında sistem yöneticinize başvurun.

PowerShell'in kendisi bu proxy'yi otomatik olarak kullanmak üzere yapılandırılmamış olabilir. PowerShell 5.1 ve sonrakileriyle, PowerShell oturumunu aşağıdaki komutları kullanarak ara sunucu kullanmak üzere yapılandırın:

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

İşletim sistemi kimlik bilgileriniz doğru yapılandırıldıysa, bu yapılandırma PowerShell isteklerini ara sunucu üzerinden yönlendirmektedir. Bu ayarın oturumlar arasında kalıcı olarak devam etmesi için komutları PowerShell profilinize ekleyin.

Paketi yüklemek için, ara sunucuya https bağlantılarına izin www.powershellgallery.com.

Geri bildirim sağlama

Azure Az PowerShell modülünde bir hata bulursanız, dosya üzerinde bir GitHub. PowerShell oturumunda geri bildirim sağlamak için, Geri Bildirim Gönder cmdlet'ini kullanın.

Sonraki Adımlar

Azure Az PowerShell modülleri ve özellikleri hakkında daha fazla bilgi edinmek için bkz. Başlarken özellikleri Azure PowerShell. Bu sorun hakkında bilginiz Azure PowerShell AzureRM'den geçiş yapmak için bkz. AzureRM'den Az'e geçiş.