Eseguire automaticamente la migrazione da Desktop virtuale Azure (versione classica)

Importante

Desktop virtuale Azure classico verrà ritirato il 30 settembre 2026. Le connessioni alle risorse classiche verranno bloccate dopo il ritiro.

Per evitare interruzioni, eseguire la migrazione delle risorse classiche rimanenti a pool di host basati su Azure Resource Manager prima del 30 settembre 2026.

Lo strumento del modulo di migrazione consente di eseguire automaticamente la migrazione dell'organizzazione da Desktop virtuale Azure (classico) a Desktop virtuale Azure. Questo articolo illustra come usare lo strumento.

Prerequisiti

Prima di utilizzare il modulo di migrazione, assicurarsi di avere a disposizione quanto segue:

Una sottoscrizione di Azure in cui creare nuovi oggetti servizio di Azure.
È necessario disporre del ruolo Collaboratore per creare oggetti di Azure nella sottoscrizione e del ruolo Amministratore Accesso utenti per assegnare gli utenti ai gruppi di applicazioni.
Almeno le autorizzazioni di collaboratore di Servizi Desktop remoto (RDS) in un tenant di Servizi Desktop remoto o nei pool di host specifici di cui si sta eseguendo la migrazione.
L'ultima versione del modulo Microsoft.RdInfra.RDPowershell PowerShell.
L'ultima versione del modulo Az.DesktopVirtualization PowerShell.
La versione più recente del modulo di PowerShell Az.Resources.
Installare il modulo di migrazione nel computer.
PowerShell o PowerShell ISE per eseguire gli script visualizzati in questo articolo. Il modulo Microsoft.RdInfra.RDPowershell non funziona in PowerShell Core.

Importante

La migrazione crea solo oggetti servizio nell'area geografica degli Stati Uniti. Se si tenta di eseguire la migrazione degli oggetti servizio in un'altra area geografica, l'operazione non funzionerà. Inoltre, se nella distribuzione di Desktop virtuale Azure (versione classica) sono presenti più di 500 gruppi di applicazioni, non sarà possibile eseguire la migrazione. Sarà possibile eseguire la migrazione solo se si ricompila l'ambiente per ridurre il numero di gruppi di applicazioni all'interno del tenant di Microsoft Entra.

Preparare l'ambiente di PowerShell

Prima di tutto, è necessario preparare l'ambiente di PowerShell per il processo di migrazione.

Per preparare l'ambiente di PowerShell:

Prima di iniziare, verificare di disporre della versione più recente dei moduli Az.Desktop Virtualization e Az.Resources eseguendo i cmdlet seguenti:

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

In caso contrario, sarà necessario installare e importare i moduli eseguendo questi cmdlet:

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

Quindi, disinstallare il modulo PowerShell RDInfra corrente eseguendo questo cmdlet:
```
Uninstall-Module -Name Microsoft.RDInfra.RDPowershell -AllVersions
```

Successivamente, installare il modulo RDPowershell con questo cmdlet:

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

Dopo aver installato tutto, eseguire questo cmdlet per assicurarsi di avere le versioni corrette dei moduli:
```
Get-Module Microsoft.RDInfra.RDPowershell
```

Ora, installare e importare il modulo di migrazione eseguendo questi 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

Al termine, accedere a Desktop virtuale Azure (versione classica) nella finestra di PowerShell:
```
Add-RdsAccount -DeploymentUrl https://rdbroker.wvd.microsoft.com
```
Accedi a Azure Resource Manager:
```
Login-AzAccount
```
Se si hanno più sottoscrizioni, selezionare quella in cui si vogliono eseguire la migrazione delle risorse con questo cmdlet:
```
Select-AzSubscription -Subscriptionid <subID>
```
Registrare il provider di risorse nel portale di Azure per la sottoscrizione selezionata.
Infine, è necessario registrare il provider. Questa operazione si può eseguire in due modi:
- Se si vuole usare PowerShell, eseguire questo cmdlet:
```
Register-AzResourceProvider -ProviderNamespace Microsoft.DesktopVirtualization
```
- Se si preferisce usare il portale di Azure, aprire e accedere al portale di Azure, quindi passare a Sottoscrizioni e selezionare il nome della sottoscrizione che si vuole usare. Successivamente, vai a Provider di> risorseMicrosoft.DesktopVirtualization e seleziona Ripeti registrazione. Non vedrai ancora alcun cambiamento nell'interfaccia utente, ma il tuo ambiente PowerShell dovrebbe essere pronto per eseguire il modulo.

Eseguire la migrazione delle risorse di Desktop virtuale Azure (versione classica) a Azure Resource Manager

Ora che l'ambiente PowerShell è pronto, è possibile iniziare il processo di migrazione.

Per eseguire la migrazione delle risorse di Desktop virtuale Azure (versione classica) a Azure Resource Manager:

Prima di eseguire la migrazione, se si desidera comprendere come verranno mappate le risorse classiche esistenti alle nuove risorse Azure Resource Manager, eseguire questo cmdlet:
```
Get-RdsHostPoolMigrationMapping
```
Con Get-RdsHostPoolMigrationMapping, puoi creare un file CSV che mappa dove andranno le tue risorse. Ad esempio, se il nome del tenant è "Contoso" e si vuole archiviare il file di mapping nel file "contosouser", si deve eseguire un cmdlet simile al seguente:
```
Get-RdsHostPoolMigrationMapping -Tenant Contoso -HostPool Office -Location EastUS -OutputFile 'C:\\Users\contosouser\OneDrive - Microsoft\Desktop\mapping.csv'
```
Quindi, esegui il cmdlet Start-RdsHostPoolMigration per scegliere se migrare un singolo pool di host o tutti i pool di host all'interno di un tenant.

Ad esempio:
```
Start-RdsHostPoolMigration -Tenant Contoso -Location WestUS
```
Se si desidera eseguire la migrazione delle risorse in un pool host specifico, includere il nome del pool host. Ad esempio, se si desidera spostare il pool di host denominato "Office", eseguire un comando simile al seguente:
```
Start-RdsHostPoolMigration -Tenant Contoso -HostPool Office -CopyUserAssignments $false -Location EastUS
```
Se non si specifica un nome per l'area di lavoro, il modulo ne creerà automaticamente uno in base al nome del tenant. Tuttavia, se si preferisce usare un'area di lavoro specifica, è possibile immettere l'ID risorsa nel modo seguente:
```
Start-RdsHostPoolMigration -Tenant Contoso -HostPool Office -CopyUserAssignments -Location EastUS -Workspace <Resource ID of workspacename>
```
Se si vuole usare un'area di lavoro specifica ma non se ne conosce l'ID risorsa, eseguire questo cmdlet:
```
Get-AzWvdWorkspace -WorkspaceName <workspace> -ResourceGroupName <resource group> |fl
```
Dovrai anche specificare una modalità di assegnazione utente per le assegnazioni utente esistenti:
- Usare Copia per copiare tutte le assegnazioni utente dai vecchi gruppi di applicazioni a Azure Resource Manager gruppi di applicazioni. Gli utenti potranno visualizzare i feed per entrambe le versioni dei propri client.
- Usare Nessuno se non si desidera modificare le assegnazioni utente. In seguito, è possibile assegnare utenti o gruppi di utenti a gruppi di applicazioni con il portale di Azure, PowerShell o l'API. Gli utenti potranno vedere i feed solo usando i client di Desktop virtuale Azure (classica).
È possibile copiare solo 2.000 assegnazioni utente per abbonamento, quindi il limite dipenderà dal numero di attività già presenti nell'abbonamento. Il modulo calcola il limite in base al numero di attività già assegnate. Se non si hanno abbastanza attività da copiare, verrà visualizzato il messaggio di errore "Quota assegnazione di ruolo insufficiente per copiare le assegnazioni degli utenti. Eseguire nuovamente il comando senza l'opzione -CopyUserAssignments per eseguire la migrazione".
Dopo aver eseguito i comandi, il modulo impiegherà fino a 15 minuti per creare gli oggetti servizio. Se hai copiato o spostato le assegnazioni utente, ciò aumenterà il tempo necessario al modulo per completare la configurazione di tutto.

Al termine del cmdlet Start-RdsHostPoolMigration , dovresti vedere quanto segue:
- Oggetti del servizio di Azure per il tenant o il pool di host specificato.
- Due nuovi gruppi di risorse:
  - Un gruppo di risorse denominato "Tenantname", che contiene l'area di lavoro.
  - Un gruppo di risorse denominato "Tenantname_originalHostPoolName", che contiene il pool host e i gruppi di applicazioni desktop.
- Tutti gli utenti pubblicati nei gruppi di applicazioni appena creati.
- Le macchine virtuali saranno disponibili sia nei pool di host esistenti che in quelli nuovi per evitare tempi di inattività degli utenti durante il processo di migrazione. In questo modo gli utenti possono connettersi alla stessa sessione utente.
Poiché questi nuovi oggetti servizio Azure sono oggetti Azure Resource Manager, il modulo non può impostare le autorizzazioni Controllo di accesso basate sui ruoli (RBAC) o le impostazioni di diagnostica su di essi. Di conseguenza, è necessario aggiornare manualmente le autorizzazioni e le impostazioni di controllo degli accessi in base al ruolo per questi oggetti.

Una volta che il modulo ha convalidato le connessioni utente iniziali, è anche possibile pubblicare il gruppo di applicazioni per altri utenti o gruppi di utenti, se lo si desidera.

Nota

Dopo la migrazione, se si spostano i gruppi di applicazioni in un gruppo di risorse diverso dopo aver assegnato le autorizzazioni agli utenti, verranno rimossi tutti i ruoli Controllo dell'accesso basato sui ruoli (RBAC). Sarà necessario riassegnare agli utenti le autorizzazioni Controllo dell'accesso basato sui ruoli (RBAC).
Se si desidera eliminare tutti gli oggetti servizio di Desktop virtuale Azure (classico), eseguire Complete-RdsHostPoolMigration per completare il processo di migrazione. Questo cmdlet eliminerà tutti gli oggetti di Desktop virtuale Azure (versione classica), lasciando solo i nuovi oggetti di Azure. Gli utenti potranno visualizzare il feed solo per i gruppi di applicazioni appena creati nei propri client. Dopo aver eseguito questo comando, è possibile eliminare in modo sicuro il tenant di Desktop virtuale Azure (versione classica) per completare il processo.

Ad esempio:
```
Complete-RdsHostPoolMigration -Tenant Contoso -Location EastUS
```
Se si desidera completare un pool di host specifico, è possibile includere il nome del pool di host nel cmdlet. Ad esempio, se si vuole completare un pool di host denominato "Office", usare un comando simile al seguente:
```
Complete-RdsHostPoolMigration -Tenant Contoso -HostPool Office -Location EastUS
```
Verranno eliminati tutti gli oggetti servizio creati da Desktop virtuale Azure (versione classica). Resteranno solo i nuovi oggetti di Azure e gli utenti potranno vedere solo il feed per i gruppi di applicazioni appena creati nei propri client. Dopo aver completato la migrazione, è necessario eliminare in modo esplicito il tenant in Desktop virtuale Azure (versione classica).
Se hai cambiato idea sulla migrazione e vuoi ripristinare il processo, esegui il cmdlet Revert-RdsHostPoolMigration .

Ad esempio:
```
Revert-RdsHostPoolMigration -Tenant Contoso -Location EastUS
```
Se si vuole ripristinare un pool di host specifico, è possibile includere il nome del pool di host nel comando. Ad esempio, se si vuole ripristinare un pool di host denominato "Office", inserire qualcosa di simile al seguente:
```
Revert-RdsHostPoolMigration -Tenant Contoso -HostPool Office -Location EastUS
```
Questo cmdlet eliminerà tutti gli oggetti del servizio di Azure appena creati. Gli utenti vedranno solo il feed per gli oggetti Desktop virtuale Azure (versione classica) nei loro client.

Tuttavia, il cmdlet non eliminerà l'area di lavoro creata dal modulo o il gruppo di risorse associato. Sarà necessario eliminare manualmente questi elementi per eliminarli.
Se non si vogliono ancora eliminare gli oggetti servizio di Desktop virtuale Azure (versione classica) ma si vuole testare la migrazione, è possibile eseguire Set-RdsHostPoolHidden.

Ad esempio:
```
Set-RdsHostPoolHidden -Tenant Contoso -Hostpool Office -Hidden $true -Location WestUS
```
Impostando lo stato su "true", le risorse di Desktop virtuale Azure (versione classica) verranno nascoste. Se si imposta su "false", le risorse verranno rivelate agli utenti.

Il parametro -Hostpool è facoltativo. È possibile usare questo parametro se è presente un pool di host di Desktop virtuale Azure (classico) specifico che si vuole nascondere.

Questo cmdlet nasconderà il feed utente di Desktop virtuale Azure (versione classica) e gli oggetti servizio invece di eliminarli. Tuttavia, di solito viene usata solo a scopo di test e non viene conteggiata come migrazione completata. Per completare la migrazione, è necessario eseguire il comando Complete-RdsHostPoolMigration . In caso contrario, ripristina la distribuzione eseguendo Revert-RdsHostPoolMigration.

Risolvere i problemi relativi alla migrazione automatica

Questa sezione spiega come risolvere i problemi più comuni nel modulo di migrazione.

Non riesco ad accedere al tenant

Prima di tutto, prova queste due cose:

Assicurarsi che l'account amministratore disponga delle autorizzazioni necessarie per accedere al tenant.
Provare a eseguire Get-RdsTenant nel tenant.

Se queste due operazioni funzionano, provare a eseguire il cmdlet Set-RdsMigrationContext per impostare il contesto RDS e il contesto ADAL per la migrazione:

Creare il contesto RDS eseguendo il cmdlet Add-RdsAccount .
Trova il contesto RDS nella variabile globale $rdMgmtContext.
Trovare il contesto ADAL nella variabile globale $AdalContext.
Esegui Set-RdsMigrationContext con le variabili che hai trovato in questo formato:
```
Set-RdsMigrationContext -RdsContext <rdscontext> -AdalContext <adalcontext>
```

Passaggi successivi

Se invece si vogliono informazioni su come eseguire la migrazione manuale della distribuzione, vedere Eseguire la migrazione manuale da Desktop virtuale Azure (versione classica).

Dopo aver eseguito la migrazione, scoprire il funzionamento di Desktop virtuale Azure guardando le esercitazioni. Per informazioni sulle funzionalità di gestione avanzate, vedere Espandere un pool di host esistente e Personalizzare le proprietà RDP.

Per altre informazioni sugli oggetti servizio, vedere Ambiente Desktop virtuale Azure.

Commenti e suggerimenti

Questa pagina è stata utile?

Last updated on 2026-09-18