Freigeben über


MSIXMGR-Toolparameter

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

Voraussetzungen

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

  • Laden Sie das MSIXMGR-Tool herunter.
  • Rufen Sie eine MSIX-gepackte Anwendung (.msix -Datei) ab.
  • Ein Windows-Gerät mit Administratorberechtigungen zum Erstellen des MSIX-Images.

-AddPackage

Fügen Sie das Paket unter dem angegebenen Dateipfad hinzu.

-AddPackage <Path to the MSIX package>

oder

-p <Path to the MSIX package>

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

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

-RemovePackage

Entfernen Sie das Paket mit dem angegebenen vollständigen Paketnamen.

-RemovePackage <Package name>

oder

-x <Package name>

Hier sehen Sie ein Beispiel für die Verwendung des -RemovePackage Parameters. Sie können den vollständigen Namen des Pakets ermitteln, indem Sie das PowerShell-Cmdlet Get-AppxPackage ausführen.

msixmgr.exe -RemovePackage myapp_0.0.0.1_x64__8wekyb3d8bbwe

-FindPackage

Suchen Sie ein Paket mit einem bestimmten vollständigen Paketnamen.

-FindPackage <Package name>

Hier sehen Sie ein Beispiel für die Verwendung des -FindPackage Parameters. Sie können den vollständigen Namen des Pakets ermitteln, indem Sie das PowerShell-Cmdlet Get-AppxPackage ausführen.

msixmgr.exe -FindPackage myapp_0.0.0.1_x64__8wekyb3d8bbwe

-ApplyACLs

Wenden Sie ACLs auf einen Paketordner (ein entpacktes Paket) an. Außerdem müssen Sie die folgenden erforderlichen Unterparameter angeben:

Erforderliche Parameter Beschreibung
-packagePath Der Pfad zum zu entpackenden Paket ODER der Pfad zu einem Verzeichnis, das mehrere zu entpackte Pakete enthält.
-ApplyACLs -packagePath <Path to the package folder>

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

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

-Auspacken

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

Erforderliche Parameter Beschreibung
-destination Das Verzeichnis, in dem die resultierenden Paketordner abgelegt werden sollen.
-fileType Der Typ der Datei, in die Pakete entpackt werden sollen. Gültige Dateitypen sind , .vhd.vhdx, .cim. Dieser Parameter ist nur beim Entpacken in CIM-Dateien erforderlich.
-packagePath Der Pfad zum zu entpackenden Paket ODER der Pfad zu einem Verzeichnis, das mehrere zu entpackte 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>

Im Folgenden finden Sie 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 aufgeführt, die Sie mit dem -Unpack -Parameter verwenden können:

Optionaler Parameter Beschreibung Beispiel
-applyACLs Wendet ACLs auf die resultierenden Paketordner und deren übergeordneten Ordner an. msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -applyACLs
-create Erstellt ein neues Image mit dem angegebenen Dateityp und entpackt die Pakete in dieses Image. Erfordert den -filetype -Parameter. msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -applyACLs -create -fileType VHDX
-fileType Der Typ der Datei, in die Pakete entpackt werden sollen. Gültige Dateitypen sind , VHDVHDX, CIM. Dieser Parameter ist beim Entpacken in CIM-Dateien erforderlich. Erfordert den -create -Parameter. msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -applyACLs -create -fileType CIM -rootDirectory apps
-rootDirectory Gibt das Stammverzeichnis für das Image an, in das 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 vor dem Entpacken des Pakets. Dieser Parameter erfordert, dass das Paketzertifikat auf dem Computer 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 Datei oder .vhdx in MB. Muss zwischen 5 MB und 2040000 MB groß sein. Verwenden Sie nur für .vhd - oder .vhdx -Dateien. Erfordert die -create Parameter und -filetype . msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -create -fileType VHDX -vhdSize 500

-MountImage

Binden Sie ein VHD-, VHDX- oder CIM-Image ein. Außerdem müssen Sie die folgenden erforderlichen Unterparameter angeben:

Erforderliche Parameter Beschreibung
-fileType Der Typ der Datei, in die Pakete entpackt werden sollen. Gültige Dateitypen sind , VHDVHDX, CIM.
-imagePath Der Pfad zur image-Datei, die eingebunden werden soll.
-MountImage -imagePath <Path to the MSIX image> -fileType <VHD | VHDX | CIM>

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

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

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

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

-UnmountImage

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

Erforderliche Parameter Beschreibung
-fileType Der Typ der Datei, in die Pakete entpackt werden sollen. Gültige Dateitypen sind , VHDVHDX, CIM.
-imagePath Der Pfad zur image-Datei, die eingebunden werden soll.
-UnmountImage -imagePath <Path to the MSIX image> -fileType <VHD | VHDX | CIM>

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

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

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

Optionaler Parameter Beschreibung Beispiel
-volumeId Die GUID des Volumes (ohne geschweifte Klammern angegeben), das dem Bild zugeordnet ist, das die Bereitstellung aufheben soll. Dieser Parameter ist nur für CIM-Dateien optional. Sie können die Volume-ID ermitteln, 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 sehen Sie 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 zu App Attach finden Sie in den folgenden Artikeln: