Testowanie pakietów MSIX na potrzeby dołączania aplikacji

W tym artykule pokazano, jak zainstalować pakiety MSIX poza usługą Azure Virtual Desktop, aby ułatwić testowanie pakietów na potrzeby dołączania aplikacji. Interfejsy API, które zasilają aplikację App Attach, są dostępne dla Windows 11 Enterprise i Windows 10 Enterprise. Te interfejsy API mogą być używane poza usługą Azure Virtual Desktop do testowania, jednak nie ma płaszczyzny zarządzania dla dołączania aplikacji poza usługą Azure Virtual Desktop.

Aby uzyskać więcej informacji na temat dołączania aplikacji, zobacz Dołączanie aplikacji w usłudze Azure Virtual Desktop.

Wymagania wstępne

Zanim będzie można przetestować pakiet, aby postępować zgodnie z instrukcjami podanymi w tym artykule, potrzebne są następujące elementy:

• Urządzenie z systemem Windows 11 Enterprise lub Windows 10 Enterprise.

• Aplikacja rozwinięta z formatu MSIX do obrazu, którego można użyć z dołączaniem aplikacji. Dowiedz się, jak utworzyć obraz MSIX do użycia z dołączaniem aplikacji w usłudze Azure Virtual Desktop.

• Jeśli używasz obrazu CimFS, musisz zainstalować moduł CimDiskImage programu PowerShell.

• Konto użytkownika, które ma uprawnienia administratora lokalnego na urządzeniu używanym do testowania pakietu MSIX.

Nie potrzebujesz wdrożenia usługi Azure Virtual Desktop, ponieważ w tym artykule opisano proces testowania poza usługą Azure Virtual Desktop.

Fazy

Aby korzystać z pakietów MSIX poza usługą Azure Virtual Desktop, istnieją cztery odrębne fazy, które należy wykonać w następującej kolejności:

1. Scena
2. Zarejestruj
3. Wyrejestrować
4. Destage

Przemieszczanie i usuwanie tagów to operacje na poziomie maszyny, natomiast rejestrowanie i wyrejestrowywanie to operacje na poziomie użytkownika. Polecenia, których należy użyć, różnią się w zależności od używanej wersji programu PowerShell oraz tego, czy obrazy dysków są w formacie CimFS, VHDX czy VHD .

Przygotowanie do przygotowania pakietu MSIX

Skrypt przejściowy przygotowuje maszynę do odebrania pakietu MSIX i instalowania odpowiedniego pakietu na maszynie.

Wybierz odpowiednią kartę dla używanej wersji programu PowerShell.

Przygotowywanie pakietu MSIX

Po przygotowaniu maszyny do przygotowania pakietów MSIX należy zainstalować obraz dysku, a następnie zakończyć przemieszczanie pakietu MSIX.

Instalowanie obrazu dysku

Proces instalowania obrazu dysku różni się w zależności od tego, czy używasz formatu CimFs, VHDX czy VHD dla obrazu dysku. Wybierz odpowiednią kartę dla używanego formatu.

Zakończenie przemieszczania obrazu dysku

Na koniec należy uruchomić następujące polecenia dla wszystkich formatów obrazów, aby ukończyć przemieszczanie obrazu dysku. To polecenie używa zmiennej utworzonej $deviceId podczas instalowania obrazu dysku w poprzedniej sekcji.

1. W tej samej sesji programu PowerShell pobierz informacje o aplikacji, uruchamiając następujące polecenia:

   $manifest = Get-ChildItem -LiteralPath $deviceId -Recurse -File AppxManifest.xml
   $manifestFolder = $manifest.DirectoryName
   

2. Pobierz pełną nazwę pakietu MSIX i zapisz go w zmiennej, uruchamiając następujące polecenia. Ta zmienna jest potrzebna do późniejszych kroków.

   $msixPackageFullName = $manifestFolder.Split('\')[-1]
   Write-Output $msixPackageFullName
   

3. Utwórz bezwzględny identyfikator URI dla folderu manifestu dla interfejsu API menedżera pakietów, uruchamiając następujące polecenia:

   $folderUri = $maniFestFolder.Replace('\\?\','file:\\\')
   $folderAbsoluteUri = ([Uri]$folderUri).AbsoluteUri
   

4. Użyj bezwzględnego identyfikatora URI, aby przygotować pakiet aplikacji, uruchamiając następujące polecenia:

   $asTask = ([System.WindowsRuntimeSystemExtensions].GetMethods() | Where-Object { $_.ToString() -eq 'System.Threading.Tasks.Task`1[TResult] AsTask[TResult,TProgress](Windows.Foundation.IAsyncOperationWithProgress`2[TResult,TProgress])' })[0]
   $asTaskAsyncOperation = $asTask.MakeGenericMethod([Windows.Management.Deployment.DeploymentResult], [Windows.Management.Deployment.DeploymentProgress])
   
   $packageManager = New-Object -TypeName Windows.Management.Deployment.PackageManager
   
   $asyncOperation = $packageManager.StagePackageAsync($folderAbsoluteUri, $null, "StageInPlace")
   

5. Monitoruj postęp przejściowy pakietu aplikacji, uruchamiając następujące polecenia. Czas potrzebny na przygotowanie pakietu zależy od jego rozmiaru. Właściwość Status zmiennej $stagingResult będzie RanToCompletion po zakończeniu przemieszczania.

   $stagingResult = $asTaskAsyncOperation.Invoke($null, @($asyncOperation))
   
   while ($stagingResult.Status -eq "WaitingForActivation") {
       Write-Output "Waiting for activation..."
       Start-Sleep -Seconds 5
   }
   
   Write-Output $stagingResult
   

Po przygotowaniu pakietu MSI możesz zarejestrować pakiet MSIX.

Rejestrowanie pakietu MSIX

Aby zarejestrować pakiet MSIX, uruchom następujące polecenia w tej samej sesji programu PowerShell. To polecenie używa zmiennej $msixPackageFullName utworzonej w poprzedniej sekcji.

$manifestPath = Join-Path (Join-Path $Env:ProgramFiles 'WindowsApps') (Join-Path $msixPackageFullName AppxManifest.xml)
Add-AppxPackage -Path $manifestPath -DisableDevelopmentMode -Register

Po zarejestrowaniu pakietu MSIX aplikacja powinna być dostępna do użycia w sesji. Teraz możesz otworzyć aplikację do testowania i rozwiązywania problemów. Po zakończeniu należy wyrejestrować i rozesłać pakiet MSIX.

Wyrejestrowyowanie pakietu MSIX

Po zakończeniu pracy z pakietem MSIX i przygotowaniu go do usunięcia należy najpierw wyrejestrować. Aby wyrejestrować pakiet MSIX, uruchom następujące polecenia w tej samej sesji programu PowerShell. Te polecenia ponownie pobierają parametr dysku DeviceId i usuwają pakiet przy użyciu zmiennej utworzonej $msixPackageFullName w poprzedniej sekcji.

$appPath = Join-Path (Join-Path $Env:ProgramFiles 'WindowsApps') $msixPackageFullName
$folderInfo = Get-Item $appPath
$deviceId = '\\?\' + $folderInfo.Target.Split('\')[0] +'\'
Write-Output $deviceId #Save this for later

Remove-AppxPackage $msixPackageFullName -PreserveRoamableApplicationData

Destage an MSIX package (Destage an MSIX package)

Na koniec, aby odinstalować pakiet MSIX, należy odinstalować obraz dysku, uruchom następujące polecenie w tej samej sesji programu PowerShell, aby upewnić się, że pakiet nie jest jeszcze zarejestrowany dla żadnego użytkownika. To polecenie używa zmiennej $msixPackageFullName utworzonej w poprzedniej sekcji.

Remove-AppxPackage -AllUsers -Package $msixPackageFullName -ErrorAction SilentlyContinue

Odinstaluj obraz dysków

Aby zakończyć proces usuwania tagów, należy odinstalować dyski z systemu. Polecenie, którego należy użyć, zależy od formatu obrazu dysku. Wybierz odpowiednią kartę dla używanego formatu.

Dismount-CimDiskImage -DeviceId $deviceId

Dismount-DiskImage -DevicePath $deviceId.TrimEnd('\')

Po zakończeniu odinstalowywania dysków pakiet MSIX został bezpiecznie usunięty.

Konfigurowanie skryptów symulacji dla agenta dołączania aplikacji

Jeśli chcesz automatycznie dodawać i usuwać pakiety MSIX do urządzenia, możesz użyć poleceń programu PowerShell w tym artykule, aby utworzyć skrypty uruchamiane podczas uruchamiania, logowania, logowania i zamykania. Aby dowiedzieć się więcej, zobacz Używanie skryptów uruchamiania, zamykania, logowania i wylogowywanie w zasady grupy. Musisz upewnić się, że wszystkie zmienne wymagane dla każdej fazy są dostępne w każdym skryptze.

Tworzysz skrypt dla każdej fazy:

• Skrypt uruchamiania uruchamia proces etapowy .
• Skrypt logowania uruchamia proces rejestrowania .
• Skrypt wylogowywania uruchamia proces wyrejestrowywania .
• Skrypt zamykania uruchamia proces destage .

Używanie pakietów w trybie offline

Jeśli używasz pakietów na urządzeniach, które nie są połączone z Internetem, musisz upewnić się, że licencje pakietów są zainstalowane na urządzeniu, aby pomyślnie uruchomić aplikację. Jeśli urządzenie jest w trybie online, wymagane licencje powinny zostać pobrane automatycznie.

Aby zainstalować pliki licencji, należy użyć skryptu programu PowerShell, który wywołuje klasę MDM_EnterpriseModernAppManagement_StoreLicenses02_01 w dostawcy mostka WMI.

Poniżej przedstawiono sposób konfigurowania licencji do użytku w trybie offline:

1. Pobierz pakiet aplikacji, licencję i wymagane struktury z Microsoft Store dla Firm. Potrzebne są zarówno zakodowane, jak i niekodowane pliki licencji. Aby dowiedzieć się, jak pobrać aplikację licencjonowaną w trybie offline, zobacz Dystrybucja aplikacji offline.

2. Uruchom następujące polecenia programu PowerShell jako administrator. Licencję można zainstalować na końcu fazy przejściowej. Musisz edytować następujące zmienne:

   • $contentID to wartość ContentID z niekodowany plik licencji (.xml). Plik licencji można otworzyć w wybranym edytorze tekstów.

   • $licenseBlob to cały ciąg obiektu blob licencji w pliku licencji kodowanej (.bin). Zakodowany plik licencji można otworzyć w wybranym edytorze tekstów.

     $namespaceName = "root\cimv2\mdm\dmmap"
     $className = "MDM_EnterpriseModernAppManagement_StoreLicenses02_01"
     $methodName = "AddLicenseMethod"
     $parentID = "./Vendor/MSFT/EnterpriseModernAppManagement/AppLicenses/StoreLicenses"
     
     #Update $contentID with the ContentID value from the unencoded license file (.xml)
     $contentID = "{'ContentID'_in_unencoded_license_file}"
     
     #Update $licenseBlob with the entire String in the encoded license file (.bin)
     $licenseBlob = "{Entire_String_in_encoded_license_file}"
     
     $session = New-CimSession
     
     #The final string passed into the AddLicenseMethod should be of the form <License Content="encoded license blob" />
     $licenseString = '<License Content='+ '"' + $licenseBlob +'"' + ' />'
     
     $params = New-Object Microsoft.Management.Infrastructure.CimMethodParametersCollection
     $param = [Microsoft.Management.Infrastructure.CimMethodParameter]::Create("param",$licenseString ,"String", "In")
     $params.Add($param)
     
     try
     {
          $instance = New-CimInstance -Namespace $namespaceName -ClassName $className -Property @{ParentID=$parentID;InstanceID=$contentID}
          $session.InvokeMethod($namespaceName, $instance, $methodName, $params)
     }
     catch [Exception]
     {
          Write-Host $_ | Out-String
     }
     

Skrypty demonstracyjnych

Skrypty demonstracyjne dla wszystkich czterech etapów testowania pakietów MSIX i pomoc w składni dotyczącej sposobu ich używania w naszym repozytorium GitHub. Te skrypty działają z dowolną wersją programu PowerShell i dowolnym formatem obrazu dysku.

Następne kroki

Dowiedz się więcej o dołączaniu aplikacji w usłudze Azure Virtual Desktop:

• Dołączanie aplikacji w usłudze Azure Virtual Desktop.
• Dodawanie aplikacji dołączania aplikacji i zarządzanie nimi.