Lägga till och hantera appanslutning och MSIX-appanslutningsprogram i Azure Virtual Desktop

Dricks

En ny version av appanslutning för Azure Virtual Desktop är tillgänglig. Välj en knapp överst i den här artikeln för att välja mellan appanslutning och MSIX-appanslutning för att se relevant dokumentation.

Med appanslutning kan du dynamiskt koppla program från ett programpaket till en användarsession i Azure Virtual Desktop. Program installeras inte lokalt på sessionsvärdar eller avbildningar, vilket gör att du kan skapa färre anpassade avbildningar för dina sessionsvärdar och minska driftkostnaderna och kostnaderna för din organisation. Genom att leverera program med appkoppling får du också större kontroll över vilka program som användarna kan komma åt i en fjärrsession.

Med MSIX-appanslutning kan du dynamiskt koppla program från ett programpaket till en användarsession i Azure Virtual Desktop. Program installeras inte lokalt på sessionsvärdar eller avbildningar, vilket gör det enklare att skapa anpassade avbildningar för dina sessionsvärdar och minska driftkostnaderna och kostnaderna för din organisation. Genom att leverera program med MSIX-appanslutning får du också större kontroll över vilka program som användarna kan komma åt i en fjärrsession.

Den här artikeln visar hur du lägger till och hanterar program med appanslutning i Azure Virtual Desktop med hjälp av Azure-portalen och Azure PowerShell. Du kan inte lägga till eller hantera program för appkoppling med Hjälp av Azure CLI. Innan du börjar bör du läsa översikten för appanslutning och MSIX-appanslutning i Azure Virtual Desktop.

Den här artikeln visar hur du lägger till och hanterar MSIX-paket med MSIX-appanslutning i Azure Virtual Desktop med hjälp av Azure-portalen och Azure PowerShell. Du kan inte lägga till eller hantera MSIX-appanslutningsprogram med Hjälp av Azure CLI. Innan du börjar bör du läsa översikten för appanslutning och MSIX-appanslutning i Azure Virtual Desktop.

Viktigt!

Du måste välja om du vill använda appanslutning eller MSIX-appanslutning med en värdpool. Du kan inte använda båda versionerna med samma värdpool.

Förutsättningar

För att kunna använda appkoppling i Azure Virtual Desktop behöver du följande:

För att kunna använda MSIX-appanslutning i Azure Virtual Desktop måste du uppfylla kraven:

• En befintlig värdpool med sessionsvärdar, en programgrupp och en arbetsyta.

• Sessionsvärdarna måste köra ett Windows-klientoperativsystem som stöds och minst en av dem måste vara påslagen. Windows Server stöds inte.

• Sessionsvärdarna måste vara anslutna till Microsoft Entra-ID eller en Usluge domena aktivnog direktorijuma domän (AD DS).

• Sessionsvärdarna måste vara anslutna till en Usluge domena aktivnog direktorijuma domän (AD DS). Microsoft Entra-ID stöds inte.

• Användarkonton måste vara hybridkonton (skapade i AD DS och synkroniserade med Microsoft Entra-ID). Grupper kan vara hybrid- eller Microsoft Entra-ID-grupper.

• En SMB-filresurs i samma Azure-region som dina sessionsvärdar. Alla sessionsvärdar i värdpoolen måste ha läsbehörighet med sitt datorkonto. Den här filresursen används för att lagra dina programbilder. Mer information om kraven för filresursen finns i Filresurs.

  Om du vill använda Azure Files när dina sessionsvärdar är anslutna till Microsoft Entra-ID måste du tilldela rollrollen läsare och dataåtkomst för Azure rollbaserad åtkomstkontroll (RBAC) till både Azure Virtual Desktop - och Azure Virtual Desktop ARM Provider-tjänstens huvudnamn. Information om hur du tilldelar en Azure RBAC-roll till tjänstens huvudnamn för Azure Virtual Desktop finns i Tilldela RBAC-roller till Tjänstens huvudnamn för Azure Virtual Desktop.

• En SMB-filresurs i samma Azure-region som dina sessionsvärdar. Alla sessionsvärdar i värdpoolen måste ha läsbehörighet med sitt datorkonto. Den här filresursen används för att lagra dina programbilder. Mer information om kraven för filresursen finns i Filresurs.

• En MSIX- eller Appx-diskbild som du skapade från ett programpaket och som lagras på filresursen. Mer information finns i Skapa en avbildning, där du också kan ladda ned ett fördefiniert MSIX-paket för testning.

• En MSIX-avbildning som du skapade från ett programpaket och som lagras på filresursen. Mer information finns i Skapa en avbildning, där du också kan ladda ned ett fördefiniert MSIX-paket för testning.

• Om du vill lägga till MSIX-avbildningar behöver du rollen Azure rollbaserad åtkomstkontroll (RBAC) för skrivbordsvirtualiseringsdeltagare som tilldelats resursgruppen som ett minimum. Om du vill tilldela användare till programgruppen behöver Microsoft.Authorization/roleAssignments/write du också behörigheter för programgruppen. Inbyggda RBAC-roller som innehåller den här behörigheten är administratör och ägare av användaråtkomst.

• Om du vill använda Azure PowerShell lokalt kan du läsa Använda Azure PowerShell med Azure Virtual Desktop för att se till att az.DesktopVirtualization- och Microsoft Graph PowerShell-modulerna är installerade. Du kan också använda Azure Cloud Shell.

• Du måste använda version 4.2.1 av PowerShell-modulen Az.DesktopVirtualization , som innehåller de cmdletar som stöder appanslutning. Du kan ladda ned och installera PowerShell-modulen Az.DesktopVirtualization från PowerShell-galleriet.

Viktigt!

• Alla MSIX- och Appx-programpaket innehåller ett certifikat. Du ansvarar för att se till att certifikaten är betrodda i din miljö. Självsignerade certifikat stöds med lämplig förtroendekedja.

• Du måste välja om du vill använda appanslutning eller MSIX-appanslutning med en värdpool. Du kan inte använda båda versionerna med samma paket i samma värdpool.

Viktigt!

Alla MSIX-programpaket innehåller ett certifikat. Du ansvarar för att se till att certifikaten är betrodda i din miljö. Självsignerade certifikat stöds med lämplig förtroendekedja.

Lägga till ett program

Om du vill lägga till ett program i en MSIX- eller Appx-avbildning i Azure Virtual Desktop som ett apkopplingspaket väljer du relevant flik för ditt scenario och följer stegen.

Portal

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

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 Översikt ö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	Description
   Prenumeration	Välj den prenumeration som du vill lägga till en MSIX- eller Appx-avbildning 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 appanslutningspaket.

   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	Description
   Bildsökväg	Välj från Välj från lagringskonto om avbildningen lagras i Azure Files eller Unc för indata 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.

   Dricks

   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: Fyll i följande information på fliken Tilldelningar :

   1. För Värdpool väljer du vilka värdpooler du vill tilldela programmet till. Om du redan använder MSIX-appanslutning med en värdpool kan du inte välja den värdpoolen eftersom du inte kan använda båda versionerna av appkoppling med samma värdpool.

   2. Välj Lägg till användare eller användargrupper och 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 de namn/värdepar du behöver och sedan välja Granska + skapa.

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

Azure PowerShell

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

1. Öppna Azure Cloud Shell i Azure-portalen 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 den avbildning 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 or Appx image
   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       Path = '<UNCPathToImageFile>'
   }
   
   $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 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 = '<UNCPathToImageFile>'
   }
   
   $app = Import-AzWvdAppAttachPackageInfo @parameters | ? ImagePackageFullName -like *$packageFullName*
   

5. Lägg till avbildningen 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 vid 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
   

Tilldela ett apkopplingspaket

Du måste tilldela ett appkopplingspaket till värdpooler samt grupper och användare. Välj relevant flik för ditt scenario och följ stegen.

Kommentar

Användarkonton måste vara hybridkonton (skapade i AD DS och synkroniserade med Azure AD), men grupper gör det inte.

Portal

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

Värdpooler

1. I översikten över Azure Virtual Desktop väljer du Bifoga app och väljer 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. Markera Lägga till.

Grupper och användare

1. I översikten över Azure Virtual Desktop väljer du Bifoga app och väljer 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.

Azure PowerShell

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

Viktigt!

De värdpools-ID:t som du anger varje gång skriver över alla befintliga tilldelningar. Om du vill lägga till eller ta bort en värdpool till eller från en befintlig lista över värdpooler måste du ange alla värdpooler som du vill tilldela programmet till.

1. I samma PowerShell-session hämtar du resurs-ID:t för värdpoolerna 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 avtilldela 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 i med 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ändarna och lägg till dem i en matris i 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 för skrivbordsvirtualiseringsanvändare.

   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 grupperna eller användarna 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
      }
      

Kommentar

Genom att lägga till ett paket, ställa in det på aktivt och tilldela det till en värdpool och användarna automatiskt gör programmet tillgängligt i en skrivbordssession. Om du vill använda RemoteApp måste du lägga till programmet i en RemoteApp-programgrupp. Mer information finns i Publicera ett MSIX- eller Appx-program med en RemoteApp-programgrupp. Du kan inte lägga till MSIX- eller Appx-program i skrivbordsprogramgruppen med appanslutning.

Ändra registreringstyp och tillstånd

Du kan hantera dina MSIX- och Appx-paket genom att ändra registreringstyp och status. Välj relevant flik för ditt scenario och följ stegen.

Portal

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

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 inloggning och väljer sedan Spara.

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

Azure PowerShell

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 tillstånd 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 $true för Aktiv eller $false För Inaktiv.

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

Publicera ett MSIX- eller Appx-program med en RemoteApp-programgrupp

Du kan göra MSIX- och Appx-program tillgängliga för användare genom att publicera dem med en RemoteApp-programgrupp. Du behöver inte lägga till program i en skrivbordsprogramgrupp när du använder appkoppling eftersom du bara behöver tilldela ett apkopplingspaket. Programmet som du vill publicera måste tilldelas till en värdpool.

Portal

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-portalen:

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 har tilldelats till.

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

   Parameter	Värde/beskrivning
   Programkälla	Välj Appanslutning i listrutan. Om du vill lägga till program från „Start“ meni 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 appanslutning.
   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 bland Azure Files för att använda en ikon från en Azure-filresurs. Välj Välj ett lagringskonto och välj lagringskontot som innehåller din ikonfil och välj sedan Välj ikonfil. Bläddra till filresursen och katalogen som ikonen är 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.

Azure PowerShell

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 programgruppen RemoteApp:

   $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
   

Uppdatera ett befintligt paket

Du kan uppdatera ett befintligt paket genom att ange en ny avbildning som innehåller det uppdaterade programmet. Mer information finns i Nya versioner av program.

Om du vill uppdatera ett befintligt paket på plats väljer du relevant flik för ditt scenario och följer stegen.

Portal

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

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 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 Indata-UNC. 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-paketet väljer du MSIX- eller Appx-paketet från avbildningen.

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

Azure PowerShell

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 = '<UNCPathToImageFile>'
   }
   
   $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 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 = '<UNCPathToImageFile>'
   }
   
   $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
   

Ta bort ett apkopplingspaket

Du kan ta bort ett appkopplingspaket som du inte längre behöver. Du behöver inte ta bort tilldelningen av värdpooler eller användare och grupper först. Välj relevant flik för ditt scenario och följ stegen.

Dricks

Du kan också ta bort ett program i ett MSIX-paket som publicerats som en RemoteApp från en programgrupp på samma sätt som andra programtyper. Mer information finns i Ta bort program.

Portal

Så här tar du bort ett appkopplingspaket med hjälp av Azure-portalen:

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 har tilldelats till.

Azure PowerShell

Så här tar du bort ett appkopplingspaket 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
   

Lägga till en MSIX-avbildning i en värdpool

Om du vill lägga till en MSIX-avbildning i en värdpool väljer du relevant flik för ditt scenario och följer stegen.

Portal

Så här lägger du till en MSIX-avbildning med hjälp av Azure-portalen:

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 Översikt över Azure Virtual Desktop.

3. Välj Värdpooler och välj sedan namnet på den värdpool som du vill lägga till en MSIX-avbildning i.

4. I översikten över värdpoolen väljer du MSIX-paket och sedan + Lägg till.

5. För MSIX-avbildningssökväg anger du en giltig UNC-sökväg som pekar på MSIX-avbildningen på filresursen, \\fileshare\Apps\MyApp\MyApp.cimtill exempel , och väljer sedan Lägg till, som kontrollerar att sökvägen är giltig.

6. När sökvägen har verifierats visas fler fält. Fyll i följande information:

   Parameter	Description
   MSIX-paket	Välj det relevanta MSIX-paketnamnet i den nedrullningsbara menyn.
   Paketprogram	Det här visar Appen och kan inte konfigureras.
   Visningsnamn	Ange ett eget namn för paketet.
   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.

7. När du har slutfört fälten väljer du Lägg till.

Azure PowerShell

Så här lägger du till ett MSIX-paket med hjälp av PowerShell-modulen Az.DesktopVirtualization . Se till att ändra <placeholder> värdena för dina egna.

1. Öppna Azure Cloud Shell i Azure-portalen 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. Hämta egenskaperna för programmet i den MSIX-avbildning som du vill lägga till och lagra dem i en variabel genom att köra följande kommandon:

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

   Utdata bör likna följande exempel:

   Name
   ----
   hp01/expandmsiximage
   

3. 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 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>'
       Uri = '<UNCPathToImageFile>'
   }
   
   $app = Expand-AzWvdMsixImage @parameters | ? PackageFullName -like *$packageFullName*
   

4. Lägg till MSIX-avbildningen i en värdpool genom att köra följande kommando. I det här exemplet markeras programtillståndet som aktivt.

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

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

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

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

   Utdata bör likna följande exempel:

   DisplayName                  : My App
   Id                           : /subscriptions/00000000-0000-0000-0000-000000000000/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          : avdadmin@contoso.com
   SystemDataCreatedByType      : User
   SystemDataLastModifiedAt     : 7/28/2023 9:04:00 AM
   SystemDataLastModifiedBy     : avdadmin@contoso.com
   SystemDataLastModifiedByType : User
   Type                         : Microsoft.DesktopVirtualization/hostpools/msixpackages
   Version                      : 1.0.0.0
   

Ändra registreringstyp och tillstånd

Du kan hantera MSIX-paket i värdpoolen genom att ändra deras registreringstyp och tillstånd. Välj relevant flik för ditt scenario och följ stegen.

Portal

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

1. I översikten över Azure Virtual Desktop väljer du Värdpooler och sedan namnet på värdpoolen som MSIX-paketet läggs till i.

2. I översikten över värdpoolen väljer du MSIX-paket. Du bör se en lista över alla befintliga MSIX-paket i värdpoolen.

3. Välj namnet på det MSIX-paket som du vill ändra.

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

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

Azure PowerShell

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

1. I samma PowerShell-session hämtar du en lista över MSIX-paket på en värdpool och deras aktuella registreringstyp och tillstånd genom att köra följande kommandon:

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

   Utdata bör likna följande exempel:

   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. Leta reda på det paket som du vill ta bort och använd värdet för parametern Name , men ta bort värdpoolens namn och / från början. Till exempel kommer hp01/MyApp_1.0.0.0_neutral__abcdef123ghij att bli MyApp_1.0.0.0_neutral__abcdef123ghij. Här är några exempel.

   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 = @{
          FullName = '<FullName>'
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          IsRegularRegistration = $true
      }
      
      Update-AzWvdMsixPackage @parameters
      

   2. Ändra tillståndet genom att köra följande kommando. Ange IsActive till $true för Aktiv eller $false För Inaktiv.

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

Publicera ett MSIX-program

Du kan göra MSIX-program tillgängliga för användare som en del av en skrivbords- eller RemoteApp-programgrupp. En skrivbordsprogramgrupp gör programmen tillgängliga på en användares startmeny, medan en RemoteApp-programgrupp innebär att en användare kan strömma dem individuellt. Mer information om programgrupper finns i Terminologi. Välj relevant flik för ditt scenario och följ stegen.

Portal

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-portalen:

1. I översikten över Azure Virtual Desktop väljer du Programgrupper och sedan den skrivbords- eller 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 har tilldelats till.

3. På fliken Grundläggande inställningar beror de alternativ du ser på om din programgrupp är för ett skrivbord eller en RemoteApp:

   1. För en skrivbordsprogramgrupp fyller du i följande information:

      Parameter	Värde/beskrivning
      Programkälla	MSIX-paketet väljs automatiskt och är nedtonat.
      Paket	Välj ett paket som är tillgängligt för värdpoolen 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 Granska + lägg till.

   2. För en RemoteApp-programgrupp fyller du i följande information:

      Parameter	Värde/beskrivning
      Programkälla	Välj Appanslutning i listrutan. Om du vill lägga till program från „Start“ meni 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. Värdpoolpaketen kommer från MSIX-appanslutningen.
      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.

      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 bland Azure Files för att använda en ikon från en Azure-filresurs. Välj Välj ett lagringskonto och välj lagringskontot som innehåller din ikonfil och välj sedan Välj ikonfil. Bläddra till filresursen och katalogen som ikonen är 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.

4. På fliken Granska + lägg till kontrollerar du att valideringen 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.

Azure PowerShell

Så här lägger du till MSIX-program i en programgrupp med hjälp av PowerShell-modulen Az.DesktopVirtualization .

1. I samma PowerShell-session lägger du till ett MSIX-program i en programgrupp genom att köra kommandona i något av följande exempel.

   1. Om du vill lägga till ett MSIX-program i en skrivbordsprogramgrupp kör du följande kommandon:

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

   2. Om du vill lägga till ett MSIX-program i en RemoteApp-programgrupp 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 om det finns flera program i paketet:

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

      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 programgruppen RemoteApp:

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

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

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

Ta bort ett MSIX-paket

Du kan ta bort ett MSIX-paket som du inte längre behöver. Välj relevant flik för ditt scenario och följ stegen.

Dricks

Du kan också bara ta bort ett program i ett MSIX-paket från en programgrupp på samma sätt som andra programtyper. Mer information finns i Ta bort program.

Portal

Så här tar du bort ett MSIX-paket från värdpoolen med hjälp av Azure-portalen:

1. I översikten över Azure Virtual Desktop väljer du Värdpooler och sedan namnet på värdpoolen som MSIX-paketet läggs till i.

2. I översikten över värdpoolen väljer du MSIX-paket. Du bör se en lista över alla befintliga MSIX-paket i värdpoolen.

3. Markera kryssrutan bredvid namnet på det MSIX-paket som du vill ta bort och välj sedan Ta bort.

Azure PowerShell

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

1. I samma PowerShell-session hämtar du en lista över MSIX-paket i en värdpool genom att köra följande kommandon:

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

   Utdata bör likna följande exempel:

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

2. Leta reda på det paket som du vill ta bort och använd värdet för parametern Name , men ta bort värdpoolens namn och / från början. Till exempel kommer hp01/MyApp_1.0.0.0_neutral__abcdef123ghij att bli MyApp_1.0.0.0_neutral__abcdef123ghij. Ta sedan bort paketet genom att köra följande kommandon:

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

Inaktivera automatiska uppdateringar

Vi rekommenderar att du inaktiverar automatiska uppdateringar för MSIX- och Appx-program. Om du vill inaktivera automatiska uppdateringar måste du ange följande registervärden på sessionsvärdarna:

Vi rekommenderar att du inaktiverar automatiska uppdateringar för MSIX-program. Om du vill inaktivera automatiska uppdateringar måste du ange följande registervärden på sessionsvärdarna:

• Nyckel: HKLM\Software\Policies\Microsoft\WindowsStore

  • Typ: DWORD
  • Namn: Ladda ned automatiskt
  • Värde: 2
  • Beskrivning: Inaktiverar automatisk uppdatering i Microsoft Store.

• Nyckel: HKCU\Software\Microsoft\Windows\CurrentVersion\ContentDeliveryManager

  • Typ: DWORD
  • Namn: PreInstalledAppsEnabled
  • Värde: 0
  • Beskrivning: Inaktiverar automatisk nedladdning av innehållsleverans.

• Nyckel: HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\ContentDeliveryManager\Debug

  • Typ: DWORD
  • Namn: ContentDeliveryAllowedOverride
  • Värde: 2
  • Beskrivning: Inaktiverar automatisk nedladdning av innehållsleverans.

Du kan ange dessa registervärden med hjälp av grupprincip eller Intune, beroende på hur dina sessionsvärdar hanteras. Du kan också ange dem genom att köra följande PowerShell-kommandon som administratör på varje sessionsvärd, men om du gör det bör du också ange dem i operativsystemavbildningen:

# Disable Microsoft Store automatic update
If (!(Test-Path "HKLM:\Software\Policies\Microsoft\WindowsStore")) {
    New-Item -Path "HKLM:\Software\Policies\Microsoft\WindowsStore" -Force
}
New-ItemProperty -Path "HKLM:\Software\Policies\Microsoft\WindowsStore" -Name AutoDownload -PropertyType DWORD -Value 2 -Force

# Disable content delivery automatic download
If (!(Test-Path "HKCU:\Software\Microsoft\Windows\CurrentVersion\ContentDeliveryManager")) {
    New-Item -Path "HKCU:\Software\Microsoft\Windows\CurrentVersion\ContentDeliveryManager" -Force
}
New-ItemProperty -Path "HKCU:\Software\Microsoft\Windows\CurrentVersion\ContentDeliveryManager" -Name PreInstalledAppsEnabled -PropertyType DWORD -Value 0 -Force

# Disables content delivery automatic download
If (!(Test-Path "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\ContentDeliveryManager\Debug")) {
    New-Item -Path "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\ContentDeliveryManager\Debug" -Force
}
New-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\ContentDeliveryManager\Debug" -Name ContentDeliveryAllowedOverride -PropertyType DWORD -Value 2 -Force

Nästa steg

Lär dig hur du publicerar program från Start-menyn eller en filsökväg med RemoteApp. Mer information finns i Publicera program.