Azure Sanal Masaüstü'nden otomatik olarak geçirme (klasik)

Geçiş modülü aracı, kuruluşunuzu Azure Sanal Masaüstü'nden (klasik) Azure Sanal Masaüstü'ne otomatik olarak geçirmenizi sağlar. Bu makalede aracın nasıl kullanılacağı gösterilir.

Önkoşullar

Geçiş modülünü kullanmadan önce aşağıdakilerin hazır olduğundan emin olun:

  • Yeni Azure hizmet nesneleri oluşturacağınız bir Azure aboneliği.

  • Aboneliğinizde Azure nesneleri oluşturmak için Katkıda Bulunan rolüne ve uygulama gruplarına kullanıcı atamak için Kullanıcı Erişim Yöneticisi rolüne atanmış olmanız gerekir.

  • Bir RDS kiracısı veya geçirmekte olduğunuz belirli konak havuzlarında en azından Uzak Masaüstü Hizmetleri (RDS) Katkıda Bulunanı izinleri.

  • Microsoft.RdInfra.RDPowershell PowerShell modülünün en son sürümü.

  • Az.DesktopVirtualization PowerShell modülünün en son sürümü.

  • Az.Resources PowerShell modülünün en son sürümü.

  • Geçiş modülünü bilgisayarınıza yükleyin.

  • Bu makalede göreceğiniz betikleri çalıştırmak için PowerShell veya PowerShell ISE. Microsoft.RdInfra.RDPowershell modülü PowerShell Core'da çalışmaz.

Önemli

Geçiş yalnızca ABD coğrafyasında hizmet nesneleri oluşturur. Hizmet nesnelerinizi başka bir coğrafyaya geçirmeye çalışırsanız çalışmaz. Ayrıca, Azure Sanal Masaüstü (klasik) dağıtımınızda 500'den fazla uygulama grubunuz varsa geçiş yapamazsınız. Yalnızca Microsoft Entra kiracınızdaki uygulama gruplarının sayısını azaltmak için ortamınızı yeniden derlerseniz geçirebilirsiniz.

PowerShell ortamınızı hazırlama

İlk olarak, PowerShell ortamınızı geçiş işlemi için hazırlamanız gerekir.

PowerShell ortamınızı hazırlamak için:

  1. Başlamadan önce, aşağıdaki cmdlet'leri çalıştırarak Az.Desktop Virtualization ve Az.Resources modüllerinin en son sürümüne sahip olduğunuzdan emin olun:

    Get-Module Az.Resources
Get-Module Az.DesktopVirtualization
https://www.powershellgallery.com/packages/Az.DesktopVirtualization/
https://www.powershellgallery.com/packages/Az.Resources/

    Bunu yapmazsanız, şu cmdlet'leri çalıştırarak modülleri yüklemeniz ve içeri aktarmanız gerekir:

    Install-module Az.Resources
Import-module Az.Resources
Install-module Az.DesktopVirtualization
Import-module Az.DesktopVirtualization

  2. Ardından, şu cmdlet'i çalıştırarak geçerli RDInfra PowerShell modülünü kaldırın:

    Uninstall-Module -Name Microsoft.RDInfra.RDPowershell -AllVersions

  3. Bundan sonra RDPowershell modülünü şu cmdlet ile yükleyin:

    Install-Module -Name Microsoft.RDInfra.RDPowershell -RequiredVersion 1.0.3414.0 -force
Import-module Microsoft.RDInfra.RDPowershell

  4. Her şeyi yüklemeyi tamamladıktan sonra modüllerin doğru sürümlerine sahip olduğunuzdan emin olmak için bu cmdlet'i çalıştırın:

    Get-Module Microsoft.RDInfra.RDPowershell

  5. Şimdi şu cmdlet'leri çalıştırarak geçiş modülünü yükleyip içeri aktaralım:

    Install-Module -Name PackageManagement -Repository PSGallery -Force
Install-Module -Name PowerShellGet -Repository PSGallery -Force
# Then restart shell
Install-Module -Name Microsoft.RdInfra.RDPowershell.Migration -AllowClobber
Import-Module <Full path to the location of the migration module>\Microsoft.RdInfra.RDPowershell.Migration.psd1

  6. İşiniz bittiğinde PowerShell pencerenizde Azure Sanal Masaüstü'nde (klasik) oturum açın:

    Add-RdsAccount -DeploymentUrl https://rdbroker.wvd.microsoft.com

  7. Azure Resource Manager oturum açın:

    Login-AzAccount

  8. Birden çok aboneliğiniz varsa, bu cmdlet ile kaynaklarınızı geçirmek istediğiniz aboneliği seçin:

    Select-AzSubscription -Subscriptionid <subID>

  9. Seçilen abonelik için Kaynak Sağlayıcısını Azure portal kaydedin.

  10. Son olarak sağlayıcıyı kaydetmeniz gerekir. Bunu iki şekilde yapabilirsiniz:

    • PowerShell kullanmak istiyorsanız şu cmdlet'i çalıştırın:

      Register-AzResourceProvider -ProviderNamespace Microsoft.DesktopVirtualization

    • Azure portal kullanmayı tercih ederseniz, Azure portal açın ve oturum açın, ardından Abonelikler'e gidin ve kullanmak istediğiniz aboneliğin adını seçin. Bundan sonraMicrosoft.DesktopVirtualizationKaynak Sağlayıcısı'na> gidin ve Yeniden kaydet'i seçin. Kullanıcı arabiriminde henüz hiçbir değişiklik görmezsiniz, ancak PowerShell ortamınız artık modülü çalıştırmaya hazır olmalıdır.

Azure Sanal Masaüstü (klasik) kaynaklarını Azure Resource Manager'a geçirme

Artık PowerShell ortamınız hazır olduğuna göre geçiş işlemine başlayabilirsiniz.

Azure sanal Masaüstü (klasik) kaynaklarınızı Azure Resource Manager geçirmek için:

  1. Geçiş yapmadan önce, mevcut Klasik kaynakların yeni Azure Resource Manager kaynaklarıyla nasıl eşleneceğini anlamak istiyorsanız şu cmdlet'i çalıştırın:

    Get-RdsHostPoolMigrationMapping

    Get-RdsHostPoolMigrationMapping ile kaynaklarınızın gideceği yeri eşleyen bir CSV dosyası oluşturabilirsiniz. Örneğin, kiracınızın adı "Contoso" ise ve eşleme dosyanızı "contosouser" dosyasında depolamak istiyorsanız, şuna benzer bir cmdlet çalıştırırsınız:

    Get-RdsHostPoolMigrationMapping -Tenant Contoso -HostPool Office -Location EastUS -OutputFile 'C:\\Users\contosouser\OneDrive - Microsoft\Desktop\mapping.csv'

  2. Ardından Start-RdsHostPoolMigration cmdlet'ini çalıştırarak tek bir konak havuzunun mu yoksa kiracı içindeki tüm konak havuzlarının mı geçirileceğini seçin.

    Örneğin:

    Start-RdsHostPoolMigration -Tenant Contoso -Location WestUS

    Kaynaklarınızı belirli bir konak havuzuna geçirmek istiyorsanız konak havuzu adını ekleyin. Örneğin, "Office" adlı konak havuzunu taşımak istiyorsanız aşağıdaki gibi bir komut çalıştırın:

    Start-RdsHostPoolMigration -Tenant Contoso -HostPool Office -CopyUserAssignments $false -Location EastUS

    Çalışma alanı adı vermezseniz modül, kiracı adına göre sizin için otomatik olarak bir ad oluşturur. Ancak, belirli bir çalışma alanını kullanmayı tercih ederseniz kaynak kimliğini şu şekilde girebilirsiniz:

    Start-RdsHostPoolMigration -Tenant Contoso -HostPool Office -CopyUserAssignments -Location EastUS -Workspace <Resource ID of workspacename>

    Belirli bir çalışma alanını kullanmak istiyorsanız ancak kaynak kimliğini bilmiyorsanız şu cmdlet'i çalıştırın:

    Get-AzWvdWorkspace -WorkspaceName <workspace> -ResourceGroupName <resource group> |fl

    Ayrıca mevcut kullanıcı atamaları için bir kullanıcı atama modu belirtmeniz gerekir:

    • Eski uygulama gruplarınızdaki tüm kullanıcı atamalarını Azure Resource Manager uygulama gruplarına kopyalamak için Kopyala'yı kullanın. Kullanıcılar, istemcilerinin her iki sürümü için de akışları görebilir.
    • Kullanıcı atamalarını değiştirmek istemiyorsanız Hiçbiri'ni kullanın. Daha sonra Azure portal, PowerShell veya API ile uygulama gruplarına kullanıcı veya kullanıcı grupları atayabilirsiniz. Kullanıcılar yalnızca Azure Sanal Masaüstü (klasik) istemcilerini kullanarak akışları görebilir.

    Abonelik başına yalnızca 2.000 kullanıcı ataması kopyalayabilirsiniz, bu nedenle sınırınız aboneliğinizde zaten kaç atama olduğuna bağlıdır. Modül, zaten sahip olduğunuz atama sayısını temel alarak sınırı hesaplar. Kopyalamak için yeterli atamanız yoksa şu hata iletisini alırsınız: "Kullanıcı atamalarını kopyalamak için rol ataması kotası yetersiz. -CopyUserAssignments geçişi olmadan komutu yeniden çalıştırın."

  3. Komutları çalıştırdıktan sonra modülün hizmet nesnelerini oluşturması 15 dakika kadar sürer. Kullanıcı atamalarını kopyaladıysanız veya taşıdıysanız bu, modülün her şeyi ayarlamayı tamamlaması için gereken süreyi ekler.

    Start-RdsHostPoolMigration cmdlet'i tamamlandıktan sonra aşağıdaki işlemleri görmeniz gerekir:

    • Belirttiğiniz kiracı veya konak havuzu için Azure hizmet nesneleri.

    • İki yeni kaynak grubu:

      • Çalışma alanınızı içeren "Tenantname" adlı bir kaynak grubu.

      • Konak havuzunu ve masaüstü uygulama gruplarını içeren "Tenantname_originalHostPoolName" adlı bir kaynak grubu.

    • Yeni oluşturulan uygulama gruplarında yayımladığınız tüm kullanıcılar.

    • Geçiş işlemi sırasında kullanıcının kapalı kalma süresini önlemek için sanal makineler hem mevcut hem de yeni konak havuzlarında kullanılabilir. Bu, kullanıcıların aynı kullanıcı oturumuna bağlanmasını sağlar.

    Bu yeni Azure hizmet nesneleri Azure Resource Manager nesneleri olduğundan modül, bunlar üzerinde Rol tabanlı Access Control (RBAC) izinlerini veya tanılama ayarlarını ayarlayamaz. Bu nedenle, bu nesneler için RBAC izinlerini ve ayarlarını el ile güncelleştirmeniz gerekir.

    Modül ilk kullanıcı bağlantılarını doğruladıktan sonra, isterseniz uygulama grubunu daha fazla kullanıcıya veya kullanıcı grubuna yayımlayabilirsiniz.

    Not

    Geçiş sonrasında, kullanıcılara izin atadıktan sonra uygulama gruplarını farklı bir kaynak grubuna taşırsanız, tüm RBAC rolleri kaldırılır. Kullanıcıların RBAC izinlerini yeniden atamanız gerekir.

  4. Tüm Azure Sanal Masaüstü (klasik) hizmet nesnelerini silmek istiyorsanız, geçiş işlemini tamamlamak için Complete-RdsHostPoolMigration komutunu çalıştırın. Bu cmdlet tüm Azure Sanal Masaüstü (klasik) nesnelerini silip yalnızca yeni Azure nesnelerini bırakır. Kullanıcılar yalnızca istemcilerinde yeni oluşturulan uygulama gruplarının akışını görebilir. Bu komut tamamlandıktan sonra, işlemi tamamlamak için Azure Sanal Masaüstü (klasik) kiracısını güvenle silebilirsiniz.

    Örneğin:

    Complete-RdsHostPoolMigration -Tenant Contoso -Location EastUS

    Belirli bir konak havuzunu tamamlamak istiyorsanız, konak havuzu adını cmdlet'ine ekleyebilirsiniz. Örneğin, "Office" adlı bir konak havuzunu tamamlamak istiyorsanız aşağıdaki gibi bir komut kullanırsınız:

    Complete-RdsHostPoolMigration -Tenant Contoso -HostPool Office -Location EastUS

    Bu işlem, Azure Sanal Masaüstü (klasik) tarafından oluşturulan tüm hizmet nesnelerini siler. Yalnızca yeni Azure nesneleriyle kalırsınız ve kullanıcılar yalnızca istemcilerinde yeni oluşturulan uygulama gruplarının akışını görebilir. Geçişinizi tamamladıktan sonra Azure Sanal Masaüstü'nde (klasik) kiracıyı açıkça silmeniz gerekir.

  5. Geçiş konusunda fikrinizi değiştirdiyseniz ve işlemi geri almak istiyorsanız Revert-RdsHostPoolMigration cmdlet'ini çalıştırın.

    Örneğin:

    Revert-RdsHostPoolMigration -Tenant Contoso -Location EastUS

    Belirli bir konak havuzunu geri döndürmek isterseniz, komuta konak havuzu adını ekleyebilirsiniz. Örneğin, "Office" adlı bir konak havuzunu geri almak istiyorsanız, aşağıdakine benzer bir şey girersiniz:

    Revert-RdsHostPoolMigration -Tenant Contoso -HostPool Office -Location EastUS

    Bu cmdlet, yeni oluşturulan tüm Azure hizmet nesnelerini siler. Kullanıcılarınız yalnızca istemcilerindeki Azure Sanal Masaüstü (klasik) nesnelerinin akışını görür.

    Ancak, cmdlet modülün oluşturduğu çalışma alanını veya ilişkili kaynak grubunu silmez. Bu öğelerden kurtulmak için bu öğeleri el ile silmeniz gerekir.

  6. Azure Sanal Masaüstü (klasik) hizmet nesnelerinizi henüz silmek istemiyorsanız ancak geçişi test etmek istiyorsanız Set-RdsHostPoolHidden komutunu çalıştırabilirsiniz.

    Örneğin:

    Set-RdsHostPoolHidden -Tenant Contoso -Hostpool Office -Hidden $true -Location WestUS

    Durum "true" olarak ayarlandığında Azure Sanal Masaüstü (klasik) kaynakları gizlenir. Bunu "false" olarak ayarlamak, kaynakları kullanıcılarınıza gösterir.

    -Hostpool parametresi isteğe bağlıdır. Gizlemek istediğiniz belirli bir Azure Sanal Masaüstü (klasik) konak havuzu varsa bu parametreyi kullanabilirsiniz.

    Bu cmdlet, Azure Sanal Masaüstü (klasik) kullanıcı akışını ve hizmet nesnelerini silmek yerine gizler. Ancak, bu genellikle yalnızca test için kullanılır ve tamamlanmış bir geçiş olarak sayılmaz. Geçişinizi tamamlamak için Complete-RdsHostPoolMigration komutunu çalıştırmanız gerekir. Aksi takdirde Revert-RdsHostPoolMigration komutunu çalıştırarak dağıtımınızı geri alın.

Otomatik geçiş sorunlarını giderme

Bu bölümde, geçiş modülünde sık karşılaşılan sorunların nasıl çözüldüğü açıklanır.

Kiracıya erişemiyorum

İlk olarak şu iki şeyi deneyin:

  • Yönetici hesabınızın kiracıya erişmek için gerekli izinlere sahip olduğundan emin olun.
  • Kiracıda Get-RdsTenant çalıştırmayı deneyin.

Bu iki şey işe yaradıysa, geçişiniz için RDS Bağlamını ve ADAL Bağlamını ayarlamak için Set-RdsMigrationContext cmdlet'ini çalıştırmayı deneyin:

  1. Add-RdsAccount cmdlet'ini çalıştırarak RDS Bağlamı'nı oluşturun.

  2. $rdMgmtContext genel değişkeninde RDS Bağlamı'nı bulun.

  3. $AdalContext genel değişkeninde ADAL Bağlamı'nı bulun.

  4. Set-RdsMigrationContext komutunu şu biçimde bulduğunuz değişkenlerle çalıştırın:

    Set-RdsMigrationContext -RdsContext <rdscontext> -AdalContext <adalcontext>

Sonraki adımlar

Bunun yerine dağıtımınızı el ile geçirmeyi öğrenmek isterseniz bkz. Azure Sanal Masaüstü'nden (klasik) el ile geçirme.

Geçiş yaptıktan sonra öğreticilerimizi gözden geçirerek Azure Sanal Masaüstü'nü nasıl çalıştığını öğrenin. Mevcut bir konak havuzunu genişletme ve RDP özelliklerini özelleştirme bölümünde gelişmiş yönetim özellikleri hakkında bilgi edinin.

Hizmet nesneleri hakkında daha fazla bilgi edinmek için Azure Sanal Masaüstü ortamına göz atın.

  • Last updated on