App Attach-toepassingen toevoegen en beheren in Azure Virtual Desktop

U kunt als volgt een MSIX-installatiekopieën, Appx-installatiekopieën of App-V-pakket toevoegen als een app-bijlagepakket met behulp van de Azure Portal:

1. Meld u aan bij Azure Portal.

2. Typ Azure Virtual Desktop in de zoekbalk en selecteer de overeenkomende servicevermelding om naar het overzicht van Azure Virtual Desktop te gaan.

3. Selecteer App-koppeling en selecteer vervolgens + Maken.

4. Vul op het tabblad Basisinformatie de volgende informatie in:

   Parameter	Beschrijving
   Abonnement	Selecteer het abonnement waaraan u een MSIX-installatiekopieën, Appx-installatiekopieën of App-V-pakket wilt toevoegen in de vervolgkeuzelijst.
   Resourcegroep	Selecteer een bestaande resourcegroep of selecteer Nieuwe maken en voer een naam in.
   Hostgroep	Selecteer een bestaande hostgroep in de vervolgkeuzelijst.
   Locatie	Selecteer de Azure-regio voor uw app-bijlagepakket.

   Nadat u dit tabblad hebt voltooid, selecteert u Volgende.

5. Vul op het tabblad Pad naar afbeelding de volgende informatie in:

   Parameter	Beschrijving
   Afbeeldingspad	Selecteer bij Selecteren uit opslagaccount als uw afbeelding is opgeslagen in Azure Files of UNC invoeren om een UNC-pad op te geven. De volgende velden zijn afhankelijk van de optie die u selecteert.
   Selecteren uit opslagaccount
   Opslagaccount	Selecteer het opslagaccount waarin uw installatiekopieën zich bevinden.
   Bestandsshare	Selecteer Een bestand selecteren en blader vervolgens naar de bestandsshare en map waarin uw afbeelding zich bevindt. Schakel het selectievakje in naast de afbeelding die u wilt toevoegen, bijvoorbeeld MyApp.cimen selecteer vervolgens Selecteren.
   MSIX-pakket	Selecteer het MSIX- of Appx-pakket in de installatiekopieën.
   Invoer UNC
   UNC	Voer het UNC-pad naar het afbeeldingsbestand in.
   MSIX-pakket	Selecteer het MSIX- of Appx-pakket in de installatiekopieën.
   Beide opties
   Weergavenaam	Voer een beschrijvende naam in voor uw toepassing.
   Versie	Controleer of het verwachte versienummer wordt weergegeven.
   Registratietype	Selecteer het registratietype dat u wilt gebruiken.
   Status	Selecteer de beginstatus voor het pakket.
   Status van statuscontrole bij fout	Selecteer de status voor het pakket als het niet kan worden uitgevoerd op een sessiehost. Deze status wordt gerapporteerd voor AppAttachHealthCheck voor de statuscontrole van de sessiehost.

   Nadat u dit tabblad hebt voltooid, selecteert u Volgende.

   Tip

   Nadat u dit tabblad hebt voltooid, kunt u de toepassing desgewenst blijven toewijzen aan hostgroepen, gebruikers en groepen. Als u toewijzingen afzonderlijk wilt configureren, selecteert u Beoordelen en maken en gaat u vervolgens naar Een app-pakket bijvoegen toewijzen.

6. Optioneel: vul op het tabblad Toewijzingen de volgende gegevens in:

   1. Selecteer bij Hostgroep aan welke hostgroepen u de toepassing wilt toewijzen.

   2. Selecteer Gebruikers of gebruikersgroepen toevoegen, zoek en selecteer vervolgens de gebruikers of groepen waaraan u de toepassing wilt toewijzen. Als u klaar bent, selecteert u Selecteren.

   3. Controleer de toewijzingen die u hebt toegevoegd en selecteer vervolgens Volgende.

7. Optioneel: op het tabblad Tags kunt u eventuele naam-/waardeparen invoeren die u nodig hebt en vervolgens Beoordelen en maken selecteren.

8. Controleer op het tabblad Controleren en maken of de validatie is geslaagd en controleer de informatie die wordt gebruikt tijdens de implementatie. Selecteer vervolgens Maken om de toepassing toe te voegen.

U kunt als volgt een MSIX-installatiekopieën, Appx-installatiekopieën of App-V-pakket toevoegen als een App Attach-pakket met behulp van de PowerShell-module Az.DesktopVirtualization . Zorg ervoor dat u de <placeholder> waarden zelf wijzigt.

1. Open Azure Cloud Shell in de Azure Portal met het PowerShell-terminaltype of voer PowerShell uit op uw lokale apparaat.

   • Als u Cloud Shell gebruikt, controleert u of uw Azure-context is ingesteld op het abonnement dat u wilt gebruiken.

   • Als u PowerShell lokaal gebruikt, meldt u zich eerst aan met Azure PowerShell en controleert u of uw Azure-context is ingesteld op het abonnement dat u wilt gebruiken.

2. Controleer tijdens de preview of u de PowerShell-cmdlets beschikbaar hebt door de volgende opdrachten uit te voeren:

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

   De uitvoer moet vergelijkbaar zijn met de volgende uitvoer:

   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. Haal de eigenschappen op van de MSIX-installatiekopieën, Appx-installatiekopieën of App-V-pakket die u wilt toevoegen en sla ze op in een variabele door de volgende opdracht uit te voeren. U moet een hostgroep opgeven, maar dit kan elke hostgroep zijn waar sessiehosts toegang hebben tot de bestandsshare.

   # 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. Controleer of de toepassingseigenschappen slechts één object bevatten door de volgende opdrachten uit te voeren:

   $app | FL *
   

   Optioneel: als u meer dan één object in de uitvoer hebt, bijvoorbeeld een x64- en x86-versie van dezelfde toepassing, kunt u de parameter PackageFullName gebruiken om op te geven welke toepassing u wilt toevoegen door de volgende opdrachten uit te voeren:

   # 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. Voeg de installatiekopieën of het pakket toe als een app-bijlagepakket door de volgende opdracht uit te voeren. In dit voorbeeld wordt de toepassingsstatus gemarkeerd als actief, is de toepassingsregistratie ingesteld op on-demand en wordt de statuscontrole van de sessiehost ingesteld op NeedsAssistance:

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

   Er is geen uitvoer wanneer het pakket is toegevoegd.

6. U kunt controleren of het pakket is toegevoegd door de volgende opdrachten uit te voeren:

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

   De uitvoer moet vergelijkbaar zijn met het volgende voorbeeld:

   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
   

U kunt als volgt een toepassingspakket toewijzen aan hostgroepen, gebruikers en groepen met behulp van de Azure Portal:

Hostpools

1. Selecteer in het Overzicht van Azure Virtual Desktop de optie App-bijlage en selecteer vervolgens de naam van het app-pakket dat u wilt toewijzen.

2. Selecteer hostgroepen in de sectie Beheren:

3. Selecteer + Toewijzen en selecteer vervolgens een of meer hostgroepen in de vervolgkeuzelijst. Zorg ervoor dat alle sessiehosts in de hostgroep leestoegang moeten hebben met hun computeraccount, zoals vermeld in de vereisten.

4. Kies Toevoegen.

Groepen en gebruikers

1. Selecteer in het Overzicht van Azure Virtual Desktop de optie App-bijlage en selecteer vervolgens de naam van het app-pakket dat u wilt toewijzen.

2. Selecteer in de sectie Beherende optie Gebruikers:

3. Selecteer + Toevoegen en selecteer vervolgens een of meer groepen en/of gebruikers in de lijst.

4. Selecteer Selecteren.

U kunt als volgt een toepassingspakket toewijzen aan hostgroepen, groepen en gebruikers met behulp van de PowerShell-module Az.DesktopVirtualization .

Hostpools

1. Haal in dezelfde PowerShell-sessie de resource-id's op van de hostgroep(en) waaraan u de toepassing wilt toewijzen en voeg ze toe aan een matrix door de volgende opdrachten uit te voeren:

   # 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. Zodra u de resource-id's van de hostgroep(en) hebt, kunt u het toepassingspakket eraan toewijzen door de volgende opdrachten uit te voeren:

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

3. Als u de toewijzing van het toepassingspakket uit alle hostgroepen wilt opheffen, kunt u een lege matrix met hostgroepen doorgeven door de volgende opdrachten uit te voeren:

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

Groepen en gebruikers

U kunt als volgt een toepassing toewijzen aan groepen en gebruikers met behulp van de PowerShell-module Az.DesktopVirtualization .

1. Haal de object-id op van de groepen of gebruikers die u wilt toevoegen aan of verwijderen uit de toepassing en voeg ze toe aan een matrix met behulp van een van de volgende voorbeelden. We raden u aan toepassingen toe te wijzen aan groepen.

   1. Haal de object-id van de groep of groepen op en voeg deze toe aan een matrix door de volgende opdrachten uit te voeren. In dit voorbeeld wordt de weergavenaam van de groep gebruikt:

      # 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. Haal de object-id van de gebruiker(s) op en voeg deze toe aan een matrix door de volgende opdrachten uit te voeren. In dit voorbeeld wordt de UPN (User Principal Name) gebruikt:

      # 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. Zodra u de object-id's van de gebruikers of groepen hebt, kunt u ze toevoegen aan of verwijderen uit de toepassing met behulp van een van de volgende voorbeelden, waarmee de RBAC-rol gebruiker van bureaubladvirtualisatie wordt toegewezen.

   1. Voer de volgende opdrachten uit om de groepen of gebruikers toe te voegen aan de toepassing:

      $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. Voer de volgende opdrachten uit om de groepen of gebruikers uit de toepassing te verwijderen:

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

U kunt als volgt het registratietype en de status van een pakket wijzigen met behulp van de Azure Portal:

1. Selecteer in het overzicht van Azure Virtual Desktop de optie App-bijlage. U ziet nu een lijst met alle bestaande pakketten in de hostgroep.

2. Selecteer de naam van het pakket dat u wilt wijzigen.

   1. Als u het registratietype wilt wijzigen, selecteert u On-demand of Registreren bij aanmelden en selecteert u vervolgens Opslaan.

   2. Als u de status wilt wijzigen, selecteert u Inactief of Actief en selecteert u vervolgens Opslaan.

U kunt als volgt het registratietype en de status van een pakket wijzigen met behulp van de PowerShell-module Az.DesktopVirtualization .

1. In dezelfde PowerShell-sessie kunt u het registratietype en de status wijzigen door de volgende opdrachten uit te voeren:

   1. Wijzig het registratietype door de volgende opdracht uit te voeren. $true Ingesteld IsRegularRegistration op voor Registreren bij aanmelding of $false voor Op aanvraag.

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

   2. Wijzig de status door de volgende opdracht uit te voeren. Stel in IsActive op $true voor Actief of $falseInactief.

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

U kunt als volgt een toepassing uit het pakket dat u in dit artikel hebt toegevoegd toevoegen aan een RemoteApp-toepassingsgroep met behulp van de Azure Portal:

1. Selecteer in het overzicht van Azure Virtual Desktop de optie Toepassingsgroepen en selecteer vervolgens de RemoteApp-toepassingsgroep waaraan u een toepassing wilt toevoegen.

2. Selecteer Toepassingen en selecteer + Toevoegen. Zorg ervoor dat u ten minste één sessiehost hebt ingeschakeld in de hostgroep waaraan de toepassingsgroep is toegewezen.

3. Vul op het tabblad Basisinformatie de volgende informatie in:

   Parameter	Waarde/beschrijving
   Toepassingsbron	Selecteer App-bijlage in de vervolgkeuzelijst. Zie Toepassingen publiceren met RemoteApp als u toepassingen wilt toevoegen vanuit het Startmenu of door een bestandspad op te geven.
   Pak	Selecteer een pakket dat beschikbaar is voor de hostgroep in de vervolgkeuzelijst. Regionale pakketten zijn afkomstig van App-bijlage.
   Toepassing	Selecteer een toepassing in de vervolgkeuzelijst.
   Toepassings-id	Voer een unieke id in voor de toepassing.
   Weergavenaam	Voer een beschrijvende naam in voor de toepassing voor gebruikers.
   Beschrijving	Voer een beschrijving in voor de toepassing.

   Nadat u dit tabblad hebt voltooid, selecteert u Volgende.

4. Selecteer op het tabblad Pictogramde optie Standaard om het standaardpictogram voor de toepassing te gebruiken of selecteer Bestandspad om een aangepast pictogram te gebruiken. Selecteer een van de volgende opties voor Bestandspad:

   • Blader door Azure Files om een pictogram van een Azure-bestandsshare te gebruiken. Selecteer Een opslagaccount selecteren en selecteer het opslagaccount met het pictogrambestand en selecteer vervolgens Pictogrambestand selecteren. Blader naar de bestandsshare en map waarin uw pictogram zich bevindt, schakel het selectievakje in naast het pictogram dat u wilt toevoegen, bijvoorbeeld MyApp.icoen selecteer vervolgens Selecteren. U kunt ook een .png bestand gebruiken. Geef bij Pictogramindex het indexnummer op voor het pictogram dat u wilt gebruiken. Dit getal is meestal 0.

   • UNC-bestandspad om een pictogram van een bestandsshare te gebruiken. Voer bij Pictogrampad het UNC-pad naar het pictogrambestand in, bijvoorbeeld \\MyFileShare\MyApp.ico. U kunt ook een .png bestand gebruiken. Geef bij Pictogramindex het indexnummer op voor het pictogram dat u wilt gebruiken. Dit getal is meestal 0.

   Nadat u dit tabblad hebt voltooid, selecteert u Controleren en toevoegen.

5. Controleer op het tabblad Controleren en toevoegen of de validatie is geslaagd en controleer de informatie die wordt gebruikt om de toepassing toe te voegen. Selecteer vervolgens Toevoegen om de toepassing toe te voegen aan de RemoteApp-toepassingsgroep.

U kunt als volgt een toepassing uit het pakket dat u in dit artikel hebt toegevoegd toevoegen aan een RemoteApp-toepassingsgroep met behulp van de PowerShell-module Az.DesktopVirtualization .

1. Als het pakket in dezelfde PowerShell-sessie meerdere toepassingen bevat, moet u de toepassings-id ophalen van de toepassing die u wilt toevoegen uit het pakket door de volgende opdrachten uit te voeren:

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

2. Noteer de toepassings-id die u wilt publiceren (bijvoorbeeld App) en voer vervolgens de volgende opdrachten uit om de toepassing toe te voegen aan de RemoteApp-toepassingsgroep:

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

3. Controleer de lijst met toepassingen in de toepassingsgroep door de volgende opdrachten uit te voeren:

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

U kunt als volgt een bestaand pakket bijwerken met behulp van de Azure Portal:

1. Selecteer in het overzicht van Azure Virtual Desktop de optie App-bijlage. U ziet nu een lijst met alle bestaande pakketten.

2. Selecteer het pakket dat u wilt bijwerken en selecteer in het overzicht de optie Bijwerken.

3. Voer de informatie in voor het bijgewerkte pakket:

   1. Abonnement en resourcegroep worden vooraf ingevuld met de waarden voor het huidige pakket.

   2. Selecteer de hostgroep waarvoor u het pakket wilt bijwerken.

   3. Selecteer het pad naar de installatiekopieën in Selecteren uit opslagaccount of Unc invoeren. De volgende velden zijn afhankelijk van de optie die u selecteert.

      1. Selecteer bij Selecteren uit opslagaccount het Opslagaccount met de bijgewerkte installatiekopie. Selecteer Een bestand selecteren en blader vervolgens naar de bestandsshare en map waarin uw afbeelding zich bevindt. Schakel het selectievakje in naast de afbeelding die u wilt toevoegen, bijvoorbeeld MyApp.cimen selecteer vervolgens Selecteren.
      2. Voer bij Invoer-UNC het UNC-pad naar het afbeeldingsbestand in.

   4. Voor MSIX-pakket selecteert u het MSIX- of Appx-pakket in de installatiekopieën.

4. Nadat u de velden hebt voltooid, selecteert u Bijwerken.

U kunt als volgt een bestaand pakket bijwerken met behulp van de PowerShell-module Az.DesktopVirtualization .

1. Haal in dezelfde PowerShell-sessie de eigenschappen van de bijgewerkte toepassing op en sla deze op in een variabele door de volgende opdrachten uit te voeren:

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

2. Controleer of de toepassingseigenschappen slechts één object bevatten door de volgende opdrachten uit te voeren:

   $app | FL *
   

   Als u meer dan één object in de uitvoer hebt, bijvoorbeeld een x64- en een x86-versie van dezelfde toepassing, kunt u de parameter PackageFullName gebruiken om op te geven welk object u wilt toevoegen door de volgende opdrachten uit te voeren:

   # 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. Werk een bestaand pakket bij door de volgende opdracht uit te voeren. De nieuwe schijfinstallatiekopieën vervangen de bestaande installatiekopieën, maar bestaande toewijzingen blijven behouden. Verwijder de bestaande installatiekopieën pas als gebruikers deze niet meer gebruiken.

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

U kunt als volgt een pakket voor app-bijlage verwijderen met behulp van de Azure Portal:

1. Selecteer in het overzicht van Azure Virtual Desktop de optie App-bijlage. U ziet nu een lijst met alle bestaande pakketten.

2. Schakel het selectievakje in naast de naam van het pakket dat u wilt verwijderen en selecteer vervolgens Verwijderen. Het pakket wordt ook verwijderd uit alle hostgroepen waaraan het is toegewezen.

U kunt als volgt een App Attach-pakket verwijderen met behulp van de PowerShell-module Az.DesktopVirtualization .

1. Voer in dezelfde PowerShell-sessie de volgende opdracht uit om het pakket met een toepassing te verwijderen:

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