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.
- İşletim sisteminiz için sunulan en son PowerShell sürümünü yükleyin.
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:
- 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.
- .NET Framework 4.7.2 veya sonraki sürümünü yükleyin.
- 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ş.