Migrera automatiskt från Azure Virtual Desktop (klassisk)

Viktigt

Azure Virtual Desktop Classic dras tillbaka 30 september 2026. Anslutningar till klassiska resurser blockeras efter tillbakadragandet.

För att förhindra avbrott migrerar du återstående klassiska resurser till Azure Resource Manager-baserade värdpooler före den 30 september 2026.

Med verktyget för migreringsmodul kan du automatiskt migrera din organisation från Azure Virtual Desktop (klassisk) till Azure Virtual Desktop. I den här artikeln visar vi hur du använder verktyget.

Förhandskrav

Innan du använder migreringsmodulen ska du se till att du har följande saker redo:

En Azure-prenumeration där du skapar nya Azure-tjänstobjekt.
Du måste tilldelas rollen Deltagare för att skapa Azure-objekt i din prenumeration och rollen Administratör för användaråtkomst för att tilldela användare till programgrupper.
Minst behörigheterna för Fjärrskrivbordstjänst-deltagare för en RDS-klientorganisation eller de specifika värdpooler som du migrerar.
Den senaste versionen av PowerShell-modulen Microsoft.RdInfra.RDPowershell.
Den senaste versionen av PowerShell-modulen Az.DesktopVirtualization.
Den senaste versionen av PowerShell-modulen Az.Resources.
Installera migreringsmodulen på datorn.
PowerShell eller PowerShell ISE för att köra skripten som visas i den här artikeln. Modulen Microsoft.RdInfra.RDPowershell fungerar inte i PowerShell Core.

Viktigt

Migrering skapar endast tjänstobjekt i USA:s geografiska geografi. Om du försöker migrera dina tjänstobjekt till ett annat geografiskt område fungerar det inte. Om du har fler än 500 programgrupper i din Azure Virtual Desktop-distribution (klassisk) kan du inte migrera. Du kan bara migrera om du återskapar miljön för att minska antalet programgrupper i din Microsoft Entra klientorganisation.

Förbereda PowerShell-miljön

Först måste du förbereda PowerShell-miljön för migreringsprocessen.

Så här förbereder du PowerShell-miljön:

Innan du börjar kontrollerar du att du har den senaste versionen av modulerna Az.Desktop Virtualization och Az.Resources genom att köra följande cmdletar:

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

Om du inte har det måste du installera och importera modulerna genom att köra följande cmdletar:

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

Avinstallera sedan den aktuella RDInfra PowerShell-modulen genom att köra den här cmdleten:
```
Uninstall-Module -Name Microsoft.RDInfra.RDPowershell -AllVersions
```

Installera sedan RDPowershell-modulen med den här cmdleten:

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

När du har installerat allt kör du den här cmdleten för att kontrollera att du har rätt versioner av modulerna:
```
Get-Module Microsoft.RDInfra.RDPowershell
```

Nu ska vi installera och importera migreringsmodulen genom att köra följande cmdletar:

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

När du är klar loggar du in på Azure Virtual Desktop (klassisk) i PowerShell-fönstret:
```
Add-RdsAccount -DeploymentUrl https://rdbroker.wvd.microsoft.com
```
Logga in på Azure Resource Manager:
```
Login-AzAccount
```
Om du har flera prenumerationer väljer du den du vill migrera dina resurser till med den här cmdleten:
```
Select-AzSubscription -Subscriptionid <subID>
```
Registrera resursprovidern i Azure Portal för den valda prenumerationen.
Slutligen måste du registrera providern. Du kan göra det på två sätt:
- Om du vill använda PowerShell kör du den här cmdleten:
```
Register-AzResourceProvider -ProviderNamespace Microsoft.DesktopVirtualization
```
- Om du hellre vill använda Azure Portal öppnar och loggar du in på Azure Portal och går sedan till Prenumerationer och väljer namnet på den prenumeration som du vill använda. Därefter går du till Resursprovider>Microsoft.DesktopVirtualization och väljer Omregistrera. Du kommer inte att se någon ändring i användargränssnittet ännu, men din PowerShell-miljö bör nu vara redo att köra modulen.

Migrera Azure Virtual Desktop-resurser (klassisk) till Azure Resource Manager

Nu när PowerShell-miljön är klar kan du påbörja migreringsprocessen.

Så här migrerar du dina Azure Virtual Desktop-resurser (klassisk) till Azure Resource Manager:

Innan du migrerar kör du den här cmdleten om du vill förstå hur befintliga klassiska resurser mappas till nya Azure Resource Manager-resurser:
```
Get-RdsHostPoolMigrationMapping
```
Med Get-RdsHostPoolMigrationMapping kan du skapa en CSV-fil som mappar vart dina resurser ska hamna. Om klientorganisationen till exempel heter "Contoso" och du vill spara mappningsfilen i filen "contosouser" kör du en cmdlet som ser ut så här:
```
Get-RdsHostPoolMigrationMapping -Tenant Contoso -HostPool Office -Location EastUS -OutputFile 'C:\\Users\contosouser\OneDrive - Microsoft\Desktop\mapping.csv'
```
Kör sedan cmdleten Start-RdsHostPoolMigration för att välja om du vill migrera en enda värdpool eller alla värdpooler i en klientorganisation.

Till exempel:
```
Start-RdsHostPoolMigration -Tenant Contoso -Location WestUS
```
Om du vill migrera dina resurser till en specifik värdpool inkluderar du värdpoolens namn. Om du till exempel vill flytta värdpoolen med namnet "Office" kör du ett kommando så här:
```
Start-RdsHostPoolMigration -Tenant Contoso -HostPool Office -CopyUserAssignments $false -Location EastUS
```
Om du inte anger ett arbetsytenamn skapar modulen automatiskt ett åt dig baserat på klientnamnet. Men om du föredrar att använda en specifik arbetsyta kan du ange dess resurs-ID så här:
```
Start-RdsHostPoolMigration -Tenant Contoso -HostPool Office -CopyUserAssignments -Location EastUS -Workspace <Resource ID of workspacename>
```
Om du vill använda en specifik arbetsyta men inte känner till dess resurs-ID kör du den här cmdleten:
```
Get-AzWvdWorkspace -WorkspaceName <workspace> -ResourceGroupName <resource group> |fl
```
Du måste också ange ett användartilldelningsläge för de befintliga användartilldelningarna:
- Använd Kopiera för att kopiera alla användartilldelningar från dina gamla programgrupper till Azure Resource Manager programgrupper. Användarna kan se feeds för båda versionerna av sina klienter.
- Använd Ingen om du inte vill ändra användartilldelningarna. Senare kan du tilldela användare eller användargrupper till programgrupper med Azure Portal, PowerShell eller API. Användarna kan bara se feeds med hjälp av Azure Virtual Desktop-klienterna (klassisk).
Du kan bara kopiera 2 000 användartilldelningar per prenumeration, så din gräns beror på hur många tilldelningar som redan finns i din prenumeration. Modulen beräknar gränsen utifrån hur många uppgifter du redan har. Om du inte har tillräckligt med tilldelningar att kopiera visas ett felmeddelande om att det inte finns tillräcklig kvot för rolltilldelning för att kopiera användartilldelningar. Kör kommandot igen utan växeln -CopyUserAssignments för att migrera."
När du har kört kommandona tar det upp till 15 minuter för modulen att skapa tjänstobjekten. Om du har kopierat eller flyttat användaruppgifter kommer det att öka den tid det tar för modulen att slutföra konfigurationen.

När cmdleten Start-RdsHostPoolMigration är klar bör du se följande:
- Azure-tjänstobjekt för den klientorganisation eller värdpool som du har angett.
- Två nya resursgrupper:
  - En resursgrupp med namnet "Klientorganisationsnamn", som innehåller din arbetsyta.
  - En resursgrupp med namnet "Tenantname_originalHostPoolName", som innehåller värdpoolen och skrivbordsprogramgrupperna.
- Alla användare som du publicerat till de nyligen skapade programgrupperna.
- Virtuella datorer kommer att finnas tillgängliga i både befintliga och nya värdpooler för att undvika användaravbrott under migreringsprocessen. På så sätt kan användare ansluta till samma användarsession.
Eftersom dessa nya Azure-tjänstobjekt är Azure Resource Manager-objekt kan modulen inte ange behörigheter för rollbaserad åtkomstkontroll (RBAC) eller diagnostikinställningar för dem. Därför måste du uppdatera RBAC-behörigheterna och inställningarna för dessa objekt manuellt.

När modulen har validerat de första användaranslutningarna kan du även publicera programgruppen till fler användare eller användargrupper om du vill.

Obs!

Om du efter migreringen flyttar programgrupper till en annan resursgrupp efter att du har tilldelat behörigheter till användare tas alla RBAC-roller bort. Du måste tilldela om användarnas RBAC-behörigheter igen.
Om du vill ta bort alla Azure Virtual Desktop-tjänstobjekt (klassisk) kör du Complete-RdsHostPoolMigration för att slutföra migreringsprocessen. Den här cmdleten tar bort alla Azure Virtual Desktop-objekt (klassisk) och lämnar endast de nya Azure-objekten kvar. Användarna kan bara se feeden för de nyligen skapade programgrupperna på sina klienter. När det här kommandot är klart kan du på ett säkert sätt ta bort Azure Virtual Desktop-klientorganisationen (klassisk) för att slutföra processen.

Till exempel:
```
Complete-RdsHostPoolMigration -Tenant Contoso -Location EastUS
```
Om du vill slutföra en specifik värdpool kan du inkludera värdpoolens namn i cmdleten. Om du till exempel vill slutföra en värdpool med namnet "Office" använder du ett kommando som följande:
```
Complete-RdsHostPoolMigration -Tenant Contoso -HostPool Office -Location EastUS
```
Detta tar bort alla tjänstobjekt som skapats av Azure Virtual Desktop (klassisk). Du får bara de nya Azure-objekten och användarna kan bara se feeden för de nyligen skapade programgrupperna på sina klienter. När du är klar med migreringen måste du uttryckligen ta bort klientorganisationen i Azure Virtual Desktop (klassisk).
Om du har ändrat dig om migreringen och vill återställa processen kör du cmdleten Revert-RdsHostPoolMigration .

Till exempel:
```
Revert-RdsHostPoolMigration -Tenant Contoso -Location EastUS
```
Om du vill återställa en specifik värdpool kan du inkludera värdpoolens namn i kommandot. Om du till exempel vill återställa en värdpool med namnet "Office" anger du något i stil med följande:
```
Revert-RdsHostPoolMigration -Tenant Contoso -HostPool Office -Location EastUS
```
Den här cmdleten tar bort alla nyligen skapade Azure-tjänstobjekt. Användarna ser bara feeden för Azure Virtual Desktop-objekt (klassisk) i sina klienter.

Cmdleten tar dock inte bort arbetsytan som modulen skapade eller dess associerade resursgrupp. Du måste ta bort de objekten manuellt för att bli av med dem.
Om du inte vill ta bort dina Azure Virtual Desktop-tjänstobjekt (klassisk) ännu men vill testa migreringen kan du köra Set-RdsHostPoolHidden.

Till exempel:
```
Set-RdsHostPoolHidden -Tenant Contoso -Hostpool Office -Hidden $true -Location WestUS
```
Om du anger statusen "true" döljs Azure Virtual Desktop-resurserna (klassisk). Om du anger "falskt" visas resurserna för användarna.

Parametern -Hostpool är valfri. Du kan använda den här parametern om det finns en specifik Azure Virtual Desktop (klassisk) värdpool som du vill dölja.

Den här cmdleten döljer Azure Virtual Desktop (klassisk) användarfeed och tjänstobjekt i stället för att ta bort dem. Detta används dock vanligtvis endast för testning och räknas inte som en slutförd migrering. För att slutföra migreringen måste du köra kommandot Complete-RdsHostPoolMigration . Annars återställer du distributionen genom att köra Revert-RdsHostPoolMigration.

Felsöka automatisk migrering

Det här avsnittet beskriver hur du löser vanliga problem i migreringsmodulen.

Jag kan inte komma åt klientorganisationen

Prova först de här två sakerna:

Kontrollera att ditt administratörskonto har de behörigheter som krävs för att få åtkomst till klientorganisationen.
Prova att köra Get-RdsTenant på klientorganisationen.

Om de två sakerna fungerar kan du prova att köra cmdleten Set-RdsMigrationContext för att ange RDS-kontext och ADAL-kontext för migreringen:

Skapa RDS-kontexten genom att köra cmdleten Add-RdsAccount .
Hitta RDS-kontexten i den globala variabeln $rdMgmtContext.
Hitta ADAL-kontexten i den globala variabeln $AdalContext.
Kör Set-RdsMigrationContext med de variabler som du hittade i det här formatet:
```
Set-RdsMigrationContext -RdsContext <rdscontext> -AdalContext <adalcontext>
```

Nästa steg

Om du vill lära dig hur du migrerar distributionen manuellt i stället kan du läsa Migrera manuellt från Azure Virtual Desktop (klassisk).

När du har migrerat kan du lära dig hur Azure Virtual Desktop fungerar genom att ta en titt på våra självstudier. Läs mer om avancerade hanteringsfunktioner i Expandera en befintlig värdpool och Anpassa RDP-egenskaper.

Mer information om tjänstobjekt finns i Azure Virtual Desktop-miljön.

Feedback

Var den här sidan till hjälp?

Last updated on 2026-09-18