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 アプリのアタッチの詳細については、次の記事をチェックしてください。

• アプリのアタッチで使用する MSIX イメージを作成する
• MSIXMGR ツールの最新情報
• アプリ アタッチと MSIX アプリ アタッチ
• アプリ アタッチおよび MSIX アプリ アタッチ アプリケーションを追加して管理する
• アプリ アタッチについて MSIX パッケージをテストする