Aracılığıyla paylaş

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

  • Makale

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, betiklerinizden herhangi birinin AzureRM PowerShell modülünü kullanıp kullanmadığını belirlemek üzere desen *-AzureRM* için tam metin araması 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ş 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ı öğrenmesi kolay olacak şekilde tasarlanmıştır. cmdlet adlarında AzureRm veya Azure kullanmak yerine Azkullanın. Örneğin, eski cmdlet New-AzureRMVmNew-AzVmhaline gelmiştir. 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 arasındaki geriye dönük uyumsuz değişikliklerin tam listesini görmek için bkz. AzureRM'den Az'a yapılan tüm değişikliklerin.

Mevcut betiklerin en son AzureRM sürümüyle çalıştığından emin olun

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 sürümü 6.13.2. 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 listesindeaçıklananların dışında ek değişiklikler gerekebilir.

Betikleriniz AzureRM 6.13.2 ile çalışmıyorsa, 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 bir uyumluluk modu etkinleştirir. Bu mod, Az'ye tam geçiş için çalışırken en az değişiklikle mevcut betikleri kullanmanıza olanak tanır. Varsayılan olarak, Enable-AzureRmAlias yalnızca geçerli PowerShell oturumu için uyumluluk takma adlarını etkinleştirir. Uyumluluk diğer adlarını PowerShell oturumlarında kalıcı hale getirmek için Scope parametresini kullanın. Daha fazla bilgi için Enable-AzureRmAlias başvuru belgeleri bakın.

Önemli

Cmdlet adları diğer adlarla adlandırılsa da, Az cmdlet'leri için 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. Komut dosyalarınızın güncelleme gerektirebileceği yerleri bulmak için tüm kırılma değişiklikleri 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