Aggiungere e gestire applicazioni collegate di app in Desktop virtuale di Azure

Ecco come aggiungere un'immagine MSIX, un'immagine Appx o un pacchetto App-V come pacchetto di collegamento di app usando il portale di Azure:

1. Accedere al portale di Azure.

2. Nella barra di ricerca digitare Desktop virtuale Azure e selezionare la voce relativa al servizio corrispondente per passare alla panoramica di Desktop virtuale Azure.

3. Selezionare Allega app, quindi selezionare + Crea.

4. Nella scheda Informazioni di base completare le informazioni seguenti:

   Parametro	Descrizione
   Abbonamento	Selezionare la sottoscrizione a cui si vuole aggiungere un'immagine MSIX, un'immagine Appx o un pacchetto App-V dall'elenco a discesa.
   Gruppo di risorse	Selezionare un gruppo di risorse esistente o scegliere Crea nuovo e immettere un nome.
   Pool di host	Selezionare un pool di host esistente nell'elenco a discesa.
   Posizione	Selezionare l'area di Azure per il pacchetto di collegamento di app. L'ambito di distribuzione del pacchetto viene ereditato dal pool di host selezionato e per un pool di host con un ambito di distribuzione regionale, il percorso deve corrispondere all'area di Azure del pool di host.

   Al termine di questa scheda, selezionare Avanti.

5. Nella scheda Percorso immagine , completare le seguenti informazioni:

   Parametro	Descrizione
   Percorso immagine	Selezionare da Seleziona dall'account di archiviazione se l'immagine è archiviata in File di Azure o UNC di input per specificare un percorso UNC. I campi successivi dipendono dall'opzione selezionata.
   Selezionare dall'account di archiviazione
   Account di archiviazione	Selezionare l'account di archiviazione in cui si trova l'immagine.
   Condivisione file	Seleziona Seleziona un file, quindi passa alla condivisione file e alla directory in cui si trova l'immagine. Selezionare la casella accanto all'immagine da aggiungere, ad esempio MyApp.cim, quindi selezionare Seleziona.
   Pacchetto MSIX	Selezionare il pacchetto MSIX o Appx dall'immagine.
   Input UNC
   UNC	Immettere il percorso UNC del file di immagine.
   Pacchetto MSIX	Selezionare il pacchetto MSIX o Appx dall'immagine.
   Entrambe le opzioni
   Nome visualizzato	Immettere un nome descrittivo per l'applicazione.
   Versione	Verificare che venga visualizzato il numero di versione previsto.
   Tipo di registrazione	Selezionare il tipo di registrazione che si desidera utilizzare.
   Stato	Selezionare lo stato iniziale del pacchetto.
   Stato del controllo di integrità in caso di errore	Selezionare lo stato del pacchetto se non riesce a eseguire la gestione temporanea in un host di sessione. Questo stato viene segnalato per AppAttachHealthCheck per lo stato del controllo dell'integrità dell'host della sessione.

   Al termine di questa scheda, selezionare Avanti.

   Consiglio

   Dopo aver completato questa scheda, è possibile continuare ad assegnare facoltativamente l'applicazione a pool di host, utenti e gruppi. In alternativa, se si vogliono configurare le attività separatamente, selezionare Rivedi + Crea, quindi passare ad Assegna un pacchetto di collegamento app.

6. Facoltativo: Nella scheda Attività completare le informazioni seguenti:

   1. Per Pool di host, selezionare i pool di host a cui si desidera assegnare l'applicazione.

   2. Selezionare Aggiungi utenti o gruppi di utenti, quindi cercare e selezionare gli utenti o i gruppi a cui si vuole assegnare l'applicazione. Al termine, selezionare Seleziona.

   3. Rivedere le attività aggiunte, quindi selezionare Avanti.

7. Facoltativo: nella scheda Tag , puoi inserire le coppie nome/valore necessarie, quindi selezionare Rivedi + Crea.

8. Nella scheda Rivedi + Crea verificare che la convalida venga superata ed esaminare le informazioni usate durante la distribuzione, quindi selezionare Crea per aggiungere l'applicazione.

Ecco come aggiungere un'immagine MSIX, un'immagine Appx o un pacchetto App-V come pacchetto di collegamento di app usando il modulo di PowerShell Az.DesktopVirtualization . Assicurati di modificare i valori per i <placeholder> tuoi.

1. Apri Azure Cloud Shell nel portale di Azure con il tipo di terminale PowerShell oppure esegui PowerShell nel dispositivo locale.

   • Se si usa Cloud Shell, assicurarsi che il contesto di Azure sia impostato sulla sottoscrizione che si vuole usare.

   • Se si usa PowerShell in locale, accedere prima con Azure PowerShell, quindi assicurarsi che il contesto di Azure sia impostato sulla sottoscrizione che si vuole usare.

2. Durante l'anteprima, verificare di avere a disposizione i cmdlet di PowerShell eseguendo i comandi seguenti:

   Import-Module Az.DesktopVirtualization
   Get-Command -Module Az.DesktopVirtualization -Noun "*AppAttach*"
   

   L'output dovrebbe essere simile al seguente:

   CommandType     Name                                               Version    Source
   -----------     ----                                               -------    ------
   Function        Get-AzWvdAppAttachPackage                          4.2.1      Az.DesktopVirtualization
   Function        Import-AzWvdAppAttachPackageInfo                   4.2.1      Az.DesktopVirtualization
   Function        New-AzWvdAppAttachPackage                          4.2.1      Az.DesktopVirtualization
   Function        Remove-AzWvdAppAttachPackage                       4.2.1      Az.DesktopVirtualization
   Function        Update-AzWvdAppAttachPackage                       4.2.1      Az.DesktopVirtualization
   

3. Ottenere le proprietà dell'immagine MSIX, dell'immagine Appx o del pacchetto App-V da aggiungere e archiviarle in una variabile eseguendo il comando seguente. È necessario specificare un pool di host, ma può essere qualsiasi pool di host in cui gli host di sessione hanno accesso alla condivisione file.

   # Get the properties of the MSIX image, Appx image, or App-V package
   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       Path = '<UNCPathToFile>'
   }
   
   $app = Import-AzWvdAppAttachPackageInfo @parameters
   

4. Verificare che nelle proprietà dell'applicazione sia presente un solo oggetto eseguendo i comandi seguenti:

   $app | FL *
   

   Facoltativo: se nell'output sono presenti più oggetti, ad esempio una versione x64 e una x86 della stessa applicazione, è possibile utilizzare il parametro PackageFullName per specificare l'applicazione da aggiungere eseguendo i comandi seguenti:

   # Specify the package full name
   $packageFullName = '<PackageFullName>'
   
   # Get the properties of the application
   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       Path = '<UNCPathToFile>'
   }
   
   $app = Import-AzWvdAppAttachPackageInfo @parameters | ? ImagePackageFullName -like *$packageFullName*
   

5. Aggiungere l'immagine o il pacchetto come pacchetto di collegamento app eseguendo il comando seguente. In questo esempio, lo stato dell'applicazione è contrassegnato come attivo, la registrazione dell'applicazione è impostata su richiesta e lo stato del controllo dell'integrità dell'host della sessione in caso di errore è impostato su NeedsAssistance:

   $parameters = @{
       Name = '<AppName>'
       ResourceGroupName = '<ResourceGroupName>'
       Location = '<AzureRegion>'
       FailHealthCheckOnStagingFailure = 'NeedsAssistance'
       ImageIsRegularRegistration = $false
       ImageDisplayName = '<AppDisplayName>'
       ImageIsActive = $true
   }
   
   New-AzWvdAppAttachPackage -AppAttachPackage $app @parameters
   

   Non c'è output quando il pacchetto viene aggiunto correttamente.

6. È possibile verificare che il pacchetto sia stato aggiunto eseguendo i comandi seguenti:

   $parameters = @{
       Name = '<AppName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdAppAttachPackage @parameters | FL Name, ImagePackageApplication, ImagePackageFamilyName, ImagePath, ImageVersion, ImageIsActive, ImageIsRegularRegistration, SystemDataCreatedAt
   

   L'output dovrebbe essere simile all'esempio seguente:

   Name                       : My App
   ImagePackageApplication    : {MyApp}
   ImagePackageFamilyName     : MyApp_abcdef123ghij
   ImagePath                  : \\fileshare\Apps\MyApp\MyApp.cim
   ImageVersion               : 1.0.0.0
   ImageIsActive              : True
   ImageIsRegularRegistration : True
   SystemDataCreatedAt        : 7/31/2023 3:03:43 PM
   

Ecco come assegnare un pacchetto dell'applicazione a pool di host, utenti e gruppi usando il portale di Azure:

Pool di host

1. Nella panoramica di Desktop virtuale Azure selezionare Collegamento app, quindi selezionare il nome del pacchetto di collegamento di app che si desidera assegnare.

2. Nella sezione Gestire selezionare Pool di host:

3. Selezionare + Assegna, quindi selezionare uno o più pool di host dall'elenco a discesa. Assicurarsi che tutti gli host sessione nel pool di host debbano disporre dell'accesso in lettura con il proprio account computer, come indicato nei prerequisiti.
   È possibile assegnare un pacchetto solo a pool di host con lo stesso ambito di distribuzione e i pool di host con un ambito di distribuzione diverso sono disattivati nell'elenco.

4. Selezionare Aggiungi.

Gruppi e utenti

1. Nella panoramica di Desktop virtuale Azure selezionare Collegamento app, quindi selezionare il nome del pacchetto di collegamento di app che si desidera assegnare.

2. Nella sezione Gestisci, seleziona Utenti:

3. Selezionare + Aggiungi, quindi selezionare uno o più gruppi e/o utenti dall'elenco.

4. Seleziona Seleziona.

Ecco come assegnare un pacchetto dell'applicazione a pool di host, nonché a gruppi e utenti che usano il modulo di PowerShell Az.DesktopVirtualization .

Pool di host

1. Nella stessa sessione di PowerShell, ottenere gli ID risorsa dei pool host a cui si vuole assegnare l'applicazione e aggiungerli a una matrice eseguendo i comandi seguenti:

   # Add a comma-separated list of host pools names
   $hostPoolNames = "<HostPoolName1>","<HostPoolName2>"
   
   # Create an array and add the resource ID for each host pool
   $hostPoolIds = @()
   foreach ($hostPoolName in $HostPoolNames) {
       $hostPoolIds += (Get-AzWvdHostPool | ? Name -eq $hostPoolName).Id
   }
   

2. Una volta ottenuti gli ID risorsa dei pool host, è possibile assegnare loro il pacchetto dell'applicazione eseguendo i comandi seguenti:

   $parameters = @{
       Name = '<AppName>'
       ResourceGroupName = '<ResourceGroupName>'
       Location = '<AzureRegion>'
       HostPoolReference = $hostPoolIds
   }
   
   Update-AzWvdAppAttachPackage @parameters
   

3. Per annullare l'assegnazione del pacchetto dell'applicazione da tutti i pool di host, è possibile passare un array vuoto di pool di host eseguendo i seguenti comandi:

   $parameters = @{
       Name = '<AppName>'
       ResourceGroupName = '<ResourceGroupName>'
       Location = '<AzureRegion>'
       HostPoolReference = @()
   }
   
   Update-AzWvdAppAttachPackage @parameters
   

Gruppi e utenti

Ecco come assegnare un'applicazione a gruppi e utenti usando il modulo Az.DesktopVirtualization PowerShell.

1. Ottenere l'ID oggetto dei gruppi o degli utenti da aggiungere o rimuovere dall'applicazione e aggiungerli a una matrice usando uno degli esempi seguenti. È consigliabile assegnare le applicazioni ai gruppi.

   1. Ottenere l'ID oggetto del gruppo o dei gruppi e aggiungerli a una matrice eseguendo i comandi seguenti. In questo esempio viene usato il nome visualizzato del gruppo:

      # Add a comma-separated list of group names
      $groups = "Group1","Group2"
      
      # Connect to Microsoft Graph
      Connect-MgGraph -Scopes 'Group.Read.All'
      
      # Create an array and add the ID for each group
      $Ids = @()
      
      foreach ($group in $groups) {
         $Ids += (Get-MgGroup | ? DisplayName -eq $group).Id
      }
      

   2. Ottenere l'ID oggetto degli utenti e aggiungerli a un array eseguendo i comandi seguenti. In questo esempio viene usato il nome dell'entità utente (UPN):

      # Add a comma-separated list of user principal names
      $users = "user1@contoso.com","user2@contoso.com"
      
      # Connect to Azure AD
      Connect-MgGraph -Scopes 'User.Read.All'
      
      # Create an array and add the ID for each user
      $userIds = @()
      
      foreach ($user in $users) {
          $userIds += (Get-MgUser | ? UserPrincipalName -eq $user).Id
      }
      

2. Una volta ottenuti gli ID oggetto degli utenti o dei gruppi, è possibile aggiungerli o rimuoverli dall'applicazione utilizzando uno degli esempi seguenti, che assegna il ruolo Controllo dell'accesso basato sui ruoli degli utenti di Desktop Virtualization .

   1. Per aggiungere i gruppi o gli utenti all'applicazione, eseguire i comandi seguenti:

      $parameters = @{
         Name = '<AppName>'
         ResourceGroupName = '<ResourceGroupName>'
      }
      
      $appAttachPackage = Get-AzWvdAppAttachPackage @parameters
      
      foreach ($userId in $userIds) {
         New-AzRoleAssignment -ObjectId $userId -RoleDefinitionName "Desktop Virtualization User" -Scope $appAttachPackage.Id
      }
      

   2. Per rimuovere i gruppi o gli utenti dall'applicazione, eseguire i comandi seguenti:

      $parameters = @{
         Name = '<AppName>'
         ResourceGroupName = '<ResourceGroupName>'
      }
      
      $appAttachPackage = Get-AzWvdAppAttachPackage @parameters
      
      foreach ($userId in $userIds) {
         Remove-AzRoleAssignment -ObjectId $userId -RoleDefinitionName "Desktop Virtualization User" -Scope $appAttachPackage.Id
      }
      

Ecco come modificare il tipo e lo stato di registrazione di un pacchetto usando il portale di Azure:

1. Nella panoramica di Desktop virtuale Azure selezionare Collega app. Dovrebbe essere visualizzato un elenco di tutti i pacchetti esistenti all'interno del pool di host.

2. Selezionare il nome del pacchetto da modificare.

   1. Per modificare il tipo di registrazione, selezionare Su richiesta o Registra all'accesso, quindi selezionare Salva.

   2. Per modificare lo stato, selezionare Inattivo o Attivo, quindi selezionare Salva.

Ecco come modificare il tipo e lo stato di registrazione di un pacchetto usando il modulo Az.DesktopVirtualization PowerShell.

1. Nella stessa sessione di PowerShell è possibile modificare il tipo e lo stato di registrazione eseguendo i comandi seguenti:

   1. Modificare il tipo di registrazione eseguendo il comando seguente. Impostato IsRegularRegistration su $trueper Registra all'accesso o $false per Su richiesta.

      $parameters = @{
          Name = '<Name>'
          ResourceGroupName = '<ResourceGroupName>'
          Location = '<AzureRegion>'
          IsRegularRegistration = $true
      }
      
      Update-AzWvdAppAttachPackage @parameters
      

   2. Modifica lo stato eseguendo il comando seguente. Impostato IsActive su $true Per Attivo o $false Per Inattivo.

      $parameters = @{
          Name = '<Name>'
          ResourceGroupName = '<ResourceGroupName>'
          Location = '<AzureRegion>'
          IsActive = $true
      }
      
      Update-AzWvdAppAttachPackage @parameters
      

Ecco come aggiungere un'applicazione dal pacchetto aggiunto in questo articolo a un gruppo di applicazioni RemoteApp usando il portale di Azure:

1. In Panoramica di Desktop virtuale Azure selezionare Gruppi di applicazioni, quindi selezionare il gruppo di applicazioni RemoteApp a cui si vuole aggiungere un'applicazione.

2. Selezionare Applicazioni, selezionare + Aggiungi. Assicurarsi che almeno un host di sessione sia acceso nel pool di host a cui è assegnato il gruppo di applicazioni.

3. Nella scheda Informazioni di base completare le informazioni seguenti:

   Parametro	Valore/Descrizione
   Origine applicazione	Selezionare Allega app dall'elenco a discesa. Se si desidera aggiungere applicazioni dal menu Start o specificando un percorso di file, vedere Pubblicare applicazioni con RemoteApp.
   Pacchetto	Selezionare un pacchetto disponibile per il pool di host dall'elenco a discesa. I pacchetti regionali provengono da App Attach.
   Applicazione	Selezionare un'applicazione dall'elenco a discesa.
   Identificatore dell'applicazione	Immettere un identificatore univoco per l'applicazione.
   Nome visualizzato	Immettere un nome descrittivo per l'applicazione da condividere con gli utenti.
   Descrizione	Immettere una descrizione per l'applicazione.

   Al termine di questa scheda, selezionare Avanti.

4. Nella scheda Icona selezionare Predefinito per usare l'icona predefinita per l'applicazione oppure selezionare Percorso file per usare un'icona personalizzata. In Percorso file selezionare una delle opzioni seguenti:

   • Esplorare File di Azure per usare un'icona da una condivisione file di Azure. Selezionare Seleziona un account di archiviazione e selezionare l'account di archiviazione contenente il file icona, quindi selezionare Seleziona file icona. Passare alla condivisione file e alla directory in cui si trova l'icona, selezionare la casella accanto all'icona che si desidera aggiungere, ad esempio MyApp.ico, quindi selezionare Seleziona. È anche possibile usare un .png file. Per Indice icone specificare il numero di indice per l'icona da usare. Questo numero è in genere 0.

   • Percorso del file UNC per utilizzare un'icona da una condivisione file. Per Percorso icona, immettere il percorso UNC del file icona, ad esempio \\MyFileShare\MyApp.ico. È anche possibile usare un .png file. Per Indice icone specificare il numero di indice per l'icona da usare. Questo numero è in genere 0.

   Dopo aver completato questa scheda, seleziona Rivedi + Aggiungi.

5. Nella scheda Rivedi + Aggiungi , verificare che la convalida venga superata ed esaminare le informazioni utilizzate per aggiungere l'applicazione, quindi selezionare Aggiungi per aggiungere l'applicazione al gruppo di applicazioni RemoteApp.

Ecco come aggiungere un'applicazione dal pacchetto aggiunto in questo articolo a un gruppo di applicazioni RemoteApp usando il modulo di PowerShell Az.DesktopVirtualization .

1. Nella stessa sessione di PowerShell, se nel pacchetto sono presenti più applicazioni, è necessario ottenere l'ID applicazione dell'applicazione che si vuole aggiungere dal pacchetto eseguendo i comandi seguenti:

   Write-Host "These are the application IDs available in the package. Many packages only contain one application." -ForegroundColor Yellow
   $app.ImagePackageApplication.AppId
   

2. Prendere nota dell'ID applicazione che si desidera pubblicare, ad esempio App), quindi eseguire i comandi seguenti per aggiungere l'applicazione al gruppo di applicazioni RemoteApp:

   $parameters = @{
       Name = '<ApplicationName>'
       ApplicationType = 'MsixApplication'
       MsixPackageFamilyName = $app.ImagePackageFamilyName
       MsixPackageApplicationId = '<ApplicationID>'
       GroupName = '<ApplicationGroupName>'
       ResourceGroupName = '<ResourceGroupName>'
       CommandLineSetting = 'DoNotAllow'
   }
   
   New-AzWvdApplication @parameters
   

3. Verificare l'elenco delle applicazioni nel gruppo di applicazioni eseguendo i seguenti comandi:

   $parameters = @{
       GroupName = '<ApplicationGroupName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdApplication @parameters
   

Ecco come aggiornare un pacchetto esistente usando il portale di Azure:

1. Nella panoramica di Desktop virtuale Azure selezionare Collega app. Dovrebbe essere visualizzato un elenco di tutti i pacchetti esistenti.

2. Selezionare il pacchetto da aggiornare, quindi nella panoramica selezionare Aggiorna.

3. Immettere le informazioni per il pacchetto aggiornato:

   1. La sottoscrizione e il gruppo di risorse vengono prepopolati con i valori per il pacchetto corrente.

   2. Selezionare il pool di host per cui si desidera aggiornare il pacchetto.

   3. Selezionare il percorso dell'immagine da Seleziona dall'account di archiviazione o dall'UNC di input. I campi successivi dipendono dall'opzione selezionata.

      1. In Seleziona dall'account di archiviazione selezionare l'account di archiviazione contenente l'immagine aggiornata. Seleziona Seleziona un file, quindi passa alla condivisione file e alla directory in cui si trova l'immagine. Selezionare la casella accanto all'immagine da aggiungere, ad esempio MyApp.cim, quindi selezionare Seleziona.
      2. Per Input UNC, immettere il percorso UNC per il file di immagine.

   4. Per il pacchetto MSIX selezionare il pacchetto MSIX o Appx dall'immagine.

4. Dopo aver completato i campi, seleziona Aggiorna.

Ecco come aggiornare un pacchetto esistente usando il modulo di PowerShell Az.DesktopVirtualization .

1. Nella stessa sessione di PowerShell, ottenere le proprietà dell'applicazione aggiornata e archiviarle in una variabile eseguendo i comandi seguenti:

   # Get the properties of the application
   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       Path = '<UNCPathToFile>'
   }
   
   $app = Import-AzWvdAppAttachPackageInfo @parameters
   

2. Verificare che nelle proprietà dell'applicazione sia presente un solo oggetto eseguendo i comandi seguenti:

   $app | FL *
   

   Se nell'output sono presenti più oggetti, ad esempio una versione x64 e una x86 della stessa applicazione, è possibile usare il parametro PackageFullName per specificare quale aggiungere eseguendo i comandi seguenti:

   # Specify the package full name
   $packageFullName = '<PackageFullName>'
   
   # Get the properties of the application
   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       Path = '<UNCPathToFile>'
   }
   
   $app = Import-AzWvdAppAttachPackageInfo @parameters | ? ImagePackageFullName -like *$packageFullName*
   

3. Aggiornare un pacchetto esistente eseguendo il comando seguente. La nuova immagine del disco sostituisce quella esistente, ma le assegnazioni esistenti vengono mantenute. Non eliminare l'immagine esistente finché gli utenti non hanno smesso di usarla.

   $parameters = @{
       Name = '<PackageName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Update-AzWvdAppAttachPackage -AppAttachPackage $app @parameters
   

Ecco come rimuovere un pacchetto di collegamento di app usando il portale di Azure:

1. Nella panoramica di Desktop virtuale Azure selezionare Collega app. Dovrebbe essere visualizzato un elenco di tutti i pacchetti esistenti.

2. Selezionare la casella accanto al nome del pacchetto da rimuovere e quindi selezionare Rimuovi. Il pacchetto viene rimosso anche da tutti i pool di host a cui è assegnato.

Ecco come rimuovere un pacchetto di collegamento di app usando il modulo di PowerShell Az.DesktopVirtualization .

1. Nella stessa sessione di PowerShell, esegui il comando seguente per rimuovere il pacchetto contenente un'applicazione:

   $parameters = @{
       Name = '<PackageName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Remove-AzWvdAppAttachPackage @parameters