MSIX-pakketten migreren van MSIX-app koppelen aan app-bijlage

App-bijlage verbetert de beheer- en gebruikerservaring via MSIX-appkoppeling. Als u MSIX-appkoppeling gebruikt, kunt u uw MSIX-pakketten migreren naar app-bijlage met behulp van een PowerShell-script.

Het migratiescript kan de volgende acties uitvoeren:

• Hiermee maakt u een nieuw pakketobject voor het koppelen van apps en kunt u het oorspronkelijke MSIX-pakketobject verwijderen, indien nodig.

• Kopieer machtigingen van toepassingsgroepen die zijn gekoppeld aan de hostgroep en het MSIX-pakket.

• Kopieer de locatie en resourcegroep van de hostgroep en het MSIX-pakket.

• Logboekmigratieactiviteit.

Vereisten

Als u het migratiescript wilt gebruiken, hebt u het volgende nodig:

• Een hostgroep die is geconfigureerd als een validatieomgeving, waarbij ten minste één MSIX-pakket is toegevoegd met MSIX-appkoppeling.

• Een Azure-account met de RBAC-rol (Op rollen gebaseerd toegangsbeheer) van Azure voor bureaubladvirtualisatie die is toegewezen aan de hostgroep.

• Een lokaal apparaat met PowerShell. Zorg ervoor dat de nieuwste versies van Az PowerShell en Microsoft Graph PowerShell SDK zijn geïnstalleerd. De volgende modules zijn met name vereist:

  • Az.DesktopVirtualization
  • Az.Accounts
  • Az.Resources
  • Microsoft.Graph.Authentication

Parameters

Dit zijn de parameters die u kunt gebruiken met het migratiescript:

Het migratiescript downloaden en uitvoeren

U kunt als volgt MSIX-pakketten migreren van MSIX-appkoppeling naar app-bijlage.

1. Open een PowerShell-prompt op uw lokale apparaat.

2. Download het PowerShell-script Migrate-MsixPackagesToAppAttach.ps1 en hef de blokkering op door de volgende opdrachten uit te voeren:

   $url = "https://raw.githubusercontent.com/Azure/RDS-Templates/master/msix-app-attach/MigrationScript/Migrate-MsixPackagesToAppAttach.ps1"
   $filename = $url.Split('/')[-1]
   
   Invoke-WebRequest -Uri $url -OutFile $filename | Unblock-File
   

3. Importeer de vereiste modules door de volgende opdrachten uit te voeren:

   Import-Module Az.DesktopVirtualization
   Import-Module Az.Accounts
   Import-Module Az.Resources
   Import-Module Microsoft.Graph.Authentication
   

4. Maak verbinding met Azure door de volgende opdracht uit te voeren en de aanwijzingen te volgen om u aan te melden bij uw Azure-account:

   Connect-AzAccount
   

5. Maak verbinding met Microsoft Graph door de volgende opdracht uit te voeren:

   Connect-MgGraph -Scopes "Group.Read.All"
   

De volgende subsecties bevatten enkele voorbeelden van het gebruik van het migratiescript. Raadpleeg de sectie parameters voor alle beschikbare parameters en een beschrijving van elke parameter.

Een specifiek MSIX-pakket migreren dat is toegevoegd aan een hostgroep en toepassingsgroep

Hier volgt een voorbeeld van het migreren van een specifiek MSIX-pakket dat is toegevoegd aan een hostgroep van MSIX-app koppelen aan app-bijlage. Dit voorbeeld:

• Hiermee migreert u het MSIX-pakket naar dezelfde resourcegroep en locatie als de hostgroep.
• Hiermee wordt het MSIX-pakket in de app gekoppeld aan dezelfde hostgroep en dezelfde gebruikers als de bron van de RemoteApp-toepassingsgroep.
• Laat de bestaande configuratie van het MSIX-pakket in MSIX-app actief in de hostgroep. Als u het MSIX-pakket onmiddellijk wilt uitschakelen, gebruikt u de -DeactivateOrigin parameter.
• Hiermee stelt u de nieuwe configuratie van het MSIX-pakket in inactief voor app-koppelen in. Als u het MSIX-pakket onmiddellijk wilt inschakelen, gebruikt u de -IsActive parameter.
• Hiermee schrijft u logboekgegevens naar het standaardbestandspad en de standaardindeling.

1. Haal vanuit dezelfde PowerShell-prompt een lijst op met MSIX-pakketten die zijn toegevoegd aan een hostgroep door de volgende opdrachten uit te voeren:

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

   De uitvoer lijkt op die in het volgende voorbeeld:

   DisplayName Name
   ----------- ----
   MyApp       hp01/MyApp_1.0.0.0_neutral__abcdef123ghij
   

2. Zoek het MSIX-pakket dat u wilt migreren en gebruik de waarde van de Name parameter in de vorige uitvoer:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   $msixPackage = Get-AzWvdMsixPackage @parameters | ? Name -Match '<MSIXPackageName>'
   $hostPoolId = (Get-AzWvdHostPool @parameters).Id
   

3. Migreer het MSIX-pakket door de volgende opdrachten uit te voeren:

   $parameters = @{
       PermissionSource = 'RAG'
       HostPoolsForNewPackage = $hostPoolId
       PassThru = $true
   }
   
   $msixPackage | .\Migrate-MsixPackagesToAppAttach.ps1 @parameters
   

Alle MSIX-pakketten migreren die zijn toegevoegd aan een hostgroep

Hier volgt een voorbeeld voor het migreren van alle MSIX-pakketten die zijn toegevoegd aan een hostgroep van MSIX-app koppelen aan app-bijlage. Dit voorbeeld:

• Hiermee worden MSIX-pakketten gemigreerd naar dezelfde resourcegroep en locatie.
• Voegt de nieuwe app-pakketten toe aan dezelfde hostgroep.
• Hiermee stelt u alle app-bijlagepakketten in op actief.
• Hiermee stelt u alle MSIX-pakketten in op inactief.
• Hiermee kopieert u machtigingen uit de gekoppelde bureaubladtoepassingsgroep.
• Hiermee schrijft u logboekgegevens naar een aangepast bestandspad in C:\MsixToAppAttach.log JSON-indeling.

1. Haal vanaf dezelfde PowerShell-prompt alle MSIX-pakketten op die zijn toegevoegd aan een hostgroep en sla ze op in een variabele door de volgende opdrachten uit te voeren:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   $msixPackages = Get-AzWvdMsixPackage @parameters
   $hostPoolId = (Get-AzWvdHostPool @parameters).Id   
   

2. Migreer het MSIX-pakket door de volgende opdrachten uit te voeren:

   $logFilePath = "C:\Temp\MsixToAppAttach.log"
   
   $parameters = @{
       IsActive = $true
       DeactivateOrigin = $true
       PermissionSource = 'DAG'
       HostPoolsForNewPackage = $hostPoolId
       PassThru = $true
       LogInJSON = $true
       LogFilePath = $LogFilePath
   }
   
   $msixPackages | .\Migrate-MsixPackagesToAppAttach.ps1 @parameters