Migrowanie automatycznie z usługi Azure Virtual Desktop (wersja klasyczna)

Artykuł
10/18/2023

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 pokazano, jak używać narzędzia.

Wymagania wstępne

Przed rozpoczęciem korzystania z modułu migracji upewnij się, że są gotowe następujące elementy:

Subskrypcja platformy Azure, w której utworzysz nowe obiekty usługi platformy Azure.
Musisz mieć przypisaną rolę Współautor, aby utworzyć obiekty platformy Azure w ramach subskrypcji, a rola Administracja istratora dostępu użytkowników, aby przypisać użytkowników do grup aplikacji.
Co najmniej uprawnienia współautora usług pulpitu zdalnego (RDS) w dzierżawie usług pulpitu zdalnego lub określonych pul hostów, które migrujesz.
Najnowsza wersja modułu Microsoft.RdInfra.RDPowershell programu PowerShell.
Najnowsza wersja modułu Az.DesktopVirtualization programu PowerShell.
Najnowsza wersja modułu Az.Resources programu PowerShell.
Zainstaluj moduł migracji na komputerze.
Program PowerShell lub program PowerShell ISE służący do uruchamiania skryptów, które zostaną wyświetlone w tym artykule. Moduł Microsoft.RdInfra.RDPowershell nie działa w programie PowerShell Core.

Ważne

Migracja tworzy tylko obiekty usługi w lokalizacji geograficznej USA. Jeśli spróbujesz przeprowadzić migrację obiektów usługi do innej lokalizacji geograficznej, nie będzie to działać. Ponadto jeśli masz więcej niż 500 grup aplikacji we wdrożeniu usługi Azure Virtual Desktop (wersja klasyczna), nie będzie można przeprowadzić migracji. Migracja będzie dostępna tylko w przypadku ponownego kompilowania środowiska w celu zmniejszenia liczby grup aplikacji w dzierżawie firmy Microsoft Entra.

Przygotowywanie środowiska programu PowerShell

Najpierw należy 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ą następującego polecenia cmdlet:

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

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

Teraz zainstalujmy i zaimportujmy 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 usługi Azure Resource Manager:
```
Login-AzAccount
```
Jeśli masz wiele subskrypcji, wybierz tę, do której chcesz przeprowadzić migrację zasobów za pomocą tego polecenia cmdlet:
```
Select-AzSubscription -Subscriptionid <subID>
```
Zarejestruj dostawcę zasobów w witrynie Azure Portal dla wybranej subskrypcji.
Na koniec musisz zarejestrować dostawcę. Istnieją dwa sposoby, aby to zrobić:
- Jeśli chcesz użyć programu PowerShell, uruchom następujące polecenie cmdlet:
```
Register-AzResourceProvider -ProviderNamespace Microsoft.DesktopVirtualization
```
- Jeśli wolisz użyć witryny Azure Portal, otwórz witrynę Azure Portal i zaloguj się do witryny Azure Portal, a następnie przejdź do obszaru Subskrypcje i wybierz nazwę subskrypcji, której chcesz użyć. Następnie przejdź do pozycji Dostawca>zasobów Microsoft.DesktopVirtualization i wybierz pozycję Zarejestruj ponownie. Nie zobaczysz jeszcze żadnych zmian w interfejsie użytkownika, ale środowisko programu PowerShell powinno być teraz gotowe do uruchomienia modułu.

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

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

Aby przeprowadzić migrację zasobów usługi Azure Virtual Desktop (wersja klasyczna) do usługi Azure Resource Manager:

Jeśli chcesz dowiedzieć się, jak istniejące zasoby klasyczne zostaną zamapowane na nowe zasoby usługi Azure Resource Manager, uruchom następujące polecenie cmdlet:
```
Get-RdsHostPoolMigrationMapping
```
Za pomocą polecenia Get-RdsHostPoolMigrationMapping możesz utworzyć plik CSV, który mapuje miejsce, w którym będą znajdować się zasoby. Jeśli na przykład nazwa dzierżawy to "Contoso" i chcesz przechowywać plik mapowania w pliku "contosouser", należy uruchomić polecenie cmdlet, które wygląda następująco:
```
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 wybrać, czy przeprowadzić migrację pojedynczej puli hostów, czy wszystkich pul hostów w ramach dzierżawy.

Na przykład:
```
Start-RdsHostPoolMigration -Tenant Contoso -Location WestUS
```
Jeśli chcesz przeprowadzić migrację zasobów dla 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 nadasz nazwy obszaru roboczego, moduł automatycznie utworzy go na podstawie nazwy dzierżawy. Jeśli jednak wolisz użyć 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
```
Należy również określić tryb przypisywania użytkownika dla istniejących przypisań użytkowników:
- Użyj polecenia Copy , aby skopiować wszystkie przypisania użytkowników ze starych grup aplikacji do grup aplikacji usługi Azure Resource Manager. 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żesz przypisać użytkowników lub grupy użytkowników do grup aplikacji za pomocą witryny Azure Portal, programu PowerShell lub interfejsu API. Użytkownicy będą mogli wyświetlać tylko kanały informacyjne przy użyciu klientów usługi Azure Virtual Desktop (wersja klasyczna).
Możesz skopiować tylko 2000 przypisań użytkowników na subskrypcję, więc limit będzie zależeć od liczby przypisań już w ramach subskrypcji. Moduł oblicza limit na podstawie liczby przydziałów, które już masz. Jeśli nie masz wystarczającej liczby przypisań do skopiowania, zostanie wyświetlony komunikat o błędzie z komunikatem "Niewystarczający limit przydziału przypisania roli do kopiowania przypisań użytkowników. Uruchom ponownie polecenie bez przełącznika -CopyUserAssignments, aby przeprowadzić migrację".
Po uruchomieniu poleceń utworzenie obiektów usługi potrwa do 15 minut. Jeśli skopiowano lub przeniesiono wszystkie przypisania użytkownika, spowoduje to dodanie czasu potrzebnego do ukończenia konfigurowania wszystkiego przez moduł.

Po wykonaniu polecenia cmdlet Start-RdsHostPoolMigration powinny zostać wyświetlone następujące elementy:
- 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 opublikowani w nowo utworzonych grupach aplikacji.
- Maszyny wirtualne będą dostępne zarówno w istniejących, jak i nowych pulach hostów, aby uniknąć przestojów użytkowników podczas procesu migracji. Dzięki temu użytkownicy mogą łączyć się z tą samą sesją użytkownika.
Ponieważ te nowe obiekty usługi platformy Azure są obiektami usługi Azure Resource Manager, moduł nie może ustawić uprawnień kontroli dostępu opartej na rolach (RBAC) ani ustawień diagnostycznych. W związku z tym należy ręcznie zaktualizować uprawnienia i ustawienia kontroli dostępu opartej na rolach 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

Po migracji po przeniesieniu grup aplikacji do innej grupy zasobów po przypisaniu uprawnień do użytkowników zostaną usunięte wszystkie role RBAC. Konieczne będzie ponowne przypisanie uprawnień RBAC użytkowników.
Jeśli chcesz usunąć wszystkie obiekty usługi Azure Virtual Desktop (klasyczne), uruchom polecenie Complete-RdsHostPoolMigration , aby zakończyć proces migracji. To polecenie cmdlet spowoduje usunięcie wszystkich obiektów usługi Azure Virtual Desktop (klasycznych), pozostawiając tylko nowe obiekty platformy Azure. Użytkownicy będą mogli wyświetlać tylko kanał informacyjny 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 zakończyć proces.

Na przykład:
```
Complete-RdsHostPoolMigration -Tenant Contoso -Location EastUS
```
Jeśli chcesz ukończyć określoną pulę hostów, możesz uwzględnić nazwę puli hostów w poleceniu cmdlet. Jeśli na przykład chcesz ukończyć pulę hostów o nazwie "Office", użyj polecenia w następujący sposób:
```
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ą). Pozostaniesz tylko nowymi obiektami platformy Azure, a użytkownicy będą mogli zobaczyć tylko kanał informacyjny 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 (wersja klasyczna).
Jeśli zmienisz zdanie na temat migracji i chcesz przywrócić proces, uruchom polecenie cmdlet Revert-RdsHostPoolMigration .

Na 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 w poleceniu . Jeśli na przykład chcesz przywrócić pulę hostów o nazwie "Office", wprowadź ciąg podobny do następującego:
```
Revert-RdsHostPoolMigration -Tenant Contoso -HostPool Office -Location EastUS
```
To polecenie cmdlet spowoduje usunięcie wszystkich nowo utworzonych obiektów usługi platformy Azure. Użytkownicy będą widzieć tylko źródło danych dla obiektów usługi Azure Virtual Desktop (klasycznych) w swoich klientach.

Jednak polecenie cmdlet nie usunie obszaru roboczego utworzonego modułu ani skojarzonej z nią grupy zasobów. Aby je pozbyć, musisz ręcznie usunąć te elementy.
Jeśli nie chcesz jeszcze usuwać obiektów usługi Azure Virtual Desktop (klasyczny), ale chcesz przetestować migrację, możesz uruchomić polecenie Set-RdsHostPoolHidden.

Na 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 (wersja klasyczna). Ustawienie wartości "false" spowoduje wyświetlenie zasobów użytkownikom.

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

To polecenie cmdlet spowoduje ukrycie kanału informacyjnego użytkownika usługi Azure Virtual Desktop (klasycznego) i obiektów usługi zamiast ich usuwania. Jest to jednak zwykle używane tylko do testowania i nie jest liczone jako ukończona migracja. Aby ukończyć migrację, należy uruchomić polecenie Complete-RdsHostPoolMigration . W przeciwnym razie przywróć wdrożenie, uruchamiając polecenie Revert-RdsHostPoolMigration.

Rozwiązywanie problemów z automatyczną migracją

W tej sekcji wyjaśniono, jak rozwiązywać typowe problemy w module migracji.

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

Najpierw spróbuj wykonać te dwie czynności:

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

Jeśli te dwie elementy działają, spróbuj uruchomić polecenie cmdlet Set-RdsMigrationContext , aby ustawić kontekst usług pulpitu zdalnego i kontekst biblioteki ADAL na potrzeby 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 zmiennej globalnej $AdalContext.
Uruchom polecenie Set-RdsMigrationContext ze zmiennymi znalezionymi w tym formacie:
```
Set-RdsMigrationContext -RdsContext <rdscontext> -AdalContext <adalcontext>
```

Następne kroki

Jeśli chcesz dowiedzieć się, jak przeprowadzić migrację wdrożenia ręcznie, zobacz Migrowanie ręcznie z usługi Azure Virtual Desktop (wersja klasyczna).

Po przeprowadzeniu migracji dowiedz się, jak działa usługa Azure Virtual Desktop, zapoznaj się z naszymi samouczkami. Dowiedz się więcej o zaawansowanych funkcjach zarządzania w obszarze Rozwijanie istniejącej puli hostów i Dostosowywanie właściwości protokołu RDP.

Aby dowiedzieć się więcej na temat obiektów usług, zapoznaj się ze środowiskiem usługi Azure Virtual Desktop.