Migrowanie automatycznie z usługi Azure Virtual Desktop (klasycznej)

Ważna

Usługa Azure Virtual Desktop classic zostanie wycofana 30 września 2026 r. Połączenia z zasobami klasycznymi zostaną zablokowane po wycofaniu.

Aby zapobiec zakłóceniom, zmigruj pozostałe zasoby klasyczne do pul hostów opartych na Azure Resource Manager przed 30 września 2026 r.

Narzędzie modułu migracji umożliwia automatyczną migrację organizacji z usługi Azure Virtual Desktop (klasycznej) do usługi Azure Virtual Desktop. W tym artykule przedstawiono sposób korzystania z tego narzędzia.

Wymagania wstępne

Przed użyciem modułu migracji przygotuj następujące elementy:

Subskrypcja platformy Azure, w której tworzysz nowe obiekty usługi platformy Azure.
Aby tworzyć obiekty platformy Azure w ramach subskrypcji, musisz mieć przypisaną rolę współautora, a aby przypisywać użytkowników do grup aplikacji, musisz mieć rolę administratora dostępu użytkownika.
Co najmniej uprawnienia współautora usług pulpitu zdalnego (RDS) dla dzierżawy usług pulpitu zdalnego lub określonych pul hostów, które są migrowane.
Najnowsza wersja modułu programu PowerShell Microsoft.RdInfra.RDPowershell.
Najnowsza wersja modułu programu PowerShell Az.DesktopVirtualization.
Najnowsza wersja modułu programu PowerShell Az.Resources.
Zainstaluj moduł migracji na komputerze.
Program PowerShell lub środowisko PowerShell ISE, aby uruchamiać skrypty opisane w tym artykule. Moduł Microsoft.RdInfra.RDPowershell nie działa w programie PowerShell Core.

Ważna

W ramach migracji obiekty usługi są tworzone tylko w obszarze geograficznym Stanów Zjednoczonych. Jeśli spróbujesz przeprowadzić migrację obiektów usługi do innej lokalizacji geograficznej, operacja nie zadziała. Ponadto, jeśli masz więcej niż 500 grup aplikacji we wdrożeniu usługi Azure Virtual Desktop (klasycznym), nie będzie można migrować. Migrację będzie można przeprowadzić tylko wtedy, gdy ponownie skompilujesz środowisko w celu zmniejszenia liczby grup aplikacji w dzierżawie usługi Microsoft Entra.

Przygotowywanie środowiska programu PowerShell

Najpierw musisz przygotować środowisko programu PowerShell do procesu migracji.

Aby przygotować środowisko programu PowerShell:

Przed rozpoczęciem upewnij się, że masz najnowszą wersję modułów Az.Desktop Virtualization i Az.Resources, uruchamiając następujące polecenia cmdlet:

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

Jeśli tego nie zrobisz, musisz zainstalować i zaimportować moduły, uruchamiając następujące polecenia cmdlet:

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

Następnie odinstaluj bieżący moduł RDInfra PowerShell, uruchamiając następujące polecenie cmdlet:
```
Uninstall-Module -Name Microsoft.RDInfra.RDPowershell -AllVersions
```

Następnie zainstaluj moduł RDPowershell za pomocą tego polecenia cmdlet:

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

Po zakończeniu instalacji uruchom to polecenie cmdlet, aby upewnić się, że masz odpowiednie wersje modułów:
```
Get-Module Microsoft.RDInfra.RDPowershell
```

Teraz zainstalujemy i zaimportujemy moduł migracji, uruchamiając następujące polecenia cmdlet:

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

Po zakończeniu zaloguj się do usługi Azure Virtual Desktop (klasycznej) w oknie programu PowerShell:
```
Add-RdsAccount -DeploymentUrl https://rdbroker.wvd.microsoft.com
```
Zaloguj się do Azure Resource Manager:
```
Login-AzAccount
```
Jeśli masz wiele subskrypcji, wybierz subskrypcję, do której chcesz przeprowadzić migrację zasobów, za pomocą tego polecenia cmdlet:
```
Select-AzSubscription -Subscriptionid <subID>
```
Zarejestruj dostawcę zasobów w usłudze Azure Portal dla wybranej subskrypcji.
Na koniec musisz zarejestrować dostawcę. Można to zrobić na dwa sposoby:
- Jeśli chcesz użyć programu PowerShell, uruchom następujące polecenie cmdlet:
```
Register-AzResourceProvider -ProviderNamespace Microsoft.DesktopVirtualization
```
- Jeśli wolisz korzystać z witryny Azure Portal, otwórz witrynę Azure Portal i zaloguj się do niej, a następnie przejdź na stronę Subskrypcje i wybierz nazwę subskrypcji, której chcesz użyć. Następnie przejdź do dostawcy> zasobówMicrosoft.DesktopVirtualization i wybierz pozycję Zarejestruj ponownie. W interfejsie użytkownika nie widać jeszcze żadnych zmian, ale środowisko programu PowerShell powinno być teraz gotowe do uruchomienia modułu.

Migrowanie zasobów usługi Azure Virtual Desktop (klasycznej) do Azure Resource Manager

Teraz, gdy środowisko programu PowerShell jest gotowe, możesz rozpocząć proces migracji.

Aby przeprowadzić migrację zasobów pulpitu wirtualnego (klasycznego) Azure do Azure Resource Manager:

Jeśli chcesz zrozumieć, w jaki sposób istniejące zasoby klasyczne zostaną zamapowane na nowe zasoby Azure Resource Manager, uruchom następujące polecenie cmdlet:
```
Get-RdsHostPoolMigrationMapping
```
Za pomocą polecenia Get-RdsHostPoolMigrationMapping można utworzyć plik CSV mapujący miejsce, w którym zostaną przeniesione zasoby. Jeśli na przykład dzierżawa nazywa się "Contoso" i chcesz przechowywać plik mapowania w pliku "contosouser", uruchom następujące polecenie cmdlet:
```
Get-RdsHostPoolMigrationMapping -Tenant Contoso -HostPool Office -Location EastUS -OutputFile 'C:\\Users\contosouser\OneDrive - Microsoft\Desktop\mapping.csv'
```
Następnie uruchom polecenie cmdlet Start-RdsHostPoolMigration , aby określić, czy migrować pojedynczą pulę hostów, czy wszystkie pule hostów w dzierżawie.

Przykład:
```
Start-RdsHostPoolMigration -Tenant Contoso -Location WestUS
```
Jeśli chcesz przeprowadzić migrację zasobów do określonej puli hostów, dołącz nazwę puli hostów. Jeśli na przykład chcesz przenieść pulę hostów o nazwie "Office", uruchom następujące polecenie:
```
Start-RdsHostPoolMigration -Tenant Contoso -HostPool Office -CopyUserAssignments $false -Location EastUS
```
Jeśli nie podasz nazwy obszaru roboczego, moduł automatycznie utworzy ją dla Ciebie na podstawie nazwy dzierżawy. Jeśli jednak wolisz używać określonego obszaru roboczego, możesz wprowadzić jego identyfikator zasobu w następujący sposób:
```
Start-RdsHostPoolMigration -Tenant Contoso -HostPool Office -CopyUserAssignments -Location EastUS -Workspace <Resource ID of workspacename>
```
Jeśli chcesz użyć określonego obszaru roboczego, ale nie znasz jego identyfikatora zasobu, uruchom następujące polecenie cmdlet:
```
Get-AzWvdWorkspace -WorkspaceName <workspace> -ResourceGroupName <resource group> |fl
```
Musisz także określić tryb przypisywania użytkowników dla istniejących przypisań użytkowników:
- Użyj polecenia Kopiuj , aby skopiować wszystkie przypisania użytkowników ze starych grup aplikacji do Azure Resource Manager grup aplikacji. Użytkownicy będą mogli wyświetlać kanały informacyjne dla obu wersji swoich klientów.
- Użyj opcji Brak , jeśli nie chcesz zmieniać przypisań użytkowników. Później można przypisać użytkowników lub grupy użytkowników do grup aplikacji za pomocą usługi Azure Portal, programu PowerShell lub interfejsu API. Użytkownicy będą mogli wyświetlać kanały informacyjne tylko przy użyciu klientów usługi Azure Virtual Desktop (klasycznej).
W ramach jednej subskrypcji można skopiować maksymalnie 2000 przypisań użytkowników, więc limit będzie zależał od liczby przypisań już przypisanych w subskrypcji. Moduł oblicza limit na podstawie liczby zadań, które już masz. Jeśli nie masz wystarczającej liczby przypisań do skopiowania, zostanie wyświetlony komunikat o błędzie o treści "Niewystarczający limit przydziału przypisań ról do kopiowania przypisań użytkowników. Uruchom ponownie polecenie bez przełącznika -CopyUserAssignments w celu migracji".
Po uruchomieniu poleceń utworzenie obiektów usługi przez moduł może potrwać do 15 minut. Jeśli skopiowano lub przeniesiono jakiekolwiek przypisania użytkowników, spowoduje to wydłużenie czasu potrzebnego na ukończenie konfiguracji modułu.

Po wykonaniu polecenia cmdlet Start-RdsHostPoolMigration powinny zostać wyświetlone następujące informacje:
- Obiekty usługi platformy Azure dla określonej dzierżawy lub puli hostów.
- Dwie nowe grupy zasobów:
  - Grupa zasobów o nazwie "Nazwa dzierżawy", która zawiera obszar roboczy.
  - Grupa zasobów o nazwie "Tenantname_originalHostPoolName", która zawiera pulę hostów i grupy aplikacji klasycznych.
- Wszyscy użytkownicy, którzy zostali opublikowani w nowo utworzonych grupach aplikacji.
- Maszyny wirtualne będą dostępne zarówno w istniejącej, jak i nowej puli hostów, aby uniknąć przestojów użytkowników podczas procesu migracji. Dzięki temu użytkownicy mogą połączyć się z tą samą sesją użytkownika.
Ponieważ te nowe obiekty usługi Azure są obiektami Azure Resource Manager, moduł nie może ustawiać dla nich uprawnień Access Control opartych na rolach (RBAC) ani ustawień diagnostycznych. W związku z tym należy ręcznie zaktualizować uprawnienia i ustawienia RBAC dla tych obiektów.

Gdy moduł zweryfikuje początkowe połączenia użytkowników, możesz również opublikować grupę aplikacji dla większej liczby użytkowników lub grup użytkowników, jeśli chcesz.

Uwaga

Jeśli po migracji przeniesiesz grupy aplikacji do innej grupy zasobów po przypisaniu uprawnień do użytkowników, wszystkie role RBAC zostaną usunięte. Konieczne będzie ponowne przypisanie użytkownikom uprawnień RBAC.
Jeśli chcesz usunąć wszystkie obiekty usługi Azure Virtual Desktop (klasyczne), uruchom polecenie Complete-RdsHostPoolMigration, aby zakończyć proces migracji. To polecenie cmdlet usunie wszystkie obiekty usługi Azure Virtual Desktop (klasyczne), pozostawiając tylko nowe obiekty platformy Azure. Użytkownicy będą mogli wyświetlać kanał informacyjny tylko dla nowo utworzonych grup aplikacji na swoich klientach. Po wykonaniu tego polecenia możesz bezpiecznie usunąć dzierżawę usługi Azure Virtual Desktop (klasyczną), aby ukończyć proces.

Przykład:
```
Complete-RdsHostPoolMigration -Tenant Contoso -Location EastUS
```
Jeśli chcesz ukończyć tworzenie określonej puli hostów, możesz umieścić nazwę puli hostów w poleceniu cmdlet. Jeśli na przykład chcesz ukończyć pulę hostów o nazwie "Office", użyj następującego polecenia:
```
Complete-RdsHostPoolMigration -Tenant Contoso -HostPool Office -Location EastUS
```
Spowoduje to usunięcie wszystkich obiektów usługi utworzonych przez usługę Azure Virtual Desktop (klasyczną). Pozostaną tylko nowe obiekty platformy Azure, a użytkownicy będą mogli zobaczyć tylko źródło danych dla nowo utworzonych grup aplikacji na swoich klientach. Po zakończeniu finalizowania migracji należy jawnie usunąć dzierżawę w usłudze Azure Virtual Desktop (klasycznej).
Jeśli zmienisz zdanie na temat migrowania i zechcesz cofnąć proces, uruchom polecenie cmdlet Revert-RdsHostPoolMigration .

Przykład:
```
Revert-RdsHostPoolMigration -Tenant Contoso -Location EastUS
```
Jeśli chcesz przywrócić określoną pulę hostów, możesz dołączyć nazwę puli hostów do polecenia. Jeśli na przykład chcesz przywrócić pulę hostów o nazwie "Office", wprowadź następującą formułę:
```
Revert-RdsHostPoolMigration -Tenant Contoso -HostPool Office -Location EastUS
```
To polecenie cmdlet usunie wszystkie nowo utworzone obiekty usługi platformy Azure. Użytkownicy będą widzieć tylko kanał informacyjny dla obiektów usługi Azure Virtual Desktop (klasycznej) w swoich klientach.

Polecenie cmdlet nie spowoduje jednak usunięcia obszaru roboczego utworzonego przez moduł ani skojarzonej z nim grupy zasobów. Aby się ich pozbyć, musisz ręcznie usunąć te elementy.
Jeśli nie chcesz jeszcze usuwać obiektów usługi klasycznej usługi Azure Virtual Desktop, ale chcesz przetestować migrację, możesz uruchomić polecenie Set-RdsHostPoolHidden.

Przykład:
```
Set-RdsHostPoolHidden -Tenant Contoso -Hostpool Office -Hidden $true -Location WestUS
```
Ustawienie stanu na "true" spowoduje ukrycie zasobów usługi Azure Virtual Desktop (klasycznej). Ustawienie wartości "false" spowoduje ujawnienie zasobów użytkownikom.

Parametr -Hostpool jest opcjonalny. Możesz użyć tego parametru, jeśli istnieje określona pula hostów usługi Azure Virtual Desktop (klasyczna), którą chcesz ukryć.

To polecenie cmdlet ukryje kanał informacyjny użytkownika i obiekty usługi Azure Virtual Desktop (klasyczne), zamiast je usuwać. Jednak zazwyczaj jest ona używana tylko do celów testowych i nie jest liczona jako ukończona migracja. Aby ukończyć migrację, musisz uruchomić polecenie Complete-RdsHostPoolMigration . W przeciwnym razie przywróć wdrożenie, uruchamiając polecenie Revert-RdsHostPoolMigration.

Rozwiązywanie problemów z migracją automatyczną

W tej sekcji wyjaśniono, jak rozwiązać często napotykane problemy w module migracji.

Nie mogę uzyskać dostępu do dzierżawy

Najpierw wypróbuj te dwie rzeczy:

Upewnij się, że konto administratora ma wymagane uprawnienia dostępu do dzierżawy.
Spróbuj uruchomić polecenie Get-RdsTenant w dzierżawie.

Jeśli te dwie czynności zadziałają, spróbuj uruchomić polecenie cmdlet Set-RdsMigrationContext , aby ustawić kontekst usług pulpitu zdalnego i kontekst biblioteki ADAL dla migracji:

Utwórz kontekst usług pulpitu zdalnego, uruchamiając polecenie cmdlet Add-RdsAccount .
Znajdź kontekst usług pulpitu zdalnego w $rdMgmtContext zmiennej globalnej.
Znajdź kontekst biblioteki ADAL w $AdalContext zmiennych globalnych.
Uruchom polecenie Set-RdsMigrationContext ze zmiennymi znalezionymi w tym formacie:
```
Set-RdsMigrationContext -RdsContext <rdscontext> -AdalContext <adalcontext>
```

Następne kroki

Jeśli zamiast tego chcesz dowiedzieć się, jak ręcznie migrować wdrożenie, zobacz Ręczne migrowanie z usługi Azure Virtual Desktop (klasycznej).

Po przeprowadzeniu migracji sprawdź, jak działa usługa Azure Virtual Desktop, zapoznając się z naszymi samouczkami. Więcej informacji o zaawansowanych funkcjach zarządzania znajdziesz w artykułach Rozszerzanie istniejącej puli hostów i Dostosowywanie właściwości protokołu RDP.

Aby dowiedzieć się więcej o obiektach usług, zapoznaj się ze środowiskiem usługi Azure Virtual Desktop.

Opinia

Czy ta strona była pomocna?

Last updated on 2026-09-18