Bagikan melalui

Opsi Baris Perintah Layanan Paket Sistem Operasi DISM (.cab atau .msu)

  • Artikel

Gunakan FILE DISM dengan kabinet Windows (.cab) atau Windows Update Stand-alone Installer (.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.

Sintaks:

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.

Sintaks:

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.

Sintaks:

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.

Sintaks:

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 menunggu 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

Pembaruan kumulatif titik pemeriksaan

Dimulai dengan Windows 11, versi 24H2, pembaruan kumulatif terbaru mungkin memiliki pembaruan kumulatif prasyarat yang diperlukan untuk diinstal terlebih dahulu. Untuk menginstal pembaruan kumulatif titik pemeriksaan ini, panggil /Add-Package dengan pembaruan kumulatif target. Folder dari -PackagePath akan digunakan untuk menemukan dan menginstal satu atau beberapa titik pemeriksaan sesuai kebutuhan. Hanya pembaruan kumulatif target dan pembaruan kumulatif titik pemeriksaan prasyarat apa pun yang harus ada di folder -PackagePath. Paket pembaruan kumulatif dengan revisi kurang dari atau sama dengan pembaruan kumulatif target akan diproses.

/Remove-Package

Menghapus paket file .cab tertentu 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.

Sintaks:

/Remove-Package {/PackageName:<name_in_image> | /PackagePath:<path_to_cabfile>}
  • Gunakan /PackagePath untuk menunjuk ke sumber asli paket, tentukan 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.

Sintaks:

/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.

Sintaks:

/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.

Sintaks:

/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 berbagi paket induk yang sama.

Anda tidak perlu menentukan nama paket menggunakan /PackageName opsi jika paket 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 dalam 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" saat 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. /AnalyzeComponentStore dan /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.

Sintaks:

/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 melakukan booting.
SPSuperseded Menghapus file cadangan apa pun yang dibuat selama penginstalan paket layanan. Gunakan /HideSP untuk mencegah paket layanan tercantum dalam Panel Kontrol Pembaruan 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 menugasi 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 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 citra daring.

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

  • Saat Anda menginstal paket dalam gambar offline, status paket "instal tertunda" karena tindakan online tertunda. Dengan kata lain, paket akan diinstal ketika gambar di-boot dan tindakan online diproses. Jika tindakan berikutnya diminta, tindakan tersebut tidak dapat diproses hingga 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 Baris Perintah Manajemen Gambar DISM

Opsi Baris Perintah Layanan dan Manajemen Gambar Penyebaran (DISM)