Automatyczne migrowanie z usługi Azure Virtual Desktop (wersja klasyczna)

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ć tego narzędzia.

Wymagania wstępne

Przed użyciem modułu migracji upewnij się, że masz 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 subskrypcji, oraz rolę administratora 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 migrowanych pulach hostów.

• 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 do uruchamiania skryptów, które zostaną wyświetlone w tym artykule. Moduł Microsoft.RdInfra.RDPowershell nie działa w programie PowerShell Core.

Przygotowywanie środowiska programu PowerShell

Najpierw należy przygotować środowisko programu PowerShell do procesu migracji.

Aby przygotować środowisko programu PowerShell:

1. 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
   

2. Następnie odinstaluj bieżący moduł RDInfra programu PowerShell, uruchamiając następujące polecenie cmdlet:

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

3. Następnie zainstaluj moduł RDPowershell przy użyciu tego polecenia cmdlet:

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

4. Po zakończeniu instalowania wszystkich elementów uruchom to polecenie cmdlet, aby upewnić się, że masz odpowiednie wersje modułów:

   Get-Module Microsoft.RDInfra.RDPowershell
   

5. 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
   

6. Po zakończeniu zaloguj się do usługi Azure Virtual Desktop (klasycznej) w oknie programu PowerShell:

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

7. Zaloguj się do usługi Azure Resource Manager:

   Login-AzAccount
   

8. Jeśli masz wiele subskrypcji, wybierz tę, do którą chcesz przeprowadzić migrację zasobów za pomocą tego polecenia cmdlet:

   Select-AzSubscription -Subscriptionid <subID>
   

9. Zarejestruj dostawcę zasobów w Azure Portal dla wybranej subskrypcji.

10. 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 użyć Azure Portal, otwórz i zaloguj się do Azure Portal, przejdź do pozycji Subskrypcje i wybierz nazwę subskrypcji, która ma być używana. Następnie przejdź do pozycji Dostawca> zasobówMicrosoft.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 (klasycznej) 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 (klasycznej) do usługi Azure Resource Manager:

1. Przed migracją, jeśli chcesz zrozumieć, w jaki sposób 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żna utworzyć plik CSV mapujący lokalizację zasobów. Jeśli na przykład nazwa dzierżawy to "Contoso" i chcesz zapisać plik mapowania w pliku "contosouser", uruchom 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'
   

2. 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.

   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 polecenie w następujący sposób:

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

   Jeśli nie podasz 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 opcji Kopiuj, aby skopiować wszystkie przypisania użytkowników ze starych grup aplikacji do grupy aplikacji Resource Manager platformy Azure. 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 przy użyciu 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 (klasycznej).

   Możesz skopiować tylko 2000 przypisań użytkowników na subskrypcję, więc limit będzie zależeć od liczby przypisań, które znajdują się już w subskrypcji. Moduł oblicza limit na podstawie liczby przypisań, 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 przydział przydziału roli do skopiowania przypisań użytkowników. Uruchom ponownie polecenie bez przełącznika -CopyUserAssignments, aby przeprowadzić migrację.

3. Po uruchomieniu poleceń utworzenie obiektów usługi potrwa do 15 minut. Jeśli skopiowano lub przeniesiono jakiekolwiek przypisania użytkowników, spowoduje to dodanie czasu potrzebnego modułowi na zakończenie konfigurowania wszystkich elementów.

   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 "Tenantname", 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 opublikowali nowo utworzone grupy aplikacji.

   • Maszyny wirtualne będą dostępne w istniejących 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ć na nich uprawnień Access Control opartych na rolach (RBAC) ani ustawień diagnostycznych. W związku z tym należy ręcznie zaktualizować uprawnienia rbac i ustawienia dla tych obiektów.

   Gdy moduł zweryfikuje początkowe połączenia użytkownika, 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 przeniesienie grup aplikacji do innej grupy zasobów po przypisaniu uprawnień do użytkowników spowoduje usunięcie wszystkich ról RBAC. Musisz ponownie przypisać użytkownikom uprawnienia RBAC na nowo.

4. 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 (klasycznej), aby zakończyć proces.

   Przykład:

   Complete-RdsHostPoolMigration -Tenant Contoso -Location EastUS
   

   Jeśli chcesz ukończyć określoną pulę hostów, możesz dołączyć nazwę puli hostów do polecenia 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 (klasyczna). Pozostaną tylko nowe obiekty platformy Azure, a użytkownicy będą mogli wyświetlać 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 (klasycznej).

5. Jeśli zmieniono zdanie dotyczące migracji i chcesz przywrócić ten 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ź coś takiego:

   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ć kanał informacyjny tylko 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 nim grupy zasobów. Aby się ich pozbyć, musisz ręcznie usunąć te elementy.

6. Jeśli nie chcesz jeszcze usuwać obiektów usługi Azure Virtual Desktop (klasycznej), 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 wartość "true" spowoduje ukrycie zasobów usługi Azure Virtual Desktop (klasycznej). 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 (klasyczna), którą chcesz ukryć.

   To polecenie cmdlet spowoduje ukrycie kanału informacyjnego użytkowników 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 uwzględniane 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 migracją automatyczną

W tej sekcji wyjaśniono, jak rozwiązywać 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 rzeczy działają, spróbuj uruchomić polecenie cmdlet Set-RdsMigrationContext , aby ustawić kontekst rds i kontekst biblioteki ADAL dla migracji:

1. Utwórz kontekst usług pulpitu zdalnego, uruchamiając polecenie cmdlet Add-RdsAccount .

2. Znajdź kontekst usług pulpitu zdalnego w zmiennej globalnej $rdMgmtContext.

3. Znajdź kontekst biblioteki ADAL w zmiennej globalnej $AdalContext.

4. 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 ręcznie przeprowadzić migrację wdrożenia, zobacz Migrowanie ręcznie z usługi Azure Virtual Desktop (klasyczna).

Po przeprowadzeniu migracji zapoznaj się z naszymi samouczkami, aby dowiedzieć się, jak działa usługa Azure Virtual Desktop. Dowiedz się więcej o zaawansowanych możliwościach zarządzania w obszarze Rozwiń istniejącą pulę hostów i Dostosuj właściwości protokołu RDP.

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