Freigeben über

MSIXMGR-Toolparameter

  • Artikel

Dieser Artikel enthält die Befehlszeilenparameter und die Syntax, die Sie mit dem MSIXMGR-Tool verwenden können.

Voraussetzungen

Um das MSIXMGR-Tool zu verwenden, benötigen Sie Folgendes:

  • Herunterladen des MSIXMGR-Tools.
  • Holen Sie eine MSIX-gepackte Anwendung (.msix-Datei).
  • Ein Windows-Gerät mit Administratorberechtigungen zum Erstellen des MSIX-Images.

-AddPackage

Fügt das Paket unter dem angegebenen Dateipfad hinzu.

-AddPackage <Path to the MSIX package>

oder

-p <Path to the MSIX package>

Hier ist ein Beispiel für die Verwendung des -AddPackage-Parameters:

msixmgr.exe -AddPackage "C:\MSIX\myapp.msix"

-RemovePackage

Entfernt das Paket mit dem angegebenen vollständigen Paketnamen.

-RemovePackage <Package name>

oder

-x <Package name>

Hier ist ein Beispiel für die Verwendung des -RemovePackage-Parameters. Sie finden den vollständigen Paketnamen, indem Sie das PowerShell-Cmdlet Get-AppxPackage ausführen.

msixmgr.exe -RemovePackage myapp_0.0.0.1_x64__8wekyb3d8bbwe

-FindPackage

Sucht ein Paket mit einem bestimmten vollständigen Paketnamen.

-FindPackage <Package name>

Hier ist ein Beispiel für die Verwendung des -FindPackage-Parameters. Sie finden den vollständigen Paketnamen, indem Sie das PowerShell-Cmdlet Get-AppxPackage ausführen.

msixmgr.exe -FindPackage myapp_0.0.0.1_x64__8wekyb3d8bbwe

-ApplyACLs

ACLs auf einen Paketordner (ein entpacktes Paket) anwenden. Sie müssen auch die folgenden erforderlichen Unterparameter angeben:

Erforderlicher Parameter Beschreibung
-packagePath Der Pfad zum Paket zum Entpacken oder des Pfads zu einem Verzeichnis mit mehreren Paketen zum Entpacken 
-ApplyACLs -packagePath <Path to the package folder>

Hier ist ein Beispiel für die Verwendung des -ApplyACLs-Parameters:

msixmgr.exe -ApplyACLs -packagePath "C:\MSIX\myapp_0.0.0.1_x64__8wekyb3d8bbwe"

-Unpack

Entpacken Sie ein Paket in einem der Dateiformate .appx, .msix, .appxbundleoder .msixbundle und extrahieren Sie den Inhalt in einen Ordner. Sie müssen auch die folgenden erforderlichen Unterparameter angeben:

Erforderlicher Parameter Beschreibung
-destination Das Verzeichnis, in dem die resultierenden Paketordner platziert werden sollen.
-fileType Der Dateityp, in den Pakete entpackt werden sollen. Unterstützte Dateitypen sind unter anderem: .vhd, .vhdx, .cim. Dieser Parameter ist nur beim Entpacken in CIM-Dateien erforderlich.
-packagePath Der Pfad zu dem zu entpackenden Paket ODER der Pfad zu einem Verzeichnis, das mehrere zu entpackende Pakete enthält.
-rootDirectory Gibt das Stammverzeichnis für das Image an, in das Pakete entpackt werden sollen. Dieser Parameter ist nur beim Entpacken in neue und vorhandene CIM-Dateien erforderlich. 
-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>

Hier sind einige Beispiele für die Verwendung des -Unpack-Parameters:

  • So entpacken Sie ein Paket in ein Verzeichnis:

    msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp"

  • So entpacken Sie ein Paket in ein VHDX-Datenträgerimage:

    msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp\myapp.vhdx" -applyACLs -create -filetype VHDX -rootDirectory apps

  • So entpacken Sie ein Paket in ein CIM-Datenträgerimage:

    msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp\myapp.cim" -applyACLs -create -filetype CIM -rootDirectory apps

Hier sind die optionalen Parameter, die Sie mit dem -Unpack-Parameter verwenden können:

Optionaler Parameter: Beschreibung Beispiel
-applyACLs Wendet ACLs auf den oder die resultierenden Paketordner und den übergeordneten Ordner an. msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -applyACLs
-create Erzeugt ein neues Image mit dem angegebenen Dateityp und entpackt die Pakete in dieses Image. Erfordert den Parameter -filetype. msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -applyACLs -create -fileType VHDX
-fileType Der Dateityp, in den Pakete entpackt werden sollen. Unterstützte Dateitypen sind unter anderem: VHD, VHDX, CIM. Dieser Parameter ist beim Entpacken in CIM-Dateien erforderlich. Erfordert den Parameter -create. msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -applyACLs -create -fileType CIM -rootDirectory apps
-rootDirectory Gibt das Stammverzeichnis des Images an, in das die Pakete entpackt werden sollen. Dieser Parameter ist beim Entpacken in neue und vorhandene CIM-Dateien erforderlich. msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -applyACLs -create -filetype CIM -rootDirectory apps
-validateSignature Überprüft die Signaturdatei eines Pakets bevor es entpackt wird. Dieser Parameter setzt voraus, dass das Zertifikat des Pakets auf dem Rechner installiert ist.

Weitere Informationen finden Sie unter Zertifikatspeicher.		 msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\Myapp" -validateSignature -applyACLs
-vhdSize Die gewünschte Größe der .vhd oder .vhdx-Datei in MB. Muss zwischen 5 MB und 2040000 MB betragen. Wird nur für .vhd oder .vhdx-Dateien verwendet. Erfordert die -create- und -filetype-Parameter. msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -create -fileType VHDX -vhdSize 500

-MountImage

Stellen Sie ein VHD-, VHDX- oder CIM-Image fest. Sie müssen auch die folgenden erforderlichen Unterparameter angeben:

Erforderlicher Parameter Beschreibung
-fileType Der Dateityp, in den Pakete entpackt werden sollen. Unterstützte Dateitypen sind unter anderem: VHD, VHDX, CIM.
-imagePath Der Pfad zu der einzubindenden Imagedatei. 
-MountImage -imagePath <Path to the MSIX image> -fileType <VHD | VHDX | CIM>

Hier ist ein Beispiel für die Verwendung des -MountImage-Parameters:

msixmgr.exe -MountImage -imagePath "C:\MSIX\myapp.cim" -fileType CIM

Hier sind die optionalen Parameter, die Sie mit dem -MountImage-Parameter verwenden können:

Optionaler Parameter: Beschreibung Beispiel
-readOnly Boolescher Wert (wahr oder falsch), der angibt, ob das Image schreibgeschützt eingebunden werden soll. Wird hier kein Wert angegeben, wird das Image standardmäßig schreibgeschützt eingebunden. msixmgr.exe -MountImage -imagePath "C:\MSIX\myapp.cim" -filetype CIM -readOnly false

-UnmountImage

Heben Sie die Bereitstellung eines VHD-, VHDX- oder CIM-Images auf. Sie müssen auch die folgenden erforderlichen Unterparameter angeben:

Erforderlicher Parameter Beschreibung
-fileType Der Dateityp, in den Pakete entpackt werden sollen. Unterstützte Dateitypen sind unter anderem: VHD, VHDX, CIM.
-imagePath Der Pfad zu der einzubindenden Imagedatei. 
-UnmountImage -imagePath <Path to the MSIX image> -fileType <VHD | VHDX | CIM>

Hier ist ein Beispiel für die Verwendung des -UnmountImage-Parameters:

msixmgr.exe -UnmountImage -imagePath "C:\MSIX\myapp.vhdx" -fileType VHDX

Hier sind die optionalen Parameter, die Sie mit dem -UnmountImage-Parameter verwenden können:

Optionaler Parameter: Beschreibung Beispiel
-volumeId Die GUID des Volumes (ohne geschweifte Klammern angegeben), das mit dem Image verbunden ist, das Sie aushängen möchten. Dieser Parameter ist nur für CIM-Dateien optional. Sie finden die Volume-ID, indem Sie das PowerShell-Cmdlet Get-Volume ausführen. msixmgr.exe -UnmountImage -volumeId 199a2f93-99a8-11ee-9b0d-4c445b63adac -filetype CIM

-quietUX

Unterdrückt die Benutzerinteraktion beim Ausführen des MSIXMGR-Tools. Dieser Parameter ist optional und kann mit jedem anderen Parameter verwendet werden.

Hier ist ein Beispiel für die Verwendung des -quietUX Parameters mit dem -AddPackage-Parameter:

msixmgr.exe -AddPackage "C:\MSIX\myapp.msix" -quietUX

Nächste Schritte

Weitere Informationen zur MSIX-App-Anfügung finden Sie in den folgenden Artikeln: