Opzioni Command-Line di manutenzione del pacchetto del sistema operativo DISM (.cab o msu)

  • Articolo

Usare gestione e manutenzione e installazione automatica (msu Windows Update) .cab per installare o rimuovere aggiornamenti, Language Pack e per abilitare o disabilitare le funzionalità di Windows. Le funzionalità sono componenti facoltativi per il sistema operativo principale.

Sintassi

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

Per un'immagine offline sono disponibili le opzioni di manutenzione dei pacchetti del sistema operativo seguenti:

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]

Per un sistema operativo in esecuzione sono disponibili le opzioni di manutenzione dei pacchetti del sistema operativo seguenti:

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

/Get-Help /?

Se usato immediatamente dopo un'opzione della riga di comando di manutenzione dei pacchetti, vengono visualizzate informazioni sull'opzione e sugli argomenti.

È possibile che altri argomenti diventino disponibili quando viene specificata un'immagine.

Sintassi:

Dism /Get-Help

Esempi:

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

Dism /Online /Get-Packages /?

/Get-Packages

Visualizza informazioni di base su tutti i pacchetti nell'immagine. Utilizzare l'argomento o /Format:List per visualizzare l'output /Format:Table come tabella o elenco.

Sintassi:

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

Esempi:

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

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

Dism /Online /Get-Packages

/Get-PackageInfo

Visualizza informazioni dettagliate su un pacchetto fornito come file di .cab. È possibile specificare solo .cab file. Non è possibile usare questo comando per ottenere informazioni sul pacchetto per i file con estensione msu. /PackagePath:<path_to_package> può puntare a un file .cab o a una cartella.

È possibile usare l'opzione /Get-Packages per trovare il nome del pacchetto nell'immagine oppure specificare il percorso del file .cab. Il percorso del file .cab deve puntare all'origine originale del pacchetto, non alla posizione in cui il file è installato nell'immagine offline.

Sintassi:

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

Esempi:

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

Installa un pacchetto di .cab o msu specificato nell'immagine.

Nota

È possibile usare /Add-Package per aggiungere un pacchetto con estensione msu a un Windows 11 online o offline, versione 21H2 o successiva. Se si usa un'immagine di Windows prima di Windows 11, versione 21H2, è possibile aggiungere solo pacchetti msu nelle immagini di destinazione offline.

È possibile aggiungere più pacchetti in una riga di comando. Verrà verificata l'applicabilità di ogni pacchetto. Se il pacchetto non può essere applicato all'immagine specificata, verrà visualizzato un messaggio di errore. Utilizzare l'argomento /IgnoreCheck se si vuole che il comando venga elaborato senza controllare l'applicabilità di ogni pacchetto.

Sintassi:

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

  • /PackagePath può puntare a:

    • Un singolo file .cab o msu.
    • Cartella contenente un singolo file .cab espanso.
    • Cartella contenente un singolo file con estensione msu.
    • Cartella che contiene più file .cab o msu.

  • Se /PackagePath punta a una cartella che contiene un .cab o file con estensione msu nella radice, tutte le sottocartelle verranno controllate in modo ricorsivo anche per i file .cab e msu.

  • Usare l'opzione /PreventPending per ignorare l'installazione del pacchetto se il pacchetto o l'immagine di Windows ha azioni online in sospeso.

Nota

/Add-Package non esegue un controllo completo per l'applicabilità e le dipendenze di un pacchetto:

  • Se si aggiunge un pacchetto con dipendenze, assicurarsi che tutte le dipendenze vengano installate quando si aggiunge il pacchetto.
  • Se si aggiunge un file con estensione msu, assicurarsi di controllare la Knowledge Base associata per eventuali istruzioni di installazione specifiche del pacchetto.

Esempi:

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

Rimuove un pacchetto di file .cab specificato dall'immagine. È possibile specificare solo .cab file. Non è possibile usare questo comando per rimuovere i file con estensione msu.

Nota

L'uso di questo comando per rimuovere un pacchetto da un'immagine offline non ridurrà le dimensioni dell'immagine.

Sintassi:

/Remove-Package {/PackageName:<name_in_image> | /PackagePath:<path_to_cabfile>}
  • Usare /PackagePath per puntare all'origine originale del pacchetto, specificare il percorso del file CAB o specificare il pacchetto in base al nome elencato nell'immagine. Usare l'opzione /Get-Packages per trovare il nome del pacchetto nell'immagine.

Esempi:

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

Visualizza informazioni di base su tutte le funzionalità (componenti del sistema operativo che includono funzionalità di base di Windows facoltative) in un pacchetto.

Sintassi:

/Get-Features {/PackageName:<name_in_image> | /PackagePath:<path_to_cabfile>} [/Format:{Table | List}]
  • /Get-Features trova il nome dei pacchetti nell'immagine o nell'origine originale del pacchetto. Se non si specifica un nome o un percorso del pacchetto, verranno elencate tutte le funzionalità dell'immagine.
  • /PackageName è un pacchetto in un'immagine. È possibile usare /DISM Get-Packages per visualizzare i nomi dei pacchetti in un'immagine.
  • /PackagePath può puntare a un file .cab o a una cartella.

Utilizzare l'argomento o /Format:List per visualizzare l'output /Format:Table come tabella o elenco.

Esempi:

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

Visualizza informazioni dettagliate su una funzionalità. È necessario utilizzare /FeatureName. È possibile usare l'opzione /Get-Features per trovare il nome della funzionalità nell'immagine.

Sintassi:

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

/PackageName e /PackagePath sono facoltativi e possono essere usati per trovare una funzionalità specifica in un pacchetto.

Esempi:

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

Abilita o aggiorna la funzionalità specificata nell'immagine. È necessario usare l'opzione /FeatureName . Usare l'opzione /Get-Features per trovare il nome della funzionalità nell'immagine.

Sintassi:

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

È possibile specificare l'opzione /FeatureName più volte in una riga di comando per le funzionalità che condividono lo stesso pacchetto padre.

Non è necessario specificare il nome del pacchetto usando l'opzione /PackageName se il pacchetto è un pacchetto di Windows Foundation. In caso contrario, utilizzare /PackageName per specificare il pacchetto padre della funzionalità.

È possibile ripristinare e abilitare una funzionalità rimossa in precedenza dall'immagine. Usare l'argomento /Source per specificare il percorso dei file necessari per ripristinare la funzionalità. L'origine dei file può essere eseguita dalla cartella Windows in un'immagine montata, ad esempio c:\test\mount\Windows. È anche possibile usare una cartella side-by-side di Windows come origine dei file, ad esempio z:\sources\SxS.

Se si specificano più /Source argomenti, i file vengono raccolti dal primo percorso in cui vengono trovati e gli altri percorsi vengono ignorati. Se non si specifica /Source per una funzionalità rimossa, viene usato il percorso predefinito nel Registro di sistema o, per le immagini online, viene usato Windows Update (WU).

  • Usare /LimitAccess per impedire a GESTIONE e manutenzione immagini distribuzione di contattare WU per le immagini online.
  • Usare /All per abilitare tutte le funzionalità padre della funzionalità specificata.

Esempi:

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

Disabilita la funzionalità specificata nell'immagine. È necessario usare l'opzione /FeatureName. Usare l'opzione /Get-Features per trovare il nome della funzionalità nell'immagine.

Sintassi:

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

È possibile specificare /FeatureName più volte in una riga di comando per le funzionalità nello stesso pacchetto padre.

Non è necessario specificare il nome del pacchetto usando l'opzione /PackageName se il pacchetto è un pacchetto Windows Foundation. In caso contrario, usare /PackageName per specificare il pacchetto padre della funzionalità.

Usare /Remove per rimuovere una funzionalità senza rimuovere il manifesto della funzionalità dall'immagine. La funzionalità verrà elencata come "Rimossa" quando si usano /Get-FeatureInfo per visualizzare i dettagli delle funzionalità e può essere ripristinata e abilitata usando /Enable-Feature con l'opzione /Source.

Esempi:

*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

Esegue operazioni di pulizia o ripristino sull'immagine. /AnalyzeComponentStoree /ResetBase può essere usato con immagini Windows 10, Windows 8.1 e Windows PE superiori a 5.0. A partire da Windows 10, versione 1607, è possibile specificare con /ResetBase, ma è consigliabile /Defer usare /Defersolo come opzione nella factory in cui DISM /Resetbase sono necessari più di 30 minuti per completare.

Suggerimento

Per determinare quando è stata eseguita l'ultima esecuzione dell'opzione /ResetBase, controllare la voce del Registro di sistema LastResetBase_UTC nel percorso del HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Component Based Servicing Registro di sistema.

Sintassi:

/Cleanup-Image {/RevertPendingActions | /SPSuperseded [/HideSP] | /StartComponentCleanup [/ResetBase [/Defer]] | /AnalyzeComponentStore | /CheckHealth | /ScanHealth | /RestoreHealth [/Source: <filepath>] [/LimitAccess]}
Parametro Descrizione
/RevertPendingActions Se si verifica un errore di avvio, è possibile usare l'opzione /RevertPendingActions per provare a ripristinare il sistema. L'operazione ripristina tutte le azioni in sospeso dalle operazioni di manutenzione precedenti perché queste azioni potrebbero essere la causa dell'errore di avvio. L'opzione /RevertPendingActions non è supportata in un sistema operativo in esecuzione o in un'immagine windows PE o Windows Recovery Environment (Windows RE). Importante: è consigliabile usare l'opzione /RevertPendingActions solo in uno scenario di ripristino di sistema in un'immagine di Windows che non è stata avviata.
SPSuperseded Rimuove tutti i file di backup creati durante l'installazione di un Service Pack. Usare /HideSP per impedire che il Service Pack venga elencato nella Aggiornamenti Pannello di controllo installata. Impossibile disinstallare il Service Pack dopo il completamento dell'operazione /SPSupersed.
/StartComponentCleanup Pulisce i componenti sostituiti e riduce le dimensioni dell'archivio componenti. Usare /ResetBase per reimpostare la base dei componenti sostituite, che possono ridurre ulteriormente le dimensioni dell'archivio componenti. Gli aggiornamenti di Windows installati non possono essere disinstallati dopo l'esecuzione di /StartComponentCleanup con l'opzione /ResetBase. Usare /Defer con /ResetBase per rinviare le operazioni di pulizia a esecuzione prolungata alla manutenzione automatica successiva.
/AnalysisComponentStore Crea un report dell'archivio componenti. Per altre informazioni sul report e su come usare le informazioni fornite nel report, vedere Determinare le dimensioni effettive della cartella WinSxS.
/CheckHealth Verifica se l'immagine è stata contrassegnata come danneggiata da un processo non riuscito e se è possibile ripristinare il danneggiamento.
/ScanHealth Analizza l'immagine per il danneggiamento dell'archivio componenti. Questa operazione richiede diversi minuti.
/RestoreHealth Analizza l'immagine per il danneggiamento dell'archivio componenti e quindi esegue automaticamente le operazioni di ripristino. Questa operazione richiede diversi minuti.
/Source Usato con /RestoreHealth per specificare il percorso delle versioni valide note dei file che possono essere usati per il ripristino, ad esempio un percorso della directory di Windows di un'immagine montata.
/LimitAccess Impedisce al servizio di protezione dei dati di contattare Windows Update per la riparazione di immagini online.

Esempi:

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

Per altre informazioni, vedere Ripristinare un'immagine di Windows.

Limitazioni

  • Quando si installa un pacchetto in un'immagine offline, lo stato del pacchetto è "installa in sospeso" a causa di azioni online in sospeso. In altre parole, il pacchetto verrà installato quando l'immagine viene avviata e le azioni online vengono elaborate. Se le azioni successive vengono richieste, non possono essere elaborate fino al completamento dell'azione online in sospeso precedente. È possibile usare l'opzione /PreventPending quando si aggiunge un pacchetto con /AddPackage per ignorare l'installazione di un pacchetto quando sono presenti azioni online in sospeso.
  • Alcuni pacchetti richiedono prima l'installazione di altri pacchetti. Non è consigliabile presupporre che le dipendenze saranno soddisfatte. Se un pacchetto ha requisiti di dipendenza, usare un file di risposta per installare i pacchetti necessari. Passando un file di risposte a DISM, è possibile installare più pacchetti nell'ordine corretto. Per altre informazioni, vedere Aggiungere o rimuovere pacchetti offline tramite gestione dati di distribuzione.
  • I pacchetti vengono installati nell'ordine in cui sono elencati nella riga di comando.
  • Quando si usa DISM per elencare i componenti facoltativi in un'immagine di Windows PE, i componenti facoltativi verranno sempre elencati come in sospeso anche quando l'operazione di manutenzione è riuscita. Questa operazione è in base alla progettazione e non richiede alcuna azione aggiuntiva.

Che cos'è DISM?

Opzioni Command-Line di gestione delle immagini DISM

Opzioni di manutenzione e Command-Line gestione delle immagini di distribuzione