Azure PowerShell'i AzureRM'den Az modülüne geçirme

Dikkat

AzureRM PowerShell modülü 29 Şubat 2024'te kullanımdan kaldırıldı. Daha fazla bilgi için bkz . Azure PowerShell'i AzureRM'den Az'ye geçirme.

Kullanımdan kaldırma, AzureRM PowerShell modülünün kullanımdan kaldırılacağını ve daha sonra destek almayı kolaylaştıracağını gösterir. Bu, doğal olarak modülün çalışmayı durduracağı anlamına gelmez, ancak 29 Şubat 2024'ün ötesinde kullanımı kullanıcının takdirine ve riskine bağlıdır çünkü artık korunmayacak veya güncelleştirilmeyecektir.

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ılmış betikler otomatik olarak Az ile çalışmayacaktır. Geçişi kolaylaştırmak için AzureRM - Az geçişi araç seti geliştirilmiştir. Yeni bir komut kümesine geçmek hiçbir zaman rahat bir işlem olmamıştır, ama bu makale Az PowerShell modülüne geçişi başlatmanıza yardımcı olacaktır. Az PowerShell modülünün neden oluşturulduğu hakkında daha fazla bilgi edinmek için bkz. Yeni Azure PowerShell Az 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 başka önemli değişiklikler vardır.

AzureRM ile Az arasında hataya neden olan değişikliklerin tam listesini görmek için bkz. AzureRM'den AZ modülüne tüm değişiklikler.

Mevcut betikleri 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 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 büyük sürüm için geçiş kılavuzları sağlanır.

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

AzureRM - Az geçişi araç setiyle, betiklerinizde değişiklikler yapmadan ve Az PowerShell modülünü yüklemeden önce bu betiklerin nasıl değiştirileceğini belirleyen bir plan oluşturabilirsiniz.

PowerShell betiklerini AzureRM'den Az PowerShell modülüne otomatik olarak geçirme hızlı başlangıcı, 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

Yeni söz dizimine güncelleştirirken mevcut betikleri de kullanmanıza yardımcı olmak için Az modülünün bir uyumluluk modu vardır. Enable-AzureRmAlias cmdlet’i, diğer adlar aracılığıyla bir 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 geçerli PowerShell oturumunun uyumluluk diğer adlarını etkinleştirir. Uyumluluk diğer adlarını PowerShell oturumları arasında kalıcı hale getirmek için Scope parametresini kullanın. Daha fazla bilgi için bkz. Enable-AzureRmAlias başvuru belgeleri.

Önemli

Cmdlet adlarının diğer adları olsa da, Az cmdlet'lerinde yeni (veya yeniden adlandırılmış) parametreler veya değiştirilmiş dönüş değerleri olacaktır. Diğer adları etkinleştirmenin geçişle sizin için ilgilenmesini beklemeyin. Betiklerinizin nerede güncelleştirme gerektirdiğini bulmak için, hataya neden olan değişikliklerin tam listesine bakın.

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

Sonraki adımlar