Aracılığıyla paylaş

Azure PowerShell'i AzureRM'den Az'ye geçirme

Uyarı

AzureRM PowerShell modülü 29 Şubat 2024 itibarıyla resmi olarak kullanım dışı bırakılmıştır. Kullanıcıların destek ve güncelleştirmelerin devam etmesini sağlamak için AzureRM'den Az PowerShell modülüne geçmeleri tavsiye edilir.

AzureRM modülü çalışmaya devam edebilir, ancak artık bakım yapılmaz veya desteklenmez ve kullanıcının takdirine ve riskine bağlı olarak sürekli kullanım sağlanır. Az modülüne geçiş konusunda yönergeler için lütfen geçiş kaynaklarımıza bakın.

AzureRM PowerShell modülünü kullanıp kullanmadığınızı belirleme

AzureRM PowerShell modülünün yüklü olup olmadığını belirlemek için aşağıdaki komutu kullanın:

Get-Module -Name AzureRM -ListAvailable

Ayrıca, betiklerinizin AzureRM PowerShell modülünü kullanıp kullanmadığını belirlemek üzere desen *-AzureRM* için tam metin araması da yapabilirsiniz.

Az PowerShell modülüne yükseltme

AzureRM cmdlet'leri için yazılan betikler, Az ile otomatik olarak çalışmaz. Geçişi kolaylaştırmak için AzureRM - Az geçişi araç seti geliştirilmiştir. Yeni bir komut kümesine geçiş yapmak kolay değildir, ancak bu makale Az PowerShell modülüne geçiş yapmaya başlamanıza yardımcı olacaktır. Az PowerShell modülünün neden oluşturulduğu hakkında daha fazla bilgi edinmek için bkz. Az PowerShell modülüne giriş.

Yeni cmdlet adları kolay öğrenilecek şekilde tasarlanmıştır. Cmdlet adlarında AzureRm veya Azure kullanmak yerine Az kullanın. Örneğin, eski New-AzureRMVm cmdlet’i New-AzVm olarak değiştirildi. Ancak geçiş, yeni cmdlet adları hakkında bilgi sahibi olmaktan daha fazlasıdır. Yeniden adlandırılmış modüller, parametreler ve diğer önemli değişiklikler vardır.

AzureRM ile Az modülleri arasındaki tüm önemli değişikliklerin tam listesini görmek için, bkz. AzureRM'den Az'a tam değişiklikler.

Mevcut komut dosyalarının en son AzureRM sürümüyle çalıştığından emin olmak için kontrol edin.

Geçiş adımlarını izlemeden önce sisteminizde hangi AzureRM sürümlerinin yüklü olduğunu belirleyin. Bunun yapılması, betiklerin en son sürümde zaten çalıştığından emin olmanıza ve hangi AzureRM sürümlerinin kaldırılması gerektiğini size bildirmenize olanak tanır.

Hangi AzureRM sürümlerini yüklediğinizi belirlemek için aşağıdaki örneği çalıştırın:

Get-Module -Name AzureRM -ListAvailable -All

AzureRM'nin en son kullanılabilir sürümü 6.13.2'dir. Sizde bu sürüm yüklü değilse mevcut betiklerinizin Az modülüyle çalışabilmesi için bu makalede ve hataya neden olan değişiklikler listesinde açıklananların ötesinde ek değişikler yapılması gerekebilir.

Betikleriniz AzureRM 6.13.2 ile çalışmıyorsa, bunları AzureRM 5.x ile 6.x arasındaki geçiş kılavuzuna göre güncelleştirin. AzureRM modülünün önceki bir sürümünü kullanıyorsanız, her ana sürüm için kullanılabilir geçiş kılavuzları vardır.

Bu önerilen seçenek, AzureRM betiklerini Az'ye geçirmek için gereken çabayı en aza indirir.

AzureRM'yi Az'ye geçirme araç seti ile, betiklerinizde değişiklik yapmadan önce ve Az PowerShell modülünü yüklemeden önce betiklerinizde hangi değişikliklerin gerçekleştirileceğini belirlemek için bir plan oluşturabilirsiniz.

PowerShell betiklerini AzureRM'den Az PowerShell modülüne otomatik olarak geçirme hızlı başlangıç, PowerShell betiklerinizi AzureRM'den Az PowerShell modülüne otomatik olarak güncelleştirme işleminin tamamında size yol gösterir.

Seçenek 2: Enable-AzureRmAlias ile uyumluluk modunu kullanma

Az modülünün, yeni söz dizimine güncelleştirirken var olan betikleri kullanmanıza yardımcı olacak bir uyumluluk modu vardır. Enable-AzureRmAlias cmdlet'i, diğer adlar aracılığıyla uyumluluk modunu etkinleştirir. Bu mod, Az’ye tam geçiş için çalışırken mevcut betikleri en az değişiklikle kullanmanıza olanak tanır. Varsayılan olarak, Enable-AzureRmAlias yalnızca mevcut PowerShell oturumu için uyumluluk takma adlarını etkinleştirir. Uyumluluk takma adlarını PowerShell oturumlarında devam ettirmek için Scope parametresini kullanın. Daha fazla bilgi için bkz. Enable-AzureRmAlias başvuru belgeleri.

Önemli

Cmdlet adları takma adlarla ilişkilendirilmiş olsa da, Az cmdlet'leri için yine de yeni (veya yeniden adlandırılmış) parametreler veya değiştirilmiş dönüş değerleri olabilir. Takma adları etkinleştirmenin taşıma sürecini sizin için halledeceğini beklemeyin. Betiklerinizin hangi kısımlarında güncelleme gerekebileceğini görmek için önemli değişikliklerin tam listesine bakın.

AzureRM PowerShell modülünün kullanımdan kaldırılmasıyla Enable-AzureRmAlias desteği kullanımdan kaldırılmaz.

Sonraki Adımlar