Condividi tramite

Pacchetto del sistema operativo DISM (.cab o msu) Opzioni della riga di comando

  • Articolo

Usare gestione e manutenzione e manutenzione distribuzione con file di installazione autonoma (msu) di Windows Update (.cab) o windows Update 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 /?

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

Altri argomenti potrebbero diventare 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 /Format:Table o /Format:List per visualizzare l'output 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 .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 .cab o msu specificato nell'immagine.

Nota

Puoi usare /Add-Package per aggiungere un pacchetto msu a un'immagine online o offline di Windows 11, versione 21H2 o successiva. Se si usa un'immagine di Windows precedente a Windows 11, versione 21H2, è possibile aggiungere pacchetti con estensione msu solo 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. Usare l'argomento /IgnoreCheck se si vuole che il comando eselabori 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 contenente 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 dell'applicabilità e delle 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

Aggiornamenti cumulativi del checkpoint

A partire da Windows 11, versione 24H2, l'aggiornamento cumulativo più recente potrebbe avere un aggiornamento cumulativo prerequisito necessario per essere installato per primo. Per installare questi aggiornamenti cumulativi del checkpoint, chiamare /Add-Package con l'aggiornamento cumulativo di destinazione. La cartella da -PackagePath verrà usata per individuare e installare uno o più checkpoint in base alle esigenze. Solo l'aggiornamento cumulativo di destinazione e gli aggiornamenti cumulativi dei checkpoint dei prerequisiti devono trovarsi nella cartella -PackagePath. I pacchetti di aggiornamento cumulativo con una revisione minore o uguale all'aggiornamento cumulativo di destinazione verranno elaborati.

/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 come indicato 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 /Format:Table o /Format:List per visualizzare l'output 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 usare /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, usare /PackageName per specificare il pacchetto padre della funzionalità.

È possibile ripristinare e abilitare una funzionalità che in precedenza è stata rimossa 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à che è stata 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 possono essere ripristinate e abilitate 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. /AnalyzeComponentStore e /ResetBase possono essere usati con immagini Windows 10, Windows 8.1 e Windows PE superiori alla 5.0. A partire da Windows 10 versione 1607, è possibile specificare /Defer con /ResetBase, ma è consigliabile usare /Defer solo come opzione nella factory in cui DISM /Resetbase sono necessari più di 30 minuti per il completamento.

Suggerimento

Per determinare quando l'opzione /ResetBase è stata eseguita per l'ultima volta, 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 Ambiente ripristino Windows (Ambiente ripristino Windows). Importante: è consigliabile usare l'opzione /RevertPendingActions solo in uno scenario di ripristino di sistema in un'immagine di Windows che non è stata avviata.
SPSupersed 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 Pannello di controllo Aggiornamenti installati. Non è possibile 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 sostituiti, riducendo ulteriormente le dimensioni dell'archivio componenti. Non è possibile disinstallare gli aggiornamenti di Windows installati 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.
/AnalyzeComponentStore 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 Controlla se l'immagine è stata contrassegnata come danneggiata da un processo non riuscito e se è possibile ripristinare il danneggiamento.
/ScanHealth Analizza l'immagine per individuare il danneggiamento dell'archivio componenti. Questa operazione richiederà alcuni minuti.
/RestoreHealth Analizza l'immagine per individuare il danneggiamento dell'archivio componenti e quindi esegue automaticamente le operazioni di ripristino. Questa operazione richiederà alcuni minuti.
/Fonte Usato con /RestoreHealth per specificare il percorso delle versioni valide note dei file che possono essere usati per il ripristino, ad esempio un percorso alla directory di Windows di un'immagine montata.
/LimitAccess Impedisce a Gestione e manutenzione immagini distribuzione di contattare Windows Update per il ripristino 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.

Limiti

  • 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 all'avvio dell'immagine e le azioni online vengono elaborate. Se vengono richieste azioni successive, 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 l'installazione di altri pacchetti per primi. Non è consigliabile presupporre che le dipendenze saranno soddisfatte. Se un pacchetto ha requisiti di dipendenza, usare un file di risposte per installare i pacchetti necessari. Passando un file di risposte a Gestione e manutenzione dischi distribuzione, è possibile installare più pacchetti nell'ordine corretto. Per altre informazioni, vedere Aggiungere o rimuovere pacchetti offline tramite gestione e manutenzione distribuzione.
  • I pacchetti vengono installati nell'ordine in cui sono elencati nella riga di comando.
  • Quando si usa Gestione e manutenzione immagini distribuzione 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 ha avuto esito positivo. Questa operazione è per impostazione predefinita e non richiede alcuna azione aggiuntiva.

Che cos'è gestione e manutenzione e manutenzione distribuzione?

Opzioni della riga di comando di gestione dell'immagine per Gestione e manutenzione immagini distribuzione

Opzioni della riga di comando DiSM (Deployment Image Servicing and Management)