Lägga till och hantera appkopplingsprogram i Azure Virtual Desktop

Så här lägger du till en MSIX-bild, Appx-avbildning eller App-V-paket som ett App Attach -paket 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 matchande tjänstpost för att gå till översikten över Azure Virtual Desktop.

3. Välj Appkoppling och sedan + Skapa.

4. Fyll i följande information på fliken Grundläggande :

   Parameter	Beskrivning
   Prenumeration	Välj den prenumeration som du vill lägga till en MSIX-avbildning, Appx-avbildning eller App-V-paket till i 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 regionen Azure för ditt App Attach -paket. Paketets distributionsomfång ärvs från värdpoolen du väljer, och för en värdpool med distributionsomfånget Regional måste platsen matcha värdpoolens Azure region.

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

5. Fyll i följande information på fliken Bildsökväg :

   Parameter	Beskrivning
   Bildsökväg	Välj från Välj från lagringskonto om bilden lagras i Azure Files eller Input UNC för att ange en UNC-sökväg. De efterföljande fälten beror på vilket alternativ du väljer.
   Välj från lagringskonto
   Lagringskonto	Välj det lagringskonto som bilden finns i.
   Filresurs	Välj en fil och bläddra sedan till den filresurs och katalog som bilden finns i. Markera till exempel MyApp.cimkryssrutan bredvid den bild du vill lägga till och välj sedan Välj.
   MSIX-paket	Välj MSIX- eller Appx-paketet från avbildningen.
   Indata UNC
   UNC	Ange UNC-sökvägen till bildfilen.
   MSIX-paket	Välj MSIX- eller Appx-paketet från avbildningen.
   Antingen alternativ
   Visningsnamn	Ange ett eget namn för programmet.
   Version	Kontrollera att det förväntade versionsnumret visas.
   Typ av registrering	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 kan mellanlagras på en sessionsvärd. Den här statusen rapporteras för AppAttachHealthCheck för hälsokontrollstatus för sessionsvärden.

   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 valfritt 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 appbifogat paket.

6. Valfritt: Fyll i följande information på fliken Uppgifter :

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

   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 uppgifter som du har lagt till och välj sedan Nästa.

7. Valfritt: På fliken Taggar kan du ange alla namn/värde-par 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 App Bifoga-paket med hjälp av PowerShell-modulen Az.DesktopVirtualization . Se till att ändra värdena <placeholder> för dina egna.

1. Öppna Azure Cloud Shell i Azure Portal med PowerShell-terminalen eller kör PowerShell på den lokala enheten.

   • Om du använder Cloud Shell kontrollerar du att din Azure kontext ä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 din Azure-kontext är inställd på den prenumeration som du vill använda.

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

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

   Det bör se ut ungefär så här:

   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 App Attach -paket genom att köra följande kommando. I det här exemplet är programtillståndet markerat som aktivt, programregistreringen är inställd på on-demand och hälsokontrollstatus för sessionsvärden vid fel anges till 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 se ut ungefär som i 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 Appkoppling och sedan namnet på det App Attach paket 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 listan i kraven.
   Du kan bara tilldela ett paket till värdpooler med samma distributionsomfång, och värdpooler med ett annat distributionsomfång är nedtonade i listan.

4. Välj Lägg till.

Grupper och användare

1. I översikten över Azure Virtual Desktop väljer du Appkoppling och sedan namnet på det App Attach paket 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 till 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 för de grupper eller användare du vill lägga till 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 till 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 för 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:na för användare eller grupper kan du lägga till eller ta bort dem från programmet med hjälp av något av följande exempel, som tilldelar RBAC-rollen Desktop Virtualization User RBAC-rollen.

   1. Lägg till grupper eller användare i programmet genom att köra 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 från 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 Appkoppling. 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 vid inloggning och väljer sedan Spara.

   2. Om du vill ändra status väljer du Inaktiv eller Aktiv och väljer 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 tillstånd genom att köra följande kommandon:

   1. Ändra registreringstypen genom att köra följande kommando. Ange IsRegularRegistration till $trueför Registrera vid inloggning eller $false för 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 som $trueaktiv 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 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 och välj + Lägg till. Kontrollera att du har minst en sessionsvärd påslagen i värdpoolen som programgruppen är tilldelad till.

3. Fyll i följande information på fliken Grundläggande :

   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.
   Förpackning	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 ska användas av 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 om du vill använda standardikonen för programmet eller väljer Filsökväg om du vill använda en anpassad ikon. Välj något av följande alternativ under Filsökväg:

   • Bläddra i Azure Files för att använda en ikon från en Azure-filresurs. Välj Välj ett lagringskonto och välj det lagringskonto som innehåller ikonfilen och välj sedan Välj ikonfil. Bläddra till den filresurs och katalog där ikonen finns, markera kryssrutan bredvid den ikon som du vill lägga till, till exempel MyApp.ico. Välj sedan Välj. Du kan också använda en .png fil. Under Ikonindex anger du indexnumret för den ikon som du vill använda. Talet är vanligen 0.

   • UNC-filsökväg om du vill 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. Under Ikonindex anger du indexnumret för den ikon som du vill använda. Talet är vanligen 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 RemoteApp-programgruppen.

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. Verifiera listan med 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 Azure Portal:

1. I översikten över Azure Virtual Desktop väljer du Appkoppling. En lista över alla befintliga paket visas.

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. Prenumeration och resursgrupp är förifyllda 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. De efterföljande fälten beror på vilket alternativ du väljer.

      1. För Välj från lagringskonto väljer du det lagringskonto som innehåller den uppdaterade avbildningen. Välj en fil och bläddra sedan till den filresurs och katalog som bilden finns i. Markera till exempel MyApp.cimkryssrutan bredvid den bild du vill lägga till och välj sedan Välj.
      2. För Indata-UNC anger du UNC-sökvägen till din bildfil.

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

4. När du har fyllt i 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 vilket 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 diskavbildningen 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 paket med appkoppling med Azure Portal:

1. I översikten över Azure Virtual Desktop väljer du Appkoppling. En lista över alla befintliga paket visas.

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 appanslutningspaket 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