この記事では、MSIXMGR ツールで使用できるコマンド ライン パラメーターと構文について説明します。
前提条件
MSIXMGR ツールを使用するには、次のものが必要です。
- MSIXMGR ツールをダウンロードします。
- MSIX パッケージ アプリケーション (
.msixファイル) を取得します。 - MSIX イメージを作成するための管理アクセス許可を持つ Windows デバイス。
-AddPackage
指定したファイル パスにパッケージを追加します。
-AddPackage <Path to the MSIX package>
または
-p <Path to the MSIX package>
-AddPackage パラメーターの使用例を次に示します。
msixmgr.exe -AddPackage "C:\MSIX\myapp.msix"
-RemovePackage
指定したパッケージのフル ネームを持つパッケージを削除します。
-RemovePackage <Package name>
または
-x <Package name>
-RemovePackage パラメーターの使用例を次に示します。 パッケージの完全な名前は、PowerShell コマンドレット Get-AppxPackage を実行することで確認できます。
msixmgr.exe -RemovePackage myapp_0.0.0.1_x64__8wekyb3d8bbwe
-FindPackage
特定のパッケージの完全な名前を持つパッケージを検索します。
-FindPackage <Package name>
-FindPackage パラメーターの使用例を次に示します。 パッケージの完全な名前は、PowerShell コマンドレット Get-AppxPackage を実行することで確認できます。
msixmgr.exe -FindPackage myapp_0.0.0.1_x64__8wekyb3d8bbwe
-ApplyACLs
パッケージ フォルダー (アンパックされたパッケージ) に ACL を適用します。 また、次の必須サブパラメーターも指定する必要があります。
| 必須のパラメーター | 説明 |
|---|---|
-packagePath |
アンパックするパッケージへのパス、またはアンパックする複数のパッケージを含むディレクトリへのパス |
-ApplyACLs -packagePath <Path to the package folder>
-ApplyACLs パラメーターの使用例を次に示します。
msixmgr.exe -ApplyACLs -packagePath "C:\MSIX\myapp_0.0.0.1_x64__8wekyb3d8bbwe"
-解凍
パッケージを、 .appx、 .msix、 .appxbundle、または .msixbundleのいずれかのファイル形式で開梱し、その内容をフォルダーに抽出します。 また、次の必須サブパラメーターも指定する必要があります。
| 必須のパラメーター | 説明 |
|---|---|
-destination |
結果のパッケージ フォルダーを配置するディレクトリ。 |
-fileType |
パッケージをアンパックするファイルの種類。 有効なファイルの種類には、 .vhd、 .vhdx、 .cimが含まれます。 このパラメーターは、CIM ファイルへのアンパック時にのみ必要です。 |
-packagePath |
アンパックするパッケージへのパス、またはアンパックする複数のパッケージを含むディレクトリへのパス。 |
-rootDirectory |
パッケージをアンパックするイメージのルート ディレクトリを指定します。 このパラメーターは、新規および既存の CIM ファイルにアンパックする場合にのみ必要です。 |
-Unpack -packagePath <Path to package to unpack OR path to a directory containing multiple packages to unpack> -destination <Directory to place the resulting package folder(s) in> -fileType <VHD | VHDX | CIM> -rootDirectory <Root directory on image to unpack packages to>
-Unpack パラメーターの使用例を次に示します。
パッケージをディレクトリに開梱するには:
msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp"パッケージを VHDX ディスク イメージにアンパックするには:
msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp\myapp.vhdx" -applyACLs -create -filetype VHDX -rootDirectory appsCIM ディスク イメージにパッケージをアンパックするには:
msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp\myapp.cim" -applyACLs -create -filetype CIM -rootDirectory apps
-Unpack パラメーターで使用できる省略可能なパラメーターを次に示します。
| 省略可能なパラメーター | 説明 | 例 |
|---|---|---|
-applyACLs |
結果のパッケージ フォルダーとその親フォルダーに ACL を適用します。 | msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -applyACLs |
-create |
指定したファイルの種類で新しいイメージを作成し、そのイメージにパッケージをアンパックします。
-filetype パラメーターが必要です。 |
msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -applyACLs -create -fileType VHDX |
-fileType |
パッケージをアンパックするファイルの種類。 有効なファイルの種類には、 VHD、 VHDX、 CIMが含まれます。 CIM ファイルにアンパックする場合は、このパラメーターが必要です。
-create パラメーターが必要です。 |
msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -applyACLs -create -fileType CIM -rootDirectory apps |
-rootDirectory |
パッケージをアンパックするイメージのルート ディレクトリを指定します。 このパラメーターは、新規および既存の CIM ファイルにアンパックするときに必要です。 | msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -applyACLs -create -filetype CIM -rootDirectory apps |
-validateSignature |
パッケージを開梱する前に、パッケージの署名ファイルを検証します。 このパラメーターでは、パッケージの証明書がマシンにインストールされている必要があります。 詳細については、「 証明書ストア」を参照してください。 |
msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\Myapp" -validateSignature -applyACLs |
-vhdSize |
.vhd または .vhdx ファイルの目的のサイズ (MB)。 5 MB から 2040000 MB の間である必要があります。
.vhd または .vhdx ファイルにのみ使用します。
-createパラメーターと-filetype パラメーターが必要です。 |
msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -create -fileType VHDX -vhdSize 500 |
-MountImage
VHD、VHDX、または CIM イメージをマウントします。 また、次の必須サブパラメーターも指定する必要があります。
| 必須のパラメーター | 説明 |
|---|---|
-fileType |
パッケージをアンパックするファイルの種類。 有効なファイルの種類には、 VHD、 VHDX、 CIMが含まれます。 |
-imagePath |
マウントするイメージ ファイルへのパス。 |
-MountImage -imagePath <Path to the MSIX image> -fileType <VHD | VHDX | CIM>
-MountImage パラメーターの使用例を次に示します。
msixmgr.exe -MountImage -imagePath "C:\MSIX\myapp.cim" -fileType CIM
-MountImage パラメーターで使用できる省略可能なパラメーターを次に示します。
| 省略可能なパラメーター | 説明 | 例 |
|---|---|---|
-readOnly |
イメージを読み取り専用としてマウントするかどうかを示すブール値 (true は false)。 指定しない場合、イメージは既定で読み取り専用としてマウントされます。 | msixmgr.exe -MountImage -imagePath "C:\MSIX\myapp.cim" -filetype CIM -readOnly false |
-UnmountImage
VHD、VHDX、または CIM イメージのマウントを解除します。 また、次の必須サブパラメーターも指定する必要があります。
| 必須のパラメーター | 説明 |
|---|---|
-fileType |
パッケージをアンパックするファイルの種類。 有効なファイルの種類には、 VHD、 VHDX、 CIMが含まれます。 |
-imagePath |
マウントするイメージ ファイルへのパス。 |
-UnmountImage -imagePath <Path to the MSIX image> -fileType <VHD | VHDX | CIM>
-UnmountImage パラメーターの使用例を次に示します。
msixmgr.exe -UnmountImage -imagePath "C:\MSIX\myapp.vhdx" -fileType VHDX
-UnmountImage パラメーターで使用できる省略可能なパラメーターを次に示します。
| 省略可能なパラメーター | 説明 | 例 |
|---|---|---|
-volumeId |
マウント解除するイメージに関連付けられているボリュームの GUID (中かっこなしで指定)。 このパラメーターは、CIM ファイルに対してのみ省略可能です。 ボリューム ID を見つけるには、PowerShell コマンドレット Get-Volume を実行します。 | msixmgr.exe -UnmountImage -volumeId 199a2f93-99a8-11ee-9b0d-4c445b63adac -filetype CIM |
-quietUX
MSIXMGR ツールの実行時にユーザーの操作を抑制します。 このパラメーターは省略可能であり、他のパラメーターと共に使用できます。
-AddPackage パラメーターで -quietUX パラメーターを使用する例を次に示します。
msixmgr.exe -AddPackage "C:\MSIX\myapp.msix" -quietUX
次の手順
App Attach の詳細については、次の記事をチェックしてください。