アプリのアタッチについて MSIX パッケージをテストする
この記事では、Azure Virtual Desktop の外部で MSIX パッケージをマウントして、アプリのアタッチについてパッケージをテストする方法について説明します。 アプリのアタッチ用の API は、Windows 11 Enterprise と Windows 10 Enterprise で利用でき。 これらの API は、テストのために Azure Virtual Desktop の外部で使用できますが、Azure Virtual Desktop の外部にはアプリ アタッチまたは MSIX アプリ アタッチのための管理プレーンはありません。
アプリ アタッチと MSIX アプリ アタッチの詳細については、「Azure Virtual Desktop のアプリ アタッチと MSIX アプリ アタッチ」を参照してください。
前提条件
この記事で説明されているようにしてパッケージをテストするには、次のものが必要です。
Windows 11 Enterprise または Windows 10 Enterprise を実行しているデバイス。
MSIX 形式からアプリのアタッチで使用できるイメージに拡張したアプリケーション。 方法については、「Azure Virtual Desktop でのアプリのアタッチで使用する MSIX イメージを作成する」をご覧ください。
CimFS イメージを使っている場合は、CimDiskImage PowerShell モジュールをインストールする必要があります。
MSIX パッケージのテストに使っているデバイスに対するローカル管理者アクセス許可を持つユーザー アカウント。
この記事では Azure Virtual Desktop の外部でテストするためのプロセスについて説明するので、Azure Virtual Desktop のデプロイは必要ありません。
Note
Microsoft サポートは、CimDiskImage PowerShell モジュールをサポートしていないため、問題が発生した場合は、モジュールの GitHub リポジトリに要求を送る必要があります。
フェーズ
Azure Virtual Desktop の外部で MSIX パッケージを使用するには、次の順序で実行する必要がある 4 つの異なるフェーズがあります。
- 段階
- [登録]
- 登録解除
- ステージング解除
ステージングとステージング解除はマシン レベルの操作ですが、登録と登録解除はユーザー レベルの操作です。 使う必要があるコマンドは、使っている PowerShell のバージョンと、ディスク イメージの形式が CimFS、VHDX、VHD のいずれであるかによって異なります。
Note
すべての MSIX パッケージには証明書が含まれています。 MSIX パッケージの証明書が環境で信頼されていることは、ユーザーが確認する必要があります。
MSIX パッケージのステージングを準備する
ステージング スクリプトは、MSIX パッケージを受け取るマシンを準備し、関連するパッケージをマシンにマウントします。
お使いの PowerShell のバージョンに関連するタブを選んでください。
PowerShell 6 以降を使ってパッケージをステージングするには、ステージング操作の前に次のコマンドを実行して、Windows ランタイム パッケージの機能を PowerShell に取り込む必要があります。
管理者として PowerShell プロンプトを開きます。
次のコマンドを実行し、Windows ランタイム パッケージをダウンロードしてインストールします。 次のコマンドを実行する必要があるのは、コンピューターごとに 1 回のみです。
#Required for PowerShell 6 and later $nuGetPackageName = 'Microsoft.Windows.SDK.NET.Ref' Register-PackageSource -Name MyNuGet -Location https://www.nuget.org/api/v2 -ProviderName NuGet Find-Package $nuGetPackageName | Install-Package次に、以下のコマンドを実行して、Windows ランタイム コンポーネントを PowerShell で使用できるようにします。
#Required for PowerShell 6 and later $nuGetPackageName = 'Microsoft.Windows.SDK.NET.Ref' $winRT = Get-Package $nuGetPackageName $dllWinRT = Get-ChildItem (Split-Path -Parent $winRT.Source) -Recurse -File WinRT.Runtime.dll $dllSdkNet = Get-ChildItem (Split-Path -Parent $winRT.Source) -Recurse -File Microsoft.Windows.SDK.NET.dll Add-Type -AssemblyName $dllWinRT.FullName Add-Type -AssemblyName $dllSdkNet.FullName
MSIX パッケージをステージングする
MSIX パッケージをステージングするようにコンピューターを準備したので、ディスク イメージをマウントしてから、MSIX パッケージのステージングを完了する必要があります。
ディスク イメージをマウントする
ディスク イメージをマウントするプロセスは、ディスク イメージの形式として CimFs、VHDX、VHD のどれを使っているかによって異なります。 お使いの形式に関連するタブを選んでください。
CimFS ディスク イメージをマウントするには:
同じ PowerShell セッションで、次のコマンドを実行します。
$diskImage = "<Local or UNC path to the disk image>" $mount = Mount-CimDiskImage -ImagePath $diskImage -PassThru -NoMountPath #We can now get the Device Id for the mounted volume, this will be useful for the destage step. $deviceId = $mount.DeviceId Write-Output $deviceId変数
$deviceIdはそのままにします。 この情報はこの記事の後半で必要になります。終えたら、「ディスク イメージのステージングを完了する」に進みます。
ディスク イメージのステージングを完了する
最後に、すべてのイメージ形式で次のコマンドを実行して、ディスク イメージのステージングを完了する必要があります。 このコマンドでは、前のセクションでディスク イメージをマウントしたときに作成した $deviceId 変数を使います。
同じ PowerShell セッションで、次のコマンドを実行してアプリケーションの情報を取得します。
$manifest = Get-ChildItem -LiteralPath $deviceId -Recurse -File AppxManifest.xml $manifestFolder = $manifest.DirectoryName次のコマンドを実行し、MSIX パッケージの完全な名前を取得して、変数に格納します。 この変数は、後の手順で必要になります。
$msixPackageFullName = $manifestFolder.Split('\')[-1] Write-Output $msixPackageFullName次のコマンドを実行して、Package Manager API のマニフェスト フォルダーの絶対 URI を作成します。
$folderUri = $maniFestFolder.Replace('\\?\','file:\\\') $folderAbsoluteUri = ([Uri]$folderUri).AbsoluteUri絶対 URI を使って次のコマンドを実行して、アプリケーション パッケージをステージングします。
$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")次のコマンドを実行して、アプリケーション パッケージのステージングの進行状況を監視します。 パッケージのステージングにかかる時間は、そのサイズに依存します。 ステージングが完了すると、
$stagingResult変数のStatusプロパティはRanToCompletionになります。$stagingResult = $asTaskAsyncOperation.Invoke($null, @($asyncOperation)) while ($stagingResult.Status -eq "WaitingForActivation") { Write-Output "Waiting for activation..." Start-Sleep -Seconds 5 } Write-Output $stagingResult
MSI パッケージがステージングされたら、MSIX パッケージを登録できます。
MSIX パッケージを登録する
MSIX パッケージを登録するには、同じ PowerShell セッションで次のコマンドを実行します。 このコマンドでは、前のセクションで作成した $msixPackageFullName 変数を使います。
$manifestPath = Join-Path (Join-Path $Env:ProgramFiles 'WindowsApps') (Join-Path $msixPackageFullName AppxManifest.xml)
Add-AppxPackage -Path $manifestPath -DisableDevelopmentMode -Register
これで、MSIX パッケージが登録されたので、アプリケーションをセッションで使用できます。 これで、テストとトラブルシューティングのためにアプリケーションを開くことができます。 終わったら、MSIX パッケージの登録とステージングを解除する必要があります。
MSIX パッケージの登録を解除する
MSIX パッケージの使用が済んで、削除してもよくなったら、まず登録を解除する必要があります。 MSIX パッケージを登録解除するには、同じ PowerShell セッションで次のコマンドを実行します。 これらのコマンドは、ディスクの DeviceId パラメーターをもう一度取得し、前のセクションで作成した $msixPackageFullName 変数を使ってパッケージを削除します。
$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
MSIX パッケージのステージングを解除する
最後に、MSIX パッケージのステージングを解除するには、ディスク イメージのマウントを解除し、同じ PowerShell セッションで次のコマンドを実行して、パッケージがどのユーザーにももう登録されていないことを確認する必要があります。 このコマンドでは、前のセクションで作成した $msixPackageFullName 変数を使います。
Remove-AppxPackage -AllUsers -Package $msixPackageFullName -ErrorAction SilentlyContinue
ディスク イメージのマウントを解除する
ステージング解除のプロセスを終えるには、ディスクをシステムからマウント解除する必要があります。 使う必要があるコマンドは、ディスク イメージの形式によって異なります。 お使いの形式に関連するタブを選んでください。
CimFS のディスク イメージをマウント解除するには、同じ PowerShell セッションで次のコマンドを実行します。
Dismount-CimDiskImage -DeviceId $deviceId
ディスクのマウント解除が完了すると、MSIX パッケージは安全に削除されています。
MSIX アプリのアタッチ エージェントのシミュレーション スクリプトを設定する
MSIX パッケージをデバイスに自動的に追加して削除する場合は、この記事の PowerShell コマンドを使って、起動、ログオン、ログオフ、シャットダウンの時点で実行されるスクリプトを作成できます。 詳しくは、「グループ ポリシーでの起動、シャットダウン、ログオン、ログオフのスクリプトの使用」をご覧ください。 各フェーズに必要な変数を各スクリプトで使用できることを確認する必要があります。
フェーズごとにスクリプトを作成します。
- 起動スクリプトは、"ステージング" プロセスを実行します。
- ログオン スクリプトは、"登録" プロセスを実行します。
- ログオフ スクリプトは、"登録解除" プロセスを実行します。
- シャットダウン スクリプトは、"ステージング解除" プロセスを実行します。
Note
タスク スケジューラを使って、ステージング スクリプトを実行できます。 スクリプトを実行するには、タスク トリガーを [When the computer starts] (コンピューターの起動時) に設定し、[Run with highest privileges] (最上位の特権で実行する) を有効にします。
パッケージをオフラインで使用する
インターネットに接続されていないデバイスでパッケージをお使いの場合、アプリを正常に実行するには、パッケージ ライセンスがデバイスにインストールされていることを確認する必要があります。 デバイスがオンラインの場合は、必要なライセンスが自動的にダウンロードされるはずです。
ライセンス ファイルをインストールするには、WMI ブリッジプロバイダーで MDM_EnterpriseModernAppManagement_StoreLicenses02_01 クラスを呼び出す PowerShell スクリプトを使う必要があります。
オフラインで使うライセンスを設定する方法を次に示します。
アプリ パッケージ、ライセンス、および必要なフレームワークをビジネス向け Microsoft Store からダウンロードします。 エンコードされたライセンス ファイルとエンコードされていないライセンス ファイルの両方が必要です。 オフライン ライセンスを使うアプリをダウンロードする方法については、「オフライン アプリの配布」をご覧ください。
管理者として次の PowerShell コマンドを実行します。 ライセンスは、ステージング フェーズの最後でインストールできます。 次の変数を編集する必要があります。
$contentIDは、エンコードされていないライセンス ファイル (.xml) の ContentID 値です。 ライセンス ファイルは任意のテキスト エディターで開くことができます。$licenseBlobは、エンコードされたライセンス ファイル (.bin) のライセンス BLOB の文字列全体です。 エンコードされたライセンス ファイルは、任意のテキスト エディターで開くことができます。$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 }
デモ スクリプト
MSIX パッケージのテストの 4 つのステージすべてで使うデモ スクリプトと、それらを使う方法に関する構文のヘルプは、GitHub リポジトリにあります。 これらのスクリプトは、すべてのバージョンの PowerShell とすべての形式のディスク イメージで動作します。
次のステップ
Azure Virtual Desktop のアプリ アタッチと MSIX アプリ アタッチについて確認します。