AzureRM Azure PowerShell den Az'a geçiş

  • Makale
  • Okumak için 3 dakika

AzureRM PowerShell modülünün tüm sürümleri eskidir. Az PowerShell modülü artık Azure'la etkileşim kurmak için önerilen PowerShell modülüdür.

Neden yeni modül?

En büyük ve en önemli değişiklik, .NET Standard kitaplığını temel alan PowerShell'in,ilk kez kullanıldığı zamandan bu yana platformlar arası bir ürün olmasıdır.

PowerShell dili gibi, Azure desteğini tüm platformlara getirmeye kararlıyız. Taahhüdmuz Azure PowerShell .NET Standard'ın kullanımı için güncelleştirillenmesi ve PowerShell Core ile uyumlu olması anlamına gelir. Mevcut AzureRM modülünü değiştirmek ve bu desteği eklemek için karmaşık değişiklikler yapmak yerine Az modülü oluşturulur.

Yeni modül oluşturmak, mühendislerimizin tasarımı, cmdlet'leri adlandırma ve modülleri tutarlı hale vermelerine de izin verdi. Tüm modüller artık önek ve Az. cmdlet'lerle başlarken tüm modüller adlandırma kuralını Verb-AzNoun kullanır. Daha önce, cmdlet adları daha uzun ve tutarsızdı.

Modüllerin sayısı da azaltıldı: Aynı hizmetlerle çalışan bazı modüller birleştirildi. Aynı hizmet için yönetim uçağını ve veri uçağını cmdlet'leri artık tek bir modülde yer almaktadır. Bağımlılıkları ve içeri aktarmaları kendiniz yönetenler için, bu birleştirme işlemi çok daha basit hale getirir.

Bu önemli değişiklikleri yaparak ekip, Azure'un PowerShell cmdlet'leriyle birlikte kullanımını daha önce hiç olmadığı kadar çok platformda ve daha önce hiç olmadığı kadar çok platformda kullanmayı kolaylaştıracak şekilde taahhüt etti.

Az PowerShell'e 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'den Az'a geçiş araç seti geliştirilmiştir. Yeni bir komut kümesine geçiş yapmak hiç kolay değildir, ama bu makale Az PowerShell modülüne geçişe başlamanıza yardımcı olur. Az PowerShell modülünün neden oluşturuldu hakkında daha fazla bilgi edinmek için bkz. Az modülüne Azure PowerShell.

Yeni cmdlet adları, kolayca öğrennsin için tasarlanmıştır. AzureRmCmdlet Azure adlarını kullanmak yerine veya kullanmak yerine . Az Örneğin, eski cmdlet New-AzureRMVm haline New-AzVm geldi. Bununla birlikte, geçiş yalnızca yeni cmdlet adları ile aşina olmaktan daha fazlasıdır. Yeniden adlandırılan modüller, parametreler ve diğer önemli değişiklikler vardır.

AzureRM ile Az arasındaki en son değişikliklerin tam listesini görmek için AzureRM'den Az'akadar tüm değişiklikleri öğrenin.

Var olan betiklerin en son AzureRM sürümüyle çalışmasına emin olun

Herhangi bir geçiş adımı atmadan önce, sistemde hangi AzureRM sürümlerinin yüklü olduğunu kontrol edin. Bunu yapmak, en son sürümde betiklerin zaten çalışıyor olduğundan emin olun ve AzureRM'nin hangi sürümlerinin kaldırılması gerektiğini size haber verir.

Hangi AzureRM sürümlerini yüklemiş olduğunu kontrol etmek için aşağıdaki örneği çalıştırın:

Get-Module -Name AzureRM -ListAvailable -All

AzureRM'nin kullanılabilen en son sürümü 6.13.1'tir. Bu sürüm yüklü değilse, var olan betikleriniz Az modülünde, bu makalede açıklananların kapsamının ötesinde ve en son değişiklikler listesinde çalışmak için ek değişikliklere gereksinebilir.

Betikleriniz AzureRM 6.13.1 ile çalışmıyorsa, bunları AzureRM 5.x ile 6.xgeç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'a geçirmek için gereken çabayı en aza indirger.

AzureRM'den Az geçiş araç seti'ne yükleme

Install-Module -Name Az.Tools.Migration

Betiklerinizi otomatik olarak dönüştürme

AzureRM'den Az'e geçiş araç seti ile, betiklerde herhangi bir değişiklik öncesinde ve Az PowerShell modülünü yüklemeden önce betikleriniz üzerinde hangi değişikliklerin gerçekleştirileceklerini belirlemek için bir plan yapabilirsiniz.

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 tüm sürecinde size yol sunar.

2. Seçenek: Uyumluluk modunu uyumluluk modunda Enable-AzureRmAlias

Az modülünde, yeni söz dizimi güncelleştirme sırasında var olan betikleri kullanmanıza yardımcı olan bir uyumluluk modu bulunur. Enable-AzureRmAlias cmdlet'i diğer adlar aracılığıyla uyumluluk modunu etkinleştirir. Bu mod, Az'a tam geçiş üzerinde çalışırken mevcut betikleri çok az değişiklikle kullanabilirsiniz. Varsayılan olarak, Enable-AzureRmAlias yalnızca geçerli PowerShell oturumu için uyumluluk diğer adlarını sağlar. ScopePowerShell oturumlarında uyumluluk diğer adlarını kalıcı olarak kullanmak için parametreyi kullanın. Daha fazla bilgi için başvuru Enable-AzureRmAlias bakın.

Önemli

Cmdlet adları diğer adlara sahip olsa da Az cmdlet'leri için yine yeni parametreler (veya yeniden adlandırılmış) parametreler olabilir veya değiştirilmiş dönüş değerleri olabilir. Diğer adların geçiş işlemiyle sizin adınıza ilgilenmesini bekleme! Betiklerin güncelleştirme gerektirebilir olduğu yeri bulmak için tüm son güncelleştirme değişiklikleri listesine bakın.

3. Seçenek: Betiklerinizi Visual Studio Code uzantısıyla Azure PowerShell geçirme

Visual Studio Code için Azure PowerShell uzantısını Visual Studio Code

VSCode Azure PowerShell dosya uzantısını yükleme

Betiklerinizi el ile dönüştürme

  1. VSCode'da AzureRM betiğinizi yükleme
  2. Komut paletini açarak geçişi Ctrl+Shift+P başlatma ve Migrate Azure PowerShell script
  3. Kaynak sürümü seçin AzureRM
  4. Altı çizili komut veya parametreler için önerilen eylemleri izleyin.

Sonraki adımlar