Aggiungere e gestire le applicazioni app attach e MSIX app attach in Azure Virtual Desktop

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

1. Accedere al portale di Azure.

2. Nella barra di ricerca digitare Desktop virtuale Azure e selezionare la voce del servizio corrispondente per andare alla panoramica di Desktop virtuale Azure.

3. Selezionare Montaggio app e quindi + 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 selezionare Crea nuovo e immettere un nome.
   Pool di host	Selezionare un pool di host esistente dall'elenco a discesa.
   Luogo	Selezionare l'area di Azure per il pacchetto di collegamento dell'app.

   Dopo aver completato questa scheda, selezionare Avanti.

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

   Parametro	Descrizione
   Percorso dell'immagine	Selezionare da Seleziona da account di archiviazione se l'immagine è archiviata in File di Azure o Immettere UNC per specificare un percorso UNC. I campi successivi dipendono dall'opzione selezionata.
   Seleziona da account di archiviazione
   Account di archiviazione	Selezionare l'account di archiviazione in cui si trova l'immagine.
   Condivisione file	Scegliere Selezionare un file, quindi passare alla condivisione file e alla directory in cui si trova l'immagine. Selezionare la casella accanto all'immagine che si desidera aggiungere, ad esempio MyApp.cim, quindi selezionare Seleziona.
   Pacchetto MSIX	Selezionare il pacchetto MSIX o Appx dall'immagine.
   Immettere UNC
   UNC	Immettere il percorso UNC del file di immagine.
   Pacchetto MSIX	Selezionare il pacchetto MSIX o Appx dall'immagine.
   Una delle 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 da usare.
   stato	Selezionare lo stato iniziale per il pacchetto.
   Stato del controllo di integrità in caso di errore	Selezionare lo stato del pacchetto se non riesce a eseguire un'installazione di appoggio in un host di sessione. Questo stato viene segnalato per AppAttachHealthCheck per lo stato del controllo di integrità dell'host di sessione.

   Dopo aver completato questa scheda, selezionare Avanti.

   Suggerimento

   Dopo aver completato questa scheda, è possibile continuare ad assegnare facoltativamente l'applicazione a pool di host, utenti e gruppi. In alternativa, se si desidera configurare separatamente le assegnazioni, selezionare Rivedere e creare, quindi passare ad Assegnare un pacchetto di montaggio app.

6. Facoltativo: nella scheda Assegnazioni completare le informazioni seguenti:

   1. Per Pool di host, selezionare i pool di host a cui si vuole assegnare l'applicazione. Se stai già usando app attach MSIX con un pool di host, non puoi selezionare quel pool di host poiché non è possibile usare entrambe le versioni di app attach con lo stesso pool di host.

   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. Esaminare le assegnazioni aggiunte, quindi selezionare Avanti.

7. Facoltativo: nella scheda Tag è possibile immettere qualsiasi coppia nome/valore necessaria, quindi selezionare Rivedere e creare.

8. Nella scheda Rivedere e creare 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 dell'app usando il modulo Az.DesktopVirtualization di PowerShell. Assicurarsi di modificare i valori di <placeholder> sostituendoli con i propri.

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

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

   • Se usi PowerShell in locale, accedi prima a Azure PowerShell, quindi assicurati che il contesto di Azure sia impostato sulla sottoscrizione che vuoi utilizzare.

2. Durante l'anteprima, verificare di disporre dei cmdlet di PowerShell disponibili eseguendo i comandi seguenti:

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

   L'output dovrebbe essere simile a quello 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à del pacchetto MSIX image, Appx image o App-V da aggiungere e archiviarle in una variabile eseguendo il comando seguente. È necessario specificare un pool di host, ma può trattarsi di 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 di disporre di un solo oggetto nelle proprietà dell'applicazione eseguendo i comandi seguenti:

   $app | FL *
   

   Facoltativo: se nell'output sono presenti più oggetti, ad esempio una versione x64 e x86 della stessa applicazione, è possibile usare 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 dell'app eseguendo il comando seguente. In questo esempio, lo stato dell'applicazione è contrassegnato come attivo, la registrazione dell'applicazione è impostata su su richiesta e lo stato del controllo di integrità dell'host di 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 esiste alcun output quando il pacchetto viene aggiunto correttamente.

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

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

   L'output deve 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 Azure Virtual Desktop, selezionare App attach, quindi selezionare il nome del pacchetto da assegnare.

2. Nella sezione Gestisci selezionare Pool di host:

3. Selezionare + Assegna, quindi selezionare uno o più pool di host nell'elenco a discesa. Assicurarsi che tutti gli host di sessione nel pool di host abbiano accesso in lettura con il proprio account computer, come elencato nei prerequisiti.

4. Selezionare Aggiungi.

Gruppi e utenti

1. Nella panoramica di Azure Virtual Desktop, selezionare App attach, quindi selezionare il nome del pacchetto da assegnare.

2. Nella sezione Gestisci selezionare 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 ai pool di host, ai gruppi e agli utenti usando il modulo Az.DesktopVirtualization di PowerShell.

Pool di host

1. Nella stessa sessione di PowerShell ottenere gli ID risorsa dei pool di 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. Dopo aver ottenuto gli ID risorsa dei pool di host, è possibile assegnare il pacchetto dell'applicazione a tali pool 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 usando i comandi seguenti:

   $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 di PowerShell.

1. Ottenere l'ID oggetto dei gruppi o utenti che si desidera aggiungere o rimuovere dall'applicazione e inserirli in un array utilizzando uno degli esempi seguenti. È consigliabile assegnare le applicazioni ai gruppi.

   1. Ottenere l'ID oggetto del gruppo o dei gruppi e aggiungerlo 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 aggiungerlo a una matrice eseguendo i comandi seguenti. In questo esempio viene usato il nome principale utente (UPN):

      # Add a comma-separated list of user principal names
      $users = "[email protected]","[email protected]"
      
      # 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. Dopo aver ottenuto gli ID oggetto degli utenti o dei gruppi, è possibile aggiungerli o rimuoverli dall'applicazione usando uno degli esempi seguenti, che assegna il ruolo RBAC Desktop Virtualization User.

   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 di registrazione e lo stato di un pacchetto usando il portale di Azure:

1. Nella panoramica di Azure Virtual Desktop, selezionare App attach. Verrà 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 di registrazione e lo stato di un pacchetto usando il modulo Az.DesktopVirtualization di PowerShell.

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

   1. Modificare il tipo di registrazione eseguendo il comando seguente. Impostare IsRegularRegistration su $true per Registrazione all'accesso o $false per Su richiesta.

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

   2. Modificare lo stato eseguendo il comando seguente. Impostare 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. Nella 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, quindi + Aggiungi. Assicurarsi di avere almeno un host sessione attivo 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 dell'applicazione	Selezionare Montaggio app dall'elenco a discesa. Per aggiungere le 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 applicazione	Immettere un identificatore univoco dell'applicazione.
   Nome visualizzato	Immettere un nome amichevole per l'applicazione destinato agli utenti.
   Descrizione	Immettere una descrizione per l'applicazione.

   Dopo aver completato questa scheda, selezionare Avanti.

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

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

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

   Dopo aver completato questa scheda, selezionare Rivedi e aggiungi.

5. Nella scheda Rivedi e aggiungi verificare che la convalida venga superata ed esaminare le informazioni usate 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 da 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 da 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 comandi seguenti:

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

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

1. Nella panoramica di Azure Virtual Desktop, selezionare App attach. Verrà 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. Sottoscrizione e Gruppo di risorse vengono prepopolati con i valori per il pacchetto corrente.

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

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

      1. Per Seleziona dall’account di archiviazione, seleziona l'account di archiviazione contenente l'immagine aggiornata. Scegliere Selezionare un file, quindi passare alla condivisione file e alla directory in cui si trova l'immagine. Selezionare la casella accanto all'immagine che si desidera aggiungere, ad esempio MyApp.cim, quindi selezionare Seleziona.
      2. Per Immettere UNC, immettere il percorso UNC del file di immagine.

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

4. Dopo aver completato i campi, selezionare Aggiorna.

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

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 di disporre di un solo oggetto nelle proprietà dell'applicazione eseguendo i comandi seguenti:

   $app | FL *
   

   Se nell'output sono presenti più oggetti, ad esempio una versione x64 e 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 allegato dell'app dal portale Azure:

1. Nella panoramica di Azure Virtual Desktop, selezionare App attach. Verrà visualizzato un elenco di tutti i pacchetti esistenti.

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

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

1. Nella stessa sessione di PowerShell eseguire il comando seguente per rimuovere il pacchetto contenente l'applicazione:

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

Ecco come aggiungere un'immagine MSIX usando il portale di Azure:

1. Accedere al portale di Azure.

2. Nella barra di ricerca digitare Desktop virtuale Azure e selezionare la voce del servizio corrispondente per andare alla panoramica di Desktop virtuale Azure.

3. Selezionare Pool di host, quindi selezionare il nome del pool di host a cui si vuole aggiungere un'immagine MSIX.

4. Nella panoramica del pool di host selezionare Pacchetti MSIX, quindi selezionare + Aggiungi.

5. Per Percorso dell'immagine MSIX, immettere un percorso UNC valido che punta all'immagine MSIX nella condivisione file, ad esempio \\fileshare\Apps\MyApp\MyApp.cim, quindi selezionare Aggiungi, che consente di controllare che il percorso sia valido.

6. Dopo aver verificato il percorso, vengono visualizzati altri campi. Completare le informazioni seguenti:

   Parametro	Descrizione
   Pacchetto MSIX	Selezionare il nome del pacchetto MSIX pertinente dal menu a discesa.
   Applicazioni pacchetto	Questa mostra App e non è configurabile.
   Nome visualizzato	Immettere un nome descrittivo per il pacchetto.
   Versione	Verificare che venga visualizzato il numero di versione previsto.
   Tipo di registrazione	Selezionare il tipo di registrazione da usare.
   stato	Selezionare lo stato iniziale per il pacchetto.

7. Dopo aver completato i campi, selezionare Aggiungi.

Ecco come aggiungere un pacchetto MSIX usando il modulo Az.DesktopVirtualization di PowerShell. Assicurarsi di modificare i valori di <placeholder> sostituendoli con i propri.

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

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

   • Se usi PowerShell in locale, accedi prima a Azure PowerShell, quindi assicurati che il contesto di Azure sia impostato sulla sottoscrizione che vuoi utilizzare.

2. Ottenere le proprietà dell'applicazione nell'immagine MSIX da aggiungere e archiviarle in una variabile eseguendo i comandi seguenti:

   # Get the properties of the MSIX image
   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       Uri = '<UNCaPathToFile>'
   }
   
   $app = Expand-AzWvdMsixImage @parameters
   

   L'output deve essere simile all'esempio seguente:

   Name
   ----
   hp01/expandmsiximage
   

3. Verificare di disporre di un solo oggetto nelle proprietà dell'applicazione eseguendo i comandi seguenti:

   $app | FL *
   

   Se nell'output sono presenti più oggetti, ad esempio una versione x64 e 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>'
       Uri = '<UNCPathToFile>'
   }
   
   $app = Expand-AzWvdMsixImage @parameters | ? PackageFullName -like *$packageFullName*
   

4. Aggiungere l'immagine MSIX a un pool di host eseguendo il comando seguente. In questo esempio, lo stato dell'applicazione è contrassegnato come attivo.

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       PackageAlias = $app.PackageAlias
       DisplayName = '<DisplayName>'
       ImagePath = $app.ImagePath
       IsActive = $true
   }
   
   New-AzWvdMsixPackage @parameters
   

   Non viene generato alcun output quando il pacchetto MSIX viene aggiunto con successo.

5. È possibile verificare che il pacchetto MSIX venga aggiunto eseguendo i comandi seguenti:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdMsixPackage @parameters | ? PackageFamilyName -eq $app.PackageFamilyName | FL *
   

   L'output deve essere simile all'esempio seguente:

   DisplayName                  : My App
   Id                           : /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/avd/providers/Microsoft.DesktopVirtualization/hostpools/hp01/msixpackages/MyApp_1.0.0.0_neutral__abcdef123ghij
   ImagePath                    : \\fileshare\Apps\MyApp\MyApp.cim
   IsActive                     : True
   IsRegularRegistration        : False
   LastUpdated                  : 7/27/2023 10:02:29 AM
   Name                         : hp01/MyApp_1.0.0.0_neutral__abcdef123ghij
   PackageApplication           : {MyApp}
   PackageDependency            : {}
   PackageFamilyName            : MyApp_abcdef123ghij
   PackageName                  : MyApp
   PackageRelativePath          : apps\MyApp_1.0.0.0_neutral__abcdef123ghij
   SystemDataCreatedAt          : 7/28/2023 9:04:00 AM
   SystemDataCreatedBy          : [email protected]
   SystemDataCreatedByType      : User
   SystemDataLastModifiedAt     : 7/28/2023 9:04:00 AM
   SystemDataLastModifiedBy     : [email protected]
   SystemDataLastModifiedByType : User
   Type                         : Microsoft.DesktopVirtualization/hostpools/msixpackages
   Version                      : 1.0.0.0
   

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

1. Nella panoramica di Desktop virtuale Azure selezionare Pool di host, quindi selezionare il nome del pool di host a cui viene aggiunto il pacchetto MSIX.

2. Nella panoramica del pool di host selezionare Pacchetti MSIX. Dovrebbe essere visualizzato un elenco di tutti i pacchetti MSIX esistenti all'interno del pool di host.

3. Selezionare il nome del pacchetto MSIX 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 di registrazione e lo stato di un pacchetto usando il modulo Az.DesktopVirtualization di PowerShell.

1. Nella stessa sessione di PowerShell ottenere un elenco di pacchetti MSIX in un pool di host e i relativi valori per il tipo di registrazione e lo stato correnti eseguendo i comandi seguenti:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdMsixPackage @parameters | Select-Object DisplayName, ImagePath, Name, Version, IsRegularRegistration, IsActive
   

   L'output deve essere simile all'esempio seguente:

   DisplayName ImagePath                        Name                                      Version IsRegularRegistration IsActive
   ----------- ---------                        -----------------                         ------- --------------------- --------
   My App      \\fileshare\Apps\MyApp\MyApp.cim hp01/MyApp_1.0.0.0_neutral__abcdef123ghij 1.0.0.0                 False     True
   

2. Trovare il pacchetto che si vuole rimuovere e usare il valore per il parametro Name, ma rimuovere il nome del pool di host e / all'inizio. Ad esempio, hp01/MyApp_1.0.0.0_neutral__abcdef123ghij diventa MyApp_1.0.0.0_neutral__abcdef123ghij. Ecco alcuni esempi:

   1. Modificare il tipo di registrazione eseguendo il comando seguente. Impostare IsRegularRegistration su $true per Registrazione all'accesso o $false per Su richiesta.

      $parameters = @{
          FullName = '<FullName>'
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          IsRegularRegistration = $true
      }
      
      Update-AzWvdMsixPackage @parameters
      

   2. Modificare lo stato eseguendo il comando seguente. Impostare IsActive su $true per Attivo o $false per Inattivo.

      $parameters = @{
          FullName = '<FullName>'
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          IsActive = $true
      }
      
      Update-AzWvdMsixPackage @parameters
      

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

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

2. Selezionare Applicazioni, quindi + Aggiungi. Assicurarsi di avere almeno un host sessione attivo nel pool di host a cui è assegnato il gruppo di applicazioni.

3. Nella scheda Informazioni di base, le opzioni visualizzate dipendono dal fatto che il gruppo di applicazioni è per Desktop o RemoteApp:

   1. Per un gruppo di applicazioni desktop, completare le informazioni seguenti:

      Parametro	Valore/Descrizione
      Origine dell'applicazione	Pacchetto MSIX viene selezionato automaticamente e disattivato.
      Pacchetto	Selezionare un pacchetto disponibile per il pool di host dall'elenco a discesa.
      Identificatore applicazione	Immettere un identificatore univoco dell'applicazione.
      Nome visualizzato	Immettere un nome amichevole per l'applicazione destinato agli utenti.
      Descrizione	Immettere una descrizione per l'applicazione.

      Dopo aver completato questa scheda, selezionare Rivedi e aggiungi.

   2. Per un gruppo di applicazioni RemoteApp, completare le informazioni seguenti:

      Parametro	Valore/Descrizione
      Origine dell'applicazione	Selezionare Montaggio app dall'elenco a discesa. Per aggiungere le 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 del pool di host provengono da MSIX app attach.
      Applicazione	Selezionare un'applicazione dall'elenco a discesa.
      Identificatore applicazione	Immettere un identificatore univoco dell'applicazione.
      Nome visualizzato	Immettere un nome amichevole per l'applicazione destinato agli utenti.
      Descrizione	Immettere una descrizione per l'applicazione.

      Dopo aver completato questa scheda, selezionare Avanti.

      Nella scheda Icona selezionare Predefinita per usare l'icona predefinita per l'applicazione oppure selezionare Percorso file per usare un'icona personalizzata. Per Percorso file, selezionare una delle opzioni seguenti:

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

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

      Dopo aver completato questa scheda, selezionare Rivedi e aggiungi.

4. Nella scheda Rivedi e aggiungi verificare che la convalida venga superata ed esaminare le informazioni usate per aggiungere l'applicazione, quindi selezionare Aggiungi per aggiungere l'applicazione al gruppo di applicazioni.

Ecco come aggiungere le applicazioni MSIX a un gruppo di applicazioni usando il modulo Az.DesktopVirtualization di PowerShell.

1. Nella stessa sessione di PowerShell aggiungere un'applicazione MSIX a un gruppo di applicazioni eseguendo i comandi in uno degli esempi seguenti.

   1. Per aggiungere un'applicazione MSIX a un gruppo di applicazioni desktop, eseguire i comandi seguenti:

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

   2. Per aggiungere un'applicazione MSIX a un gruppo di applicazioni RemoteApp, se nel pacchetto sono presenti più applicazioni, è necessario ottenere l'ID applicazione dell'applicazione da 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
      

      Prendere nota dell'ID applicazione da 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.PackageFamilyName
          MsixPackageApplicationId = '<ApplicationID>'
          GroupName = '<ApplicationGroupName>'
          ResourceGroupName = '<ResourceGroupName>'
          CommandLineSetting = 'DoNotAllow'
      }
      
      New-AzWvdApplication @parameters
      

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

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

Ecco come rimuovere un pacchetto MSIX dal pool di host usando il portale di Azure:

1. Nella panoramica di Desktop virtuale Azure selezionare Pool di host, quindi selezionare il nome del pool di host a cui viene aggiunto il pacchetto MSIX.

2. Nella panoramica del pool di host selezionare Pacchetti MSIX. Dovrebbe essere visualizzato un elenco di tutti i pacchetti MSIX esistenti all'interno del pool di host.

3. Selezionare la casella accanto al nome del pacchetto MSIX da rimuovere, quindi selezionare Rimuovi.

Ecco come rimuovere le applicazioni usando il modulo Az.DesktopVirtualization di PowerShell.

1. Nella stessa sessione di PowerShell ottenere un elenco di pacchetti MSIX in un pool di host eseguendo i comandi seguenti:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdMsixPackage @parameters | Select-Object DisplayName, ImagePath, PackageFamilyName, Version
   

   L'output deve essere simile all'esempio seguente:

   DisplayName ImagePath                        Name                                      Version
   ----------- ---------                        -----------------                         -------
   My App      \\fileshare\Apps\MyApp\MyApp.cim hp01/MyApp_1.0.0.0_neutral__abcdef123ghij 1.0.0.0
   

2. Trovare il pacchetto che si vuole rimuovere e usare il valore per il parametro Name, ma rimuovere il nome del pool di host e / all'inizio. Ad esempio, hp01/MyApp_1.0.0.0_neutral__abcdef123ghij diventa MyApp_1.0.0.0_neutral__abcdef123ghij. Rimuovere quindi il pacchetto eseguendo i comandi seguenti:

   $parameters = @{
       FullName = '<FullName>'
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Remove-AzWvdMsixPackage @parameters