Lägga till och hantera program för appkoppling i Azure Virtual Desktop

Så här lägger du till en MSIX-avbildning, Appx-avbildning eller App-V-paket som ett apkopplingspaket med hjälp av Azure Portal:

1. Logga in på Azure-portalen.

2. I sökfältet skriver du Azure Virtual Desktop och väljer den matchande tjänstposten för att gå till översikten över Azure Virtual Desktop.

3. Välj Bifoga app och välj sedan + Skapa.

4. På fliken Grundläggande fyller du i följande information:

   Parameter	Beskrivning
   Prenumeration	Välj den prenumeration som du vill lägga till en MSIX-avbildning, Appx-avbildning eller App-V-paket i från listrutan.
   Resursgrupp	Välj en befintlig resursgrupp eller välj Skapa ny och ange ett namn.
   Värdpool	Välj en befintlig värdpool i listrutan.
   Plats	Välj Azure-regionen för ditt apkopplingspaket.

   När du har slutfört den här fliken väljer du Nästa.

5. På fliken Bildsökväg fyller du i följande information:

   Parameter	Beskrivning
   Bildsökväg	Välj från Välj från lagringskonto om avbildningen lagras i Azure Files eller UNC för att ange en UNC-sökväg. Efterföljande fält beror på vilket alternativ du väljer.
   Välj från lagringskonto
   Lagringskonto	Välj det lagringskonto som avbildningen finns i.
   Filresurs	Välj Välj en fil och bläddra sedan till filresursen och katalogen som avbildningen finns i. Markera kryssrutan bredvid den bild som du vill lägga till, till exempel MyApp.cimoch välj sedan Välj.
   MSIX-paket	Välj MSIX- eller Appx-paketet från avbildningen.
   Unc-indata
   UNC	Ange UNC-sökvägen till bildfilen.
   MSIX-paket	Välj MSIX- eller Appx-paketet från avbildningen.
   Båda alternativen
   Visningsnamn	Ange ett eget namn för ditt program.
   Version	Kontrollera att det förväntade versionsnumret visas.
   Registreringstyp	Välj den registreringstyp som du vill använda.
   Tillstånd	Välj det ursprungliga tillståndet för paketet.
   Hälsokontrollstatus vid fel	Välj status för paketet om det inte går att mellanlagra på en sessionsvärd. Den här statusen rapporteras för AppAttachHealthCheck för sessionsvärdens hälsokontrollstatus.

   När du har slutfört den här fliken väljer du Nästa.

   Tips

   När du har slutfört den här fliken kan du fortsätta att tilldela programmet till värdpooler, användare och grupper. Om du vill konfigurera tilldelningar separat väljer du Granska + skapa och går sedan till Tilldela ett apkopplingspaket.

6. Valfritt: På fliken Tilldelningar fyller du i följande information:

   1. För Värdpool väljer du vilka värdpooler du vill tilldela programmet till.

   2. Välj Lägg till användare eller användargrupper, sök sedan efter och välj de användare eller grupper som du vill tilldela programmet till. När du är klar väljer du Välj.

   3. Granska de tilldelningar som du har lagt till och välj sedan Nästa.

7. Valfritt: På fliken Taggar kan du ange alla namn/värdepar som du behöver och sedan välja Granska + skapa.

8. På fliken Granska + skapa kontrollerar du att verifieringen godkänns och granskar den information som används under distributionen och väljer sedan Skapa för att lägga till programmet.

Så här lägger du till en MSIX-avbildning, Appx-avbildning eller App-V-paket som ett apkopplingspaket med hjälp av Modulen Az.DesktopVirtualization PowerShell. Se till att ändra <placeholder> värdena för dina egna.

1. Öppna Azure Cloud Shell i Azure Portal med PowerShell-terminaltypen eller kör PowerShell på din lokala enhet.

   • Om du använder Cloud Shell kontrollerar du att Azure-kontexten är inställd på den prenumeration som du vill använda.

   • Om du använder PowerShell lokalt loggar du först in med Azure PowerShell och kontrollerar sedan att Azure-kontexten är inställd på den prenumeration som du vill använda.

2. Under förhandsversionen kontrollerar du att PowerShell-cmdletarna är tillgängliga genom att köra följande kommandon:

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

   Dina utdata bör likna följande utdata:

   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. Hämta egenskaperna för MSIX-avbildningen, Appx-avbildningen eller App-V-paketet som du vill lägga till och lagra dem i en variabel genom att köra följande kommando. Du måste ange en värdpool, men det kan vara vilken värdpool som helst där sessionsvärdar har åtkomst till filresursen.

   # 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. Kontrollera att du bara har ett objekt i programegenskaperna genom att köra följande kommandon:

   $app | FL *
   

   Valfritt: om du har fler än ett objekt i utdata, till exempel en x64- och en x86-version av samma program, kan du använda parametern PackageFullName för att ange vilket program du vill lägga till genom att köra följande kommandon:

   # 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. Lägg till avbildningen eller paketet som ett apkopplingspaket genom att köra följande kommando. I det här exemplet markeras programtillståndet som aktivt, programregistreringen är inställd på på begäran och sessionsvärdens hälsokontrollstatus för fel är inställd på NeedsAssistance:

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

   Det finns inga utdata när paketet har lagts till.

6. Du kan kontrollera att paketet har lagts till genom att köra följande kommandon:

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

   Utdata bör likna följande exempel:

   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
   

Så här tilldelar du ett programpaket till värdpooler, användare och grupper med hjälp av Azure Portal:

Värdpooler

1. I översikten över Azure Virtual Desktop väljer du App attach (Appanslutning) och sedan namnet på det appkopplingspaket som du vill tilldela.

2. I avsnittet Hantera väljer du Värdpooler:

3. Välj + Tilldela och välj sedan en eller flera värdpooler i listrutan. Kontrollera att alla sessionsvärdar i värdpoolen måste ha läsbehörighet med sitt datorkonto, enligt kraven.

4. Välj Lägg till.

Grupper och användare

1. I översikten över Azure Virtual Desktop väljer du App attach (Appanslutning) och sedan namnet på det appkopplingspaket som du vill tilldela.

2. I avsnittet Hantera väljer du Användare:

3. Välj + Lägg till och välj sedan en eller flera grupper och/eller användare i listan.

4. Välj Välj.

Så här tilldelar du ett programpaket till värdpooler samt grupper och användare med hjälp av PowerShell-modulen Az.DesktopVirtualization .

Värdpooler

1. I samma PowerShell-session hämtar du resurs-ID:t för de värdpooler som du vill tilldela programmet till och lägger till dem i en matris i genom att köra följande kommandon:

   # 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. När du har resurs-ID:t för värdpoolerna kan du tilldela programpaketet till dem genom att köra följande kommandon:

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

3. Om du vill ta bort tilldelningen av programpaketet från alla värdpooler kan du skicka en tom matris med värdpooler genom att köra följande kommandon:

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

Grupper och användare

Så här tilldelar du ett program till grupper och användare med hjälp av PowerShell-modulen Az.DesktopVirtualization .

1. Hämta objekt-ID:t för de grupper eller användare som du vill lägga till i eller ta bort från programmet och lägg till dem i en matris med hjälp av något av följande exempel. Vi rekommenderar att du tilldelar program till grupper.

   1. Hämta objekt-ID för gruppen eller grupperna och lägg till dem i en matris genom att köra följande kommandon. I det här exemplet används gruppens visningsnamn:

      # 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. Hämta objekt-ID:t för användaren/användarna och lägg till dem i en matris genom att köra följande kommandon. I det här exemplet används användarens huvudnamn (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. När du har objekt-ID:t för användare eller grupper kan du lägga till dem i eller ta bort dem från programmet med hjälp av något av följande exempel, som tilldelar RBAC-rollen Desktop Virtualization User .

   1. Om du vill lägga till grupper eller användare i programmet kör du följande kommandon:

      $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. Om du vill ta bort grupper eller användare till programmet kör du följande kommandon:

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

Så här ändrar du ett pakets registreringstyp och tillstånd med hjälp av Azure Portal:

1. I översikten över Azure Virtual Desktop väljer du Bifoga app. Du bör se en lista över alla befintliga paket i värdpoolen.

2. Välj namnet på det paket som du vill ändra.

   1. Om du vill ändra registreringstypen väljer du På begäran eller Registrera dig vid inloggningen och väljer sedan Spara.

   2. Om du vill ändra tillståndet väljer du Inaktiv eller Aktiv och sedan Spara.

Så här ändrar du ett pakets registreringstyp och tillstånd med hjälp av PowerShell-modulen Az.DesktopVirtualization .

1. I samma PowerShell-session kan du ändra registreringstyp och status genom att köra följande kommandon:

   1. Ändra registreringstypen genom att köra följande kommando. Ange IsRegularRegistration till $true för Registrera vid inloggning eller $false på begäran.

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

   2. Ändra tillståndet genom att köra följande kommando. Ange IsActive till $trueför Aktiv eller $falseInaktiv.

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

Så här lägger du till ett program från paketet som du lade till i den här artikeln i en RemoteApp-programgrupp med hjälp av Azure Portal:

1. I översikten över Azure Virtual Desktop väljer du Programgrupper och sedan den RemoteApp-programgrupp som du vill lägga till ett program i.

2. Välj Program, välj + Lägg till. Kontrollera att du har minst en sessionsvärd påslagen i värdpoolen som programgruppen är tilldelad till.

3. På fliken Grundläggande fyller du i följande information:

   Parameter	Värde/beskrivning
   Programkälla	Välj Appkoppling i listrutan. Om du vill lägga till program från Start-menyn eller genom att ange en filsökväg kan du läsa Publicera program med RemoteApp.
   Paket	Välj ett paket som är tillgängligt för värdpoolen i listrutan. Regionala paket kommer från App Attach.
   Program	Välj ett program i listrutan.
   Programidentifierare	Ange en unik identifierare för programmet.
   Visningsnamn	Ange ett eget namn för programmet som är till användarna.
   Beskrivning	Ange en beskrivning för programmet.

   När du har slutfört den här fliken väljer du Nästa.

4. På fliken Ikon väljer du Standard för att använda standardikonen för programmet eller väljer Filsökväg för att använda en anpassad ikon. För Filsökväg väljer du något av följande alternativ:

   • Bläddra Azure Files om du vill använda en ikon från en Azure-filresurs. Välj Välj ett lagringskonto och välj det lagringskonto som innehåller din ikonfil och välj sedan Välj ikonfil. Bläddra till filresursen och katalogen som ikonen finns i, markera kryssrutan bredvid ikonen som du vill lägga till, till exempel MyApp.icooch välj sedan Välj. Du kan också använda en .png fil. För Ikonindex anger du indexnumret för den ikon som du vill använda. Det här talet är vanligtvis 0.

   • UNC-filsökväg för att använda en ikon från en filresurs. För Ikonsökväg anger du UNC-sökvägen till din ikonfil, till exempel \\MyFileShare\MyApp.ico. Du kan också använda en .png fil. För Ikonindex anger du indexnumret för den ikon som du vill använda. Det här talet är vanligtvis 0.

   När du har slutfört den här fliken väljer du Granska + lägg till.

5. På fliken Granska + lägg till kontrollerar du att verifieringen godkänns och granskar den information som används för att lägga till programmet och väljer sedan Lägg till för att lägga till programmet i programgruppen RemoteApp.

Så här lägger du till ett program från paketet som du lade till i den här artikeln i en RemoteApp-programgrupp med hjälp av PowerShell-modulen Az.DesktopVirtualization .

1. Om det finns flera program i paketet i samma PowerShell-session måste du hämta program-ID:t för det program som du vill lägga till från paketet genom att köra följande kommandon:

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

2. Anteckna det program-ID som du vill publicera (till exempel App) och kör sedan följande kommandon för att lägga till programmet i RemoteApp-programgruppen:

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

3. Kontrollera listan över program i programgruppen genom att köra följande kommandon:

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

Så här uppdaterar du ett befintligt paket med hjälp av Azure Portal:

1. I översikten över Azure Virtual Desktop väljer du Bifoga app. Du bör se en lista över alla befintliga paket.

2. Välj det paket som du vill uppdatera och välj sedan Uppdatera i översikten.

3. Ange informationen för det uppdaterade paketet:

   1. Prenumerationen och resursgruppen fylls i i förväg med värdena för det aktuella paketet.

   2. Välj den värdpool som du vill uppdatera paketet för.

   3. Välj bildsökvägen från Välj från lagringskonto eller Unc-indata. Efterföljande fält beror på vilket alternativ du väljer.

      1. För Välj från lagringskonto väljer du lagringskontot som innehåller den uppdaterade avbildningen. Välj Välj en fil och bläddra sedan till filresursen och katalogen som avbildningen finns i. Markera kryssrutan bredvid den bild som du vill lägga till, till exempel MyApp.cimoch välj sedan Välj.
      2. För Unc-indata anger du UNC-sökvägen till bildfilen.

   4. För MSIX-paket väljer du MSIX- eller Appx-paketet från avbildningen.

4. När du har slutfört fälten väljer du Uppdatera.

Så här uppdaterar du ett befintligt paket med hjälp av PowerShell-modulen Az.DesktopVirtualization .

1. I samma PowerShell-session hämtar du egenskaperna för det uppdaterade programmet och lagrar dem i en variabel genom att köra följande kommandon:

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

2. Kontrollera att du bara har ett objekt i programegenskaperna genom att köra följande kommandon:

   $app | FL *
   

   Om du har fler än ett objekt i utdata, till exempel en x64- och en x86-version av samma program, kan du använda parametern PackageFullName för att ange vilken du vill lägga till genom att köra följande kommandon:

   # 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. Uppdatera ett befintligt paket genom att köra följande kommando. Den nya diskbilden ersätter den befintliga, men befintliga tilldelningar behålls. Ta inte bort den befintliga avbildningen förrän användarna har slutat använda den.

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

Så här tar du bort ett apkopplingspaket med hjälp av Azure Portal:

1. I översikten över Azure Virtual Desktop väljer du Bifoga app. Du bör se en lista över alla befintliga paket.

2. Markera kryssrutan bredvid namnet på det paket som du vill ta bort och välj sedan Ta bort. Paketet tas också bort från alla värdpooler som det är tilldelat till.

Så här tar du bort ett apkopplingspaket med hjälp av PowerShell-modulen Az.DesktopVirtualization .

1. I samma PowerShell-session kör du följande kommando för att ta bort paketet som innehåller ett program:

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