Layanan Paket Aplikasi DISM (.appx atau .appxbundle) Opsi Command-Line

  • Artikel

Anda dapat menggunakan perintah layanan paket aplikasi untuk menambahkan, menghapus, dan mencantumkan paket aplikasi yang disediakan (.appx atau .appxbundle) dalam gambar Windows. .appxbundle adalah kumpulan paket aplikasi dan sumber daya yang digunakan bersama-sama untuk memperkaya pengalaman aplikasi, sekaligus meminimalkan jejak disk pada PC tertentu. Untuk informasi mendetail tentang paket .appxbundle dan alur Microsoft Store, lihat Kemasan aplikasi. Hanya subset paket dalam .appxbundle yang dapat ditambahkan ke gambar saat bundel disediakan menggunakan DISM. Untuk informasi selengkapnya, lihat Memahami Bagaimana DISM Menambahkan Paket Sumber Daya .appxbundle ke Gambar.

Paket aplikasi yang disediakan ditambahkan ke gambar Windows lalu diinstal untuk setiap profil pengguna baru atau yang sudah ada saat pengguna masuk lagi. Untuk informasi selengkapnya, termasuk persyaratan untuk provisi paket aplikasi, lihat Aplikasi Sideload dengan DISM.

Anda juga dapat menggunakan PowerShell untuk menambahkan, menghapus, dan mencantumkan paket aplikasi (.appx atau .appxbundle) per gambar atau per pengguna dalam penginstalan Windows. Untuk informasi selengkapnya, lihat Cmdlet Deployment Imaging Servicing Management (DISM) dicmdlet Windows PowerShell dan Penginstalan Aplikasi di Windows PowerShell.

Sintaks layanan DISM

Sintaks dasar untuk melayani gambar Windows menggunakan DISM adalah:

DISM.exe {/Image:<path_to_image_directory>|/Online} [dism_global_options] {servicing_option} <servicing_argument>]

Opsi untuk gambar offline

Opsi layanan paket aplikasi berikut (.appx atau .appxbundle) tersedia untuk gambar offline.

DISM.exe /Image:<path_to_image_directory> [/Get-ProvisionedAppxPackages | /Add-ProvisionedAppxPackage | /Remove-ProvisionedAppxPackage | /Set-ProvisionedAppxDataFile | /StubPackageOption]

Opsi untuk gambar online

Opsi layanan paket aplikasi (.appx atau .appxbundle) berikut tersedia untuk sistem operasi yang sedang berjalan.

DISM.exe /Online [/Get-ProvisionedAppxPackages | /Add-ProvisionedAppxPackage | /Remove-ProvisionedAppxPackage | /Set-ProvisionedAppxDataFile | /StubPackageOption]

/Get-Help /?

Saat digunakan segera setelah opsi baris perintah layanan paket aplikasi, informasi tentang opsi dan argumen ditampilkan. Topik tambahan mungkin tersedia saat gambar ditentukan.

Dism /image:C:\test\offline /Add-ProvisionedAppxPackage /?

Dism /online /Get-ProvisionedAppxPackages /?

/Get-ProvisionedAppxPackages

Menampilkan informasi tentang paket aplikasi (.appx atau .appxbundle), dalam gambar, yang diatur untuk diinstal untuk setiap pengguna baru.

Dism /Image:C:\test\offline /Get-ProvisionedAppxPackages

/Add-ProvisionedAppxPackage

Menambahkan satu atau beberapa paket aplikasi ke gambar.

Aplikasi akan ditambahkan ke gambar Windows dan didaftarkan untuk setiap profil pengguna yang ada atau baru saat pengguna masuk berikutnya. Jika aplikasi ditambahkan ke gambar online, aplikasi tidak akan didaftarkan untuk pengguna saat ini hingga kali berikutnya pengguna masuk.

Provisikan aplikasi pada sistem operasi online dalam mode Audit sehingga tautan keras yang sesuai dapat dibuat untuk aplikasi yang berisi file yang sama persis (untuk meminimalkan penggunaan ruang disk) sambil juga memastikan tidak ada aplikasi yang berjalan untuk penginstalan yang berhasil.

Sintaks:

dism.exe /Add-ProvisionedAppxPackage {/FolderPath:<App_folder_path> [/SkipLicense\] [/CustomDataPath:<custom_file_path>]  /PackagePath:<main_package_path> [/DependencyPackagePath:<dependency_package_path>] {[/LicensePath:<license_file_path>] [/SkipLicense\]} [/CustomDataPath:<custom_file_path>]} [/Region:<region>]

  • Gunakan /FolderPath untuk menentukan folder file aplikasi yang tidak dikemas yang berisi paket utama, paket dependensi apa pun, dan file lisensi. Ini hanya didukung untuk paket aplikasi yang belum dikemas.

  • Gunakan /PackagePath untuk menentukan paket aplikasi (.appx atau .appxbundle). Anda dapat menggunakan /PackagePath saat memprovisikan aplikasi lini bisnis secara online.

    Penting

    /PackagePath Gunakan parameter untuk menyediakan paket .appxbundle. Selain itu, paket dependensi tidak dapat disediakan dengan /PackagePath, paket tersebut harus disediakan dengan /DependencyPackagePath parameter untuk aplikasi.

  • /PackagePath tidak didukung dari PC host yang menjalankan Windows Preinstallation Environment (WinPE) 4.0, Windows Server 2008 R2, atau versi Windows yang lebih lama.

  • Gunakan /Region untuk menentukan wilayah mana paket aplikasi (.appx atau .appxbundle) harus disediakan. Argumen wilayah dapat berupa:

    • all, menunjukkan bahwa aplikasi harus disediakan untuk semua wilayah, atau
    • Daftar wilayah yang dibatasi titik koma. Wilayah tersebut akan berbentuk kode ISO 3166-1 Alpha-2 atau ISO 3166-1 Alpha-3. Misalnya, Amerika Serikat dapat ditentukan sebagai "AS" atau "AS" (tidak peka huruf besar/kecil). Ketika daftar wilayah tidak ditentukan, paket akan disediakan hanya jika disematkan untuk memulai tata letak.

  • Gunakan /DependencyPackagePath untuk menentukan setiap paket depencency yang diperlukan agar aplikasi dapat disediakan. Paket dependensi yang diperlukan dari aplikasi dapat ditemukan dengan melihat <PackageDependency> elemen di AppxManifest.xml di akar paket .appx aplikasi. Jika semua aplikasi memiliki dependensi yang sama, versi minor terbaru dari setiap versi utama paket dependensi harus diinstal. Misalnya, App1, App2, dan App3 semuanya memiliki dependensi pada Microsoft.NET.Native.Framework. App1 menentukan Microsoft.NET.Native.Framework.1.6 dengan versi minor 25512.0, App2 menentukan Microsoft.NET.Native.Framework.1.6 dengan versi minor 25513.0, dan App3 menentukan Microsoft.NET.Native.Framework.1.3 dengan versi minor 24202.0. Karena App1 dan App2 keduanya menentukan versi utama yang sama dari paket dependensi, hanya versi minor terbaru 25513.0 yang harus diinstal, sementara App3 menentukan versi utama yang berbeda dari paket dependensi, sehingga juga harus diinstal. Jadi paket dependensi yang harus diinstal adalah Microsoft.NET.Native.Framework.1.6 dengan versi minor 25513.0 dan Microsoft.NET.Native.Framework.1.3 dengan versi minor 24202.0.

    Jika paket memiliki dependensi yang khusus untuk arsitektur, Anda harus menginstal semua arsitektur yang berlaku untuk dependensi pada gambar target. Misalnya, pada gambar target x64, sertakan jalur ke paket dependensi x86 dan x64 atau sertakan keduanya dalam folder file aplikasi yang dibongkar. Jika paket dependensi Arm juga ditentukan atau disertakan, DISM akan mengabaikannya karena tidak berlaku untuk gambar target x64.

    Arsitektur KomputerDependensi untuk diinstal:
    x64x64 dan x86
    x86x86
    LenganArm saja

  • Gunakan /CustomDataPath untuk menentukan file data kustom opsional untuk aplikasi. Anda dapat menentukan nama file apa pun. File akan diganti namanya menjadi Custom.dat ketika ditambahkan ke gambar.

  • Gunakan /LicensePath dengan /PackagePath opsi untuk menentukan lokasi file .xml yang berisi lisensi aplikasi Anda.

  • Hanya gunakan /SkipLicense dengan aplikasi yang tidak memerlukan lisensi pada komputer yang mendukung sideloading. Menggunakan /SkipLicense dalam skenario lain dapat membahayakan gambar.

Contoh:

Dism /Image:C:\test\offline /Add-ProvisionedAppxPackage /FolderPath:c:\Test\Apps\MyUnpackedApp /CustomDataPath:c:\Test\Apps\CustomData.xml

Dism /Online /Add-ProvisionedAppxPackage /PackagePath:C:\Test\Apps\MyPackedApp\MainPackage.appx /DependencyPackagePath:C:\Test\Apps\MyPackedApp\Framework-x86.appx /DependencyPackagePath:C:\Test\Apps\MyPackedApp\Framework-x64.appx /LicensePath:C:\Test\Apps\MyLicense.xml

Dism /Online /Add-ProvisionedAppxPackage /FolderPath:C:\Test\Apps\MyUnpackedApp /SkipLicense

Dism /Image:C:\test\offline /Add-ProvisionedAppxPackage /PackagePath:C:\Test\Apps\MyPackedApp\MainPackage.appxbundle /SkipLicense

Dism /Online /Add-ProvisionedAppxPackage /PackagePath:C:\Test\Apps\MyPackedApp\MainPackage.appxbundle /Region:"all"

Dism /Online /Add-ProvisionedAppxPackage /PackagePath:C:\Test\Apps\MyPackedApp\MainPackage.appxbundle /Region:"US;GB"

/Remove-ProvisionedAppxPackage

Menghapus provisi untuk paket aplikasi (.appx atau .appxbundle) dari gambar. Paket aplikasi tidak akan didaftarkan ke akun pengguna baru yang dibuat.

Sintaksis:

/Remove-ProvisionedAppxPackage /PackageName:<PackageName>

Penting

Opsi ini hanya akan menghapus provisi untuk paket jika terdaftar ke profil pengguna mana pun. Gunakan cmdlet Remove-AppxPackage di PowerShell untuk menghapus aplikasi untuk setiap pengguna yang sudah didaftarkan untuk menghapus aplikasi sepenuhnya dari gambar. Jika aplikasi belum didaftarkan ke profil pengguna mana pun, /Remove-ProvisionedAppxPackage opsi akan menghapus paket sepenuhnya. Untuk menghapus paket aplikasi dari Windows Server 2012, atau yang lebih baru, gambar yang memiliki Pengalaman Desktop terinstal, Anda harus menghapus paket aplikasi sebelum menghapus Pengalaman Desktop. Pengalaman Desktop adalah persyaratan /Remove-ProvisionedAppxPackage opsi untuk penginstalan Server Core Windows Server.

Contoh:

Dism /Image:C:\test\offline /Remove-ProvisionedAppxPackage /PackageName:microsoft.devx.appx.app1_1.0.0.0_neutral_ac4zc6fex2zjp

/Optimize-ProvisionedAppxPackages

Mengoptimalkan ukuran file total paket yang disediakan pada gambar dengan mengganti file yang identik dengan hardlink. Setelah gambar dengan paket AppX yang disediakan online, /optimize-provisionedappxpackages tidak akan dapat mengoptimalkan paket AppX yang disediakan. Jika Anda mengambil gambar offline dan menambahkan paket, hanya paket yang disediakan setelah gambar dibawa kembali offline yang akan dioptimalkan.

Perintah ini tidak didukung terhadap gambar online.

DISM.exe /Image:C:\test\offline /Optimize-ProvisionedAppxPackages

/Set-ProvisionedAppxDataFile

Menambahkan file data kustom ke dalam paket aplikasi yang ditentukan (.appx atau .appxbundle).

Sintaks

/Set-ProvisionedAppxDataFile [/CustomDataPath<custom_file_path>] /PackageName<PackageName>

Paket aplikasi (.appx atau .appxbundle) yang ditentukan harus sudah ditambahkan ke gambar sebelum Anda menambahkan file data kustom dengan opsi ini. Anda juga dapat menambahkan file data kustom saat menggunakan opsi ./Add-ProvisionedAppxPackage

  • Gunakan /CustomDataPath untuk menentukan file data kustom opsional untuk aplikasi. Anda dapat menentukan nama file apa pun. File akan diganti namanya menjadi Custom.dat ketika ditambahkan ke gambar. Jika file Custom.dat sudah ada, file tersebut akan ditimpa.

  • Gunakan /PackageName untuk menentukan paket aplikasi (.appx atau .appxbundle).

Contoh:

DISM.exe /Image:C:\test\offline /Set-ProvisionedAppxDataFile /CustomDataPath:c:\Test\Apps\Custom.dat /PackageName:microsoft.appx.app1_1.0.0.0_neutral_ac4zc6fex2zjp

/StubPackageOption

Digunakan bersama dengan opsi layanan paket aplikasi untuk menentukan preferensi rintisan paket.

Sintaksis:

/StubPackageOption:{installstub | installfull}
  • InstallStub mengatur paket provisi ke versi stub. Secara implisit mengatur preferensi stub ke potong.
  • InstallFull mengatur paket provisi ke provisi versi lengkap. Secara implisit mengatur preferensi stub menjadi penuh.

Jika tidak ada opsi paket stub yang ditentukan daripada versi paket yang disediakan diatur ke preferensi stub yang telah ditentukan sebelumnya.

Contoh:

Dism /image:C:\test\offline /add-provisionedappxpackage /packagepath:"C:\dism\stub\appwithresources.appxbundle" /stubpackageoption:installstub

Memahami Bagaimana DISM Menambahkan Paket Sumber Daya .appxbundle ke Gambar

Saat .appxbundle ditambahkan ke gambar, tidak semua paket sumber daya dalam bundel berlaku. Misalnya, jika aplikasi ditambahkan ke gambar Windows dengan bahasa default Spanyol (Spanyol), sumber daya Prancis (Prancis) tidak boleh disertakan. Untuk menentukan sumber daya apa yang ditambahkan ke gambar, penerapan paket ditentukan menggunakan:

  • Paket Sumber Daya Bahasa: Jika bahasa sistem operasi tidak ada, paket sumber daya bahasa aplikasi yang sesuai tidak ditambahkan. Misalnya, Anda mungkin memiliki gambar yang merupakan Windows 10 dengan bahasa Inggris (AS) sebagai bahasa default, dan paket bahasa Spanyol (Spanyol) disertakan. Paket sumber daya aplikasi Inggris (AS) dan Spanyol (Spanyol) akan ditambahkan ke gambar. Jika paket sumber daya Prancis (Prancis) (atau bahasa lain) tersedia dalam bundel aplikasi, paket sumber daya tersebut tidak akan ditambahkan.

  • Paket Sumber Daya Skala dan DirectX (DXFL): Paket sumber daya Skala dan DirectX (DXFL) bergantung pada konfigurasi perangkat keras perangkat Windows. Karena jenis perangkat keras target tidak dapat diketahui pada saat perintah DISM dijalankan, semua paket sumber daya skala dan DXFL ditambahkan ke gambar pada waktu provisi. Untuk informasi selengkapnya tentang mengembangkan aplikasi dengan sumber daya penskalaan, lihat Panduan penskalaan ke kepadatan piksel (aplikasi Microsoft Store).

Untuk gambar yang berisi beberapa paket bahasa, paket sumber daya aplikasi akan ditambahkan ke gambar untuk setiap bahasa. Setelah pengguna pertama masuk ke PC dengan gambar yang disebarkan dan pengguna telah memilih bahasa selama OOBE, paket sumber daya yang tidak dapat diterapkan, (paket sumber daya bahasa, paket sumber daya skala, dan paket sumber daya DXFL) yang tidak cocok dengan pengaturan profil pengguna dihapus.

Misalnya, aplikasi mungkin mendukung bahasa Inggris (AS), Prancis (Prancis), dan Spanyol (Spanyol). Jika aplikasi ditambahkan ke gambar dengan paket bahasa Inggris (AS) dan Spanyol (Spanyol) yang ada, hanya paket sumber daya Inggris (AS) dan Spanyol (Spanyol) yang akan ditambahkan ke gambar. Kemudian, jika pengguna masuk untuk pertama kalinya dan, selama OOBE, memilih Bahasa Inggris (AS) sebagai bahasa sistem operasi mereka, paket sumber daya Spanyol (Spanyol) akan dihapus setelah masuk selesai.

Penting

Jika Anda menambahkan atau menghapus paket bahasa dari gambar, Anda mengubah konteks penerapan yang dapat mengakibatkan meninggalkan kumpulan paket sumber daya yang salah atau tidak lengkap dalam gambar. Saat paket bahasa ditambahkan atau dihapus, Anda harus, sekali lagi, menambahkan semua paket .appxbundle (termasuk paket dependensi dan file lisensi Microsoft Store) ke gambar. Ini akan memastikan bahwa kumpulan paket sumber daya yang benar disediakan.

Batasan

  • Anda tidak dapat menginstal paket aplikasi (.appx) pada sistem operasi yang tidak mendukung aplikasi Windows 8. Anda tidak dapat menginstal paket bundel aplikasi (.appxbundle) pada sistem operasi yang tidak mendukung setidaknya aplikasi Windows 8.1. Aplikasi tidak didukung pada WinPE 4.0, opsi penginstalan Windows Server 2012 Server Core, atau pada versi Windows apa pun yang lebih lama dari Windows 8 dan Windows Server 2012.

    Untuk menginstal dan menjalankan aplikasi di Windows Server 2012, Anda harus menginstal Pengalaman Desktop.

  • Opsi /FolderPath hanya didukung untuk paket aplikasi berdasarkan format .appx.

  • /PackagePath harus selalu digunakan untuk paket .appxbundle.

Apa itu DISM?

Opsi Command-Line Manajemen Gambar DISM

Opsi Command-Line Deployment Image Servicing and Management (DISM)

Aplikasi Sideload dengan DISM