Share via

Opsi layanan Command-Line Paket Sistem Operasi DISM (.cab atau .msu)

  • Artikel

Gunakan DISM dengan kabinet Windows (.cab) atau Windows Update file Alat Penginstal Mandiri (.msu) untuk menginstal atau menghapus pembaruan, paket bahasa, dan untuk mengaktifkan atau menonaktifkan fitur Windows. Fitur adalah komponen opsional untuk sistem operasi inti.

Sintaks

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

Opsi layanan paket sistem operasi berikut tersedia untuk gambar offline:

DISM.exe /Image:<path_to_image_directory> [/Get-Packages | /Get-PackageInfo | /Add-Package | /Remove-Package ] [/Get-Features | /Get-FeatureInfo | /Enable-Feature | /Disable-Feature ] [/Cleanup-Image]

Opsi layanan paket sistem operasi berikut tersedia untuk sistem operasi yang sedang berjalan:

DISM.exe /Online [/Get-Packages | /Get-PackageInfo | /Add-Package | /Remove-Package ] [/Get-Features | /Get-FeatureInfo | /Enable-Feature | /Disable-Feature ] [/Cleanup-Image]

/Get-Help /?

Saat digunakan segera setelah opsi baris perintah layanan paket, informasi tentang opsi dan argumen ditampilkan.

Topik tambahan mungkin tersedia saat gambar ditentukan.

Sintaksis:

Dism /Get-Help

Contoh:

Dism /Image:C:\test\offline /Add-Package /?

Dism /Online /Get-Packages /?

/Get-Packages

Menampilkan informasi dasar tentang semua paket dalam gambar. /Format:Table Gunakan argumen atau /Format:List untuk menampilkan output sebagai tabel atau daftar.

Sintaksis:

Dism /Get-Packages [/Format:{Table | List}]

Contoh:

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

Dism /Image:C:\test\offline /Get-Packages /Format:Table

Dism /Online /Get-Packages

/Get-PackageInfo

Menampilkan informasi terperinci tentang paket yang disediakan sebagai file .cab. Hanya file .cab yang dapat ditentukan. Anda tidak dapat menggunakan perintah ini untuk mendapatkan informasi paket untuk file .msu. /PackagePath:<path_to_package> dapat menunjuk ke file .cab atau folder.

Anda dapat menggunakan /Get-Packages opsi untuk menemukan nama paket dalam gambar, atau Anda dapat menentukan jalur ke file .cab. Jalur ke file .cab harus menunjuk ke sumber asli paket, bukan ke tempat file diinstal pada gambar offline.

Sintaksis:

Dism /Get-PackageInfo {/PackageName:<name_in_image> | /PackagePath:<path_to_cabfile>}

Contoh:

Dism /Image:C:\test\offline /Get-PackageInfo /PackagePath:C:\packages\package.cab

Dism /Image:C:\test\offline /Get-PackageInfo /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0

/Add-Package

Menginstal paket .cab atau .msu tertentu dalam gambar.

Catatan

Anda dapat menggunakan /Add-Package untuk menambahkan paket .msu ke Windows 11 online atau offline, versi 21H2, atau gambar yang lebih baru. Jika Anda bekerja dengan gambar Windows sebelum Windows 11, versi 21H2, Anda hanya dapat menambahkan paket .msu pada gambar target offline.

Beberapa paket dapat ditambahkan pada satu baris perintah. Penerapan setiap paket akan diperiksa. Jika paket tidak dapat diterapkan ke gambar yang ditentukan, Anda akan menerima pesan kesalahan. Gunakan argumen /IgnoreCheck jika Anda ingin perintah diproses tanpa memeriksa penerapan setiap paket.

Sintaksis:

Dism /Add-Package /PackagePath:<path_to_cabfile> [/IgnoreCheck] [/PreventPending]

  • /PackagePath dapat menunjuk ke:

    • Satu file .cab atau .msu.
    • Folder yang berisi satu file .cab yang diperluas.
    • Folder yang berisi satu file .msu.
    • Folder yang berisi beberapa file .cab atau .msu.

  • Jika /PackagePath menunjuk ke folder yang berisi file .cab atau .msu di akarnya, subfolder apa pun juga akan diperiksa secara rekursif untuk file .cab dan .msu.

  • /PreventPending Gunakan opsi untuk melewati penginstalan paket jika paket atau gambar Windows telah menunda tindakan online.

Catatan

/Add-Package tidak menjalankan pemeriksaan penuh untuk penerapan dan dependensi paket:

  • Jika Anda menambahkan paket dengan dependensi, pastikan semua dependensi diinstal saat Anda menambahkan paket.
  • Jika Anda menambahkan .msu, pastikan untuk memeriksa KB terkait untuk instruksi penginstalan khusus paket apa pun.

Contoh:

Dism /Image:C:\test\offline /LogPath:AddPackage.log /Add-Package /PackagePath:C:\packages\package.msu

Dism /Image:C:\test\offline /Add-Package /PackagePath:C:\packages\package1.cab /PackagePath:C:\packages\package2.cab /IgnoreCheck

Dism /Image:C:\test\offline /Add-Package /PackagePath:C:\test\packages\package.cab /PreventPending

/Remove-Package

Menghapus paket file .cab yang ditentukan dari gambar. Hanya file .cab yang dapat ditentukan. Anda tidak dapat menggunakan perintah ini untuk menghapus file .msu.

Catatan

Menggunakan perintah ini untuk menghapus paket dari gambar offline tidak akan mengurangi ukuran gambar.

Sintaksis:

/Remove-Package {/PackageName:<name_in_image> | /PackagePath:<path_to_cabfile>}
  • Gunakan /PackagePath untuk menunjuk ke sumber asli paket, menentukan jalur ke file CAB, atau untuk menentukan paket berdasarkan nama seperti yang tercantum dalam gambar. /Get-Packages Gunakan opsi untuk menemukan nama paket dalam gambar.

Contoh:

Dism /Image:C:\test\offline /LogPath:C:\test\RemovePackage.log /Remove-Package /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0

Dism /Image:C:\test\offline /LogPath:C:\test\RemovePackage.log /Remove-Package /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0 /PackageName:Microsoft-Windows-MediaPlayer-Package~31bf3856ad364e35~x86~~6.1.6801.0

Dism /Image:C:\test\offline /LogPath:C:\test\RemovePackage.log /Remove-Package /PackagePath:C:\packages\package1.cab /PackagePath:C:\packages\package2.cab

/Get-Features

Menampilkan informasi dasar tentang semua fitur (komponen sistem operasi yang menyertakan fitur dasar Windows opsional) dalam paket.

Sintaksis:

/Get-Features {/PackageName:<name_in_image> | /PackagePath:<path_to_cabfile>} [/Format:{Table | List}]
  • /Get-Features menemukan nama paket dalam gambar, atau di sumber asli paket. Jika Anda tidak menentukan nama atau jalur paket, semua fitur dalam gambar akan dicantumkan.
  • /PackageName adalah paket dalam gambar. Anda dapat menggunakan /DISM Get-Packages untuk melihat nama paket dalam gambar.
  • /PackagePath dapat menunjuk ke file .cab atau folder.

/Format:Table Gunakan argumen atau /Format:List untuk menampilkan output sebagai tabel atau daftar.

Contoh:

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

Dism /Image:C:\test\offline /Get-Features /Format:List

Dism /Image:C:\test\offline /Get-Features /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0

Dism /Image:C:\test\offline /Get-Features /PackagePath:C:\packages\package1.cab

/Get-FeatureInfo

Menampilkan informasi terperinci tentang fitur. Anda harus menggunakan /FeatureName. Anda dapat menggunakan /Get-Features opsi untuk menemukan nama fitur dalam gambar.

Sintaksis:

/Get-FeatureInfo /FeatureName:<name_in_image> [{/PackageName:<name_in_image> | /PackagePath:<path_to_cabfile>}]

/PackageName dan /PackagePath bersifat opsional dan dapat digunakan untuk menemukan fitur tertentu dalam paket.

Contoh:

Dism /Image:C:\test\offline /Get-FeatureInfo /FeatureName:Hearts

Dism /Image:C:\test\offline /Get-FeatureInfo /FeatureName:Hearts /PackagePath:C:\packages\package.cab

/Enable-Feature

Mengaktifkan atau memperbarui fitur yang ditentukan dalam gambar. Anda harus menggunakan opsi ./FeatureName /Get-Features Gunakan opsi untuk menemukan nama fitur dalam gambar.

Sintaksis:

/Enable-Feature /FeatureName:<name_in_image> [/PackageName:<name_in_image>] [/Source: <source>] [/LimitAccess] [/All]

Anda dapat menentukan /FeatureName opsi beberapa kali dalam satu baris perintah untuk fitur yang memiliki paket induk yang sama.

Anda tidak perlu menentukan nama paket menggunakan /PackageName opsi jika paket tersebut adalah Paket Windows Foundation. Jika tidak, gunakan /PackageName untuk menentukan paket induk fitur.

Anda dapat memulihkan dan mengaktifkan fitur yang sebelumnya telah dihapus dari gambar. /Source Gunakan argumen untuk menentukan lokasi file yang diperlukan untuk memulihkan fitur. Sumber file dapat dilakukan oleh folder Windows dalam gambar yang dipasang, misalnya c:\test\mount\Windows. Anda juga dapat menggunakan folder berdampingan Windows sebagai sumber file, misalnya z:\sources\SxS.

Jika Anda menentukan beberapa /Source argumen, file dikumpulkan dari lokasi pertama tempat mereka ditemukan dan lokasi lainnya diabaikan. Jika Anda tidak menentukan /Source untuk fitur yang telah dihapus, lokasi default di registri digunakan atau, untuk gambar online, Windows Update (WU) digunakan.

  • Gunakan /LimitAccess untuk mencegah DISM menghubungi WU untuk gambar online.
  • Gunakan /All untuk mengaktifkan semua fitur induk dari fitur yang ditentukan.

Contoh:

Dism /Online /Enable-Feature /FeatureName:Hearts /All

Dism /Online /Enable-Feature /FeatureName:Calc /Source:c:\test\mount\Windows /LimitAccess

Dism /Image:C:\test\offline /Enable-Feature /FeatureName:Calc /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0

/Disable-Feature

Menonaktifkan fitur yang ditentukan dalam gambar. Anda harus menggunakan opsi /FeatureName. /Get-Features Gunakan opsi untuk menemukan nama fitur dalam gambar.

Sintaks:

/Disable-Feature /FeatureName:<name_in_image> [/PackageName:<name_in_image>] [/Remove]

Anda dapat menentukan /FeatureName beberapa kali dalam satu baris perintah untuk fitur dalam paket induk yang sama.

Anda tidak perlu menentukan nama paket menggunakan opsi /PackageName jika paketnya adalah Paket Windows Foundation. Jika tidak, gunakan /PackageName untuk menentukan paket induk fitur.

Gunakan /Remove untuk menghapus fitur tanpa menghapus manifes fitur dari gambar. Fitur ini akan dicantumkan sebagai "Dihapus" ketika Anda menggunakan /Get-FeatureInfo untuk menampilkan detail fitur dan dapat dipulihkan dan diaktifkan menggunakan /Enable-Feature dengan opsi /Source.

Contoh:

*Dism /Online /Disable-Feature /FeatureName:Hearts

Dism /Image:C:\test\offline /Disable-Feature /FeatureName:Calc /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0

/Cleanup-Image

Melakukan operasi pembersihan atau pemulihan pada gambar. /AnalyzeComponentStoredan /ResetBase dapat digunakan dengan gambar Windows 10, Windows 8.1, dan Windows PE di atas 5.0. Dimulai dengan Windows 10, versi 1607, Anda dapat menentukan /Defer dengan /ResetBase, tetapi Anda hanya boleh menggunakan /Defer sebagai opsi di pabrik di mana DISM /Resetbase membutuhkan lebih dari 30 menit untuk menyelesaikannya.

Tip

Untuk menentukan kapan opsi /ResetBase terakhir dijalankan, periksa entri registri LastResetBase_UTC di bawah HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Component Based Servicing jalur registri.

Sintaksis:

/Cleanup-Image {/RevertPendingActions | /SPSuperseded [/HideSP] | /StartComponentCleanup [/ResetBase [/Defer]] | /AnalyzeComponentStore | /CheckHealth | /ScanHealth | /RestoreHealth [/Source: <filepath>] [/LimitAccess]}
Parameter Deskripsi
/RevertPendingActions Jika Anda mengalami kegagalan boot, Anda dapat menggunakan opsi /RevertPendingActions untuk mencoba memulihkan sistem. Operasi mengembalikan semua tindakan yang tertunda dari operasi layanan sebelumnya karena tindakan ini mungkin menjadi penyebab kegagalan boot. Opsi /RevertPendingActions tidak didukung pada sistem operasi yang sedang berjalan atau gambar Windows PE atau Windows Recovery Environment (Windows RE). Penting: Anda harus menggunakan opsi /RevertPendingActions hanya dalam skenario pemulihan sistem pada gambar Windows yang tidak dapat di-boot.
SPSuperseded Menghapus file cadangan apa pun yang dibuat selama penginstalan paket layanan. Gunakan /HideSP untuk mencegah paket layanan tercantum di Updates Panel Kontrol Terinstal. Paket layanan tidak dapat dihapus instalasinya setelah operasi /SPSupersed selesai.
/StartComponentCleanup Membersihkan komponen yang digantikan dan mengurangi ukuran penyimpanan komponen. Gunakan /ResetBase untuk mengatur ulang dasar komponen yang digantikan, yang selanjutnya dapat mengurangi ukuran penyimpanan komponen. Pembaruan Windows yang diinstal tidak dapat dihapus instalasinya setelah menjalankan /StartComponentCleanup dengan opsi /ResetBase. Gunakan /Defer dengan /ResetBase untuk menugaskan operasi pembersihan yang berjalan lama ke pemeliharaan otomatis berikutnya.
/AnalyzeComponentStore Membuat laporan penyimpanan komponen. Untuk informasi selengkapnya tentang laporan dan cara menggunakan informasi yang disediakan dalam laporan, lihat Menentukan Ukuran Aktual Folder WinSxS.
/CheckHealth Memeriksa apakah gambar telah ditandai sebagai rusak oleh proses yang gagal dan apakah kerusakan dapat diperbaiki.
/ScanHealth Memindai gambar untuk kerusakan penyimpanan komponen. Operasi ini akan memakan waktu beberapa menit.
/RestoreHealth Memindai gambar untuk kerusakan penyimpanan komponen, lalu melakukan operasi perbaikan secara otomatis. Operasi ini akan memakan waktu beberapa menit.
/Sumber Digunakan dengan /RestoreHealth untuk menentukan lokasi versi file yang baik yang diketahui yang dapat digunakan untuk perbaikan, seperti jalur ke direktori Windows dari gambar yang dipasang.
/LimitAccess Mencegah DISM menghubungi Windows Update untuk perbaikan gambar online.

Contoh:

Dism /Image:C:\test\offline /Cleanup-Image /RevertPendingActions

Dism /Image:C:\test\offline /Cleanup-Image /SPSuperseded /HideSP

Dism /Online /Cleanup-Image /ScanHealth

Dism /Online /Cleanup-Image /RestoreHealth /Source:c:\test\mount\windows /LimitAccess

Untuk mempelajari selengkapnya, lihat Memperbaiki Gambar Windows.

Batasan

  • Ketika Anda menginstal paket dalam gambar offline, status paket "penginstalan tertunda" karena tindakan online yang tertunda. Dengan kata lain, paket akan diinstal ketika gambar di-boot dan tindakan online diproses. Jika tindakan berikutnya diminta, tindakan tersebut tidak dapat diproses sampai tindakan online yang tertunda sebelumnya selesai. Anda dapat menggunakan /PreventPending opsi saat menambahkan paket dengan /AddPackage untuk melewati penginstalan paket ketika ada tindakan online yang tertunda.
  • Beberapa paket mengharuskan paket lain diinstal terlebih dahulu. Anda tidak boleh berasumsi bahwa dependensi akan terpenuhi. Jika paket memiliki persyaratan dependensi, gunakan file jawaban untuk menginstal paket yang diperlukan. Dengan meneruskan file jawaban ke DISM, beberapa paket dapat diinstal dalam urutan yang benar. Untuk informasi selengkapnya, lihat Menambahkan atau Menghapus Paket Secara Offline Menggunakan DISM.
  • Paket diinstal dalam urutan yang tercantum di baris perintah.
  • Saat menggunakan DISM untuk mencantumkan komponen opsional dalam gambar Windows PE, komponen opsional akan selalu dicantumkan sebagai tertunda bahkan ketika operasi layanan berhasil. Ini dirancang dan tidak memerlukan tindakan tambahan.

Apa itu DISM?

Opsi Command-Line Manajemen Gambar DISM

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