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

Bu makalede, PowerShell Galerisi'den Azure Az PowerShell modülünün nasıl yükleneceği açıklanmaktadır. Bu yönergeler Windows, Linux ve macOS platformlarında çalışır.

Azure Az PowerShell modülü, Azure Cloud Shell ve Docker görüntülerine önceden yüklenmiştir.

Azure Az PowerShell modülü bir toplama modülüdür. Bunu yüklemek, genel kullanıma sunulan Az PowerShell modüllerini indirir ve cmdlet'lerini kullanılabilir hale getirir.

Gereksinimler

Not

PowerShell 7.0.6 LTS, PowerShell 7.1.3 veya üzeri, tüm platformlarda Azure Az PowerShell modülüyle kullanmak için önerilen PowerShell sürümüdür.

Azure PowerShell, PowerShell 7.0.6 LTS ve PowerShell 7.1.3 veya üzeri sürümlerde çalıştırıldığında ek gereksinimlere sahip değildir.

PowerShell sürümünüzü belirlemek için bir PowerShell oturumundan aşağıdaki komutu çalıştırın:

$PSVersionTable.PSVersion

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

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Yükleme

Install-Module cmdlet'ini kullanmak, Az PowerShell modülü için tercih edilen yükleme yöntemidir. Az modülünü yalnızca geçerli kullanıcı için yükleyin. Bu, önerilen yükleme kapsamıdır. Bu yöntem Windows, Linux ve macOS platformlarında aynı şekilde çalışır. Bir 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 üzeri, PowerShell'in Install-Module önerilen sürümü ve önerilen yükleme seçeneği olsa da, gerekirse ek yükleme seçenekleri vardır.

Windows PowerShell yükleme

Önemli

AzureRM PowerShell modülü yüklüyse devam etmeden önce az ve AzureRM birlikte bulunma konusuna bakın.

Azure Az PowerShell modülü, Windows üzerinde PowerShell 5.1 ile kullanım için de desteklenir. Windows üzerinde PowerShell 5.1'de Azure Az PowerShell modülünü kullanmak için:

  1. Windows PowerShell 5.1’e güncelleştirin. Windows 10 sürüm 1607 veya üzeri sürümü kullanıyorsanız, zaten PowerShell 5.1 yüklüdür.
  2. .NET Framework 4.7.2 veya sonraki sürümünü yükleyin.
  3. En son PowerShellGet sürümünü kullandığınızdan emin olun. Install-Module -Name PowerShellGet -Force öğesini çalıştırın.

Çevrimdışı Yükleme

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

  • Azure PowerShell MSI'sini indirin. MSI yükleyicisinin yalnızca Windows üzerinde PowerShell 5.1 için kullanılabildiğini unutmayın.
  • Modülleri ağınızdaki başka bir konuma indirin ve bu konumu yükleme kaynağı olarak kullanın. Bu yöntem, PowerShell modüllerini PowerShellGet ile bağlantısız sistemlere dağıtmak üzere tek sunucuda veya dosya paylaşımında önbelleğe almanızı sağlar. Yerel depoyu ayarlamayı ve bağlantısız sistemlerde yüklemeyi öğrenmek için Yerel PowerShellGet depolarıyla çalışma konusundan yararlanın.
  • Save-Module ile modülü bir dosya paylaşımına kaydedin veya başka bir kaynağa kaydedip diğer makinelere el ile kopyalayın.

Oturum aç

Azure PowerShell ile çalışmaya başlamak için, Azure kimlik bilgilerinizle oturum açın.

Connect-AzAccount

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

Azure PowerShell modülünü güncelleştirme

Bir PowerShell modülünü güncelleştirmek için modülü yüklerken kullandığınız yöntemi kullanmanız gerekir. Örneğin, ilk olarak Install-Module kullandıysanız en son sürümü edinmek için Update-Module kullanmanız gerekir. Başlangıçta MSI paketini kullandıysanız yeni MSI paketini indirip yüklemeniz gerekir.

PowerShellGet cmdlet'leri, bir MSI paketinden yüklenen modülleri güncelleştiremez. MSI paketleri, PowerShellGet kullanılarak yüklenen modülleri güncelleştirmez. PowerShellGet kullanarak güncelleştirme konusunda sorun yaşıyorsanız güncelleştirme yerineyeniden yüklemeniz gerekir. Yeniden yükleme, yüklemeyle aynı şekilde yapılır. yeniden yüklerken parametresini ile Install-Module kullandığınızdan Force emin olun.

MSI tabanlı yüklemelerden farklı olarak, PowerShellGet kullanarak yükleme veya güncelleştirme, sisteminizde mevcut olabilecek eski sürümleri kaldırmaz.

Not

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

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

Sorun giderme

Azure Az PowerShell modülüyle ilgili yükleme sorunlarını giderme.

Geribildirim gönderme

Azure Az PowerShell modülünde bir hata bulursanız GitHub'da bir sorun oluşturun. PowerShell oturumundan geri bildirim sağlamak için Send-Feedback cmdlet'ini kullanın.

Sonraki Adımlar

Azure Az PowerShell modülleri ve özellikleri hakkında daha fazla bilgi edinmek için bkz. Azure PowerShell kullanmaya başlama. Azure PowerShell’i zaten biliyorsanız ve AzureRM’den geçiş yapmanız gerekiyorsa bkz. AzureRM’den Az’ye geçiş.