مشاركة عبر

معلمات أداة MSIXMGR

  • مقالة

تحتوي هذه المقالة على معلمات سطر الأوامر وبناء الجملة التي يمكنك استخدامها مع أداة MSIXMGR.

المتطلبات الأساسية

لاستخدام أداة MSIXMGR، تحتاج إلى:

  • قم بتنزيل أداة MSIXMGR.
  • الحصول على تطبيق حزم MSIX (.msix ملف).
  • جهاز Windows بأذونات إدارية لإنشاء صورة MSIX.

-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 cmdlet Get-AppxPackage.

msixmgr.exe -RemovePackage myapp_0.0.0.1_x64__8wekyb3d8bbwe

-FindPackage

ابحث عن حزمة بالاسم الكامل لحزمة معينة.

-FindPackage <Package name>

فيما يلي مثال على استخدام المعلمة -FindPackage . يمكنك العثور على اسم الحزمة الكامل عن طريق تشغيل PowerShell cmdlet Get-AppxPackage.

msixmgr.exe -FindPackage myapp_0.0.0.1_x64__8wekyb3d8bbwe

-ApplyACLs

تطبيق قوائم التحكم بالوصول على مجلد حزمة (حزمة غير معبأة). تحتاج أيضا إلى تحديد المقاييس الفرعية المطلوبة التالية:

المعلمة المطلوبة ‏‏الوصف
-packagePath المسار إلى الحزمة لفك حزمة OR المسار إلى دليل يحتوي على حزم متعددة لتفريغها 
-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 المسار إلى الحزمة لفك حزمة OR المسار إلى دليل يحتوي على حزم متعددة لتفريغها.
-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 تطبيق قوائم التحكم بالوصول على مجلد (مجلدات) الحزمة الناتجة والمجلد الأصل الخاص بها. 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 بالميغابايت. يجب أن يتراوح بين 5 ميغابايت و2040000 ميغابايت. استخدم فقط للملفات .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 منطقي (صحيح خطأ) يشير إلى ما إذا كان يجب تحميل الصورة للقراءة فقط. إذا لم يتم تحديدها، يتم تحميل الصورة للقراءة فقط بشكل افتراضي. 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. يمكنك العثور على معرف وحدة التخزين عن طريق تشغيل PowerShell cmdlet 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، راجع هذه المقالات: