MSIXMGR ツールのパラメーター
この記事では、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"
-Unpack
.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 appsパッケージを CIM ディスク イメージに展開するには:
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 ツールの実行時にユーザーの操作を抑制します。 このパラメーターは省略可能であり、他のパラメーターと共に使用できます。
-quietUX パラメーターを -AddPackage パラメーターと共に使用する例を次に示します。
msixmgr.exe -AddPackage "C:\MSIX\myapp.msix" -quietUX
次のステップ
MSIX アプリのアタッチの詳細については、次の記事をチェックしてください。