Az.Tools.Migration PowerShell modülüne genel bakış

  • Makale

Az.Tools.Migration PowerShell modülü, azure yönetimi için önerilen eski AzureRM modülünden daha yeni Az modülüne geçişi kolaylaştırır.

Önemli

AzureRM PowerShell modülü 29 Şubat 2024 itibarıyla kullanımdan kaldırılmıştır.

Microsoft, özellikle başlangıçta AzureRM için yazılmış betikleri güncelleştirmek için gereken çabayla ilgili olarak müşteri geri bildirimlerine yanıt olarak Az.Tools.Migration'ı kullanıma sunulmuştur. Birçok müşterinin Azure ortamları için karmaşık betikler oluşturmaya yatırım yaptığı kabul edilen Az.Tools.Migration, geçiş sürecini kolaylaştırmak ve otomatikleştirmek için oluşturulmuştur ve böylece el ile gerçekleştirilen iş yükü ve betik yükseltmeleri sırasında hata olasılığı azaltılır.

Az.Tools.Migration modülünü kullanma

Az.Tools.Migration kullanma işlemi birkaç adımdan oluşur:

  1. AzureRM sürüm 6.13.1'e güncelleştirme: Az.Tools.Migration'ı kullanmadan önce, kullanıcıların betiklerinin Az modülüne geçiş öncesinde son sürüm olan AzureRM sürüm 6.13.1'e güncelleştirildiğinden emin olmaları gerekir.

  2. Az.Tools.Migration'ı yükleme: Modül, komutuyla Install-Module -Name Az.Tools.Migration PowerShell Galerisi yüklenebilir.

  3. Yükseltme Planı Oluşturma:New-AzUpgradeModulePlan cmdlet bir yükseltme planı oluşturur. Mevcut betikleri değiştirmez, ancak belirli dosyaları ve güncelleştirmeleri gerektiren uzaklık noktalarını ayrıntılı olarak gösteren bir plan oluşturarak bir yükseltme yolu sağlar. Bu cmdlet, belirli betikleri veya klasörleri hedeflemek için FilePath ve DirectoryPath gibi parametreleri alır.

  4. Yükseltme Planını Gözden Geçirme: Yükseltmeyi yürütmeden önce, splatting kullanan komutlar gibi otomatik yükseltmeleri engelleyebilecek olası sorunlar için planı gözden geçirmek ve gerekirse bunları el ile düzeltmek çok önemlidir.

  5. Yükseltmeyi Gerçekleştirme: Sorunları gözden geçirip çözdükten sonra, asıl yükseltme cmdlet'i kullanılarak Invoke-AzUpgradeModulePlan gerçekleştirilir. Bu cmdlet mevcut dosyaları değiştirebilir veya özgün betikleri korumak için adlarına eklenmiş yeni dosyalardaki _az_upgraded değişiklikleri daha güvenli bir şekilde kaydedebilir.

Sorunsuz bir geçiş sağlamak için, cmdlet seçeneğiyle -FileEditMode SaveChangesToNewFiles kullanılmadığı takdirde yıkıcı olabileceğinden Invoke-AzUpgradeModulePlan yükseltmeleri gerçekleştirmeden önce betiklerin yedeklenmesi önerilir.

Kullanıcıların azure-powershell-migration için GitHub deposundaki geçiş işlemiyle ilgili geri bildirim sağlamaları veya sorunları bildirmeleri önerilir.