Opzioni Command-Line di gestione delle immagini DISM

La manutenzione e la gestione delle immagini di distribuzione (DISM.exe) monta un file immagine di Windows (con estensione wim) o un disco rigido virtuale (con estensione vhd o vhdx) per la manutenzione. È anche possibile usare il comando gestione immagini DISM per elencare i numeri di indice immagine, per verificare l'architettura per l'immagine montata, aggiungere un'immagine, applicare un'immagine, acquisire un'immagine ed eliminare un'immagine. Dopo aver aggiornato l'immagine, è necessario smontarla e eseguirne il commit o ignorare le modifiche apportate.

Questo argomento illustra i comandi DISM correlati alla gestione delle immagini. Per visualizzare altre opzioni della riga di comando, vedere Gestione e manutenzione immagini distribuzione (DISM) Command-Line Opzioni. Per altre informazioni sugli scenari DISM comuni, vedere Informazioni su DISM?.

Oltre allo strumento da riga di comando, il servizio di gestione delle licenze è disponibile usando Windows PowerShell. Per altre informazioni, vedere Cmdlet DISM (Deployment Imaging Servicing Management) in Windows PowerShell.

I comandi seguenti possono essere usati per montare, smontare, acquisire, aggiungere ed eliminare ed eseguire query su file con estensione wim, vhd e vhdx. Queste opzioni non sono distinzione tra maiuscole e minuscole.

/Append-Image

Aggiunge un'immagine aggiuntiva a un file con estensione wim. /Append-Image confronta i nuovi file con le risorse nel file con estensione wim esistente specificato dall'argomento /ImageFile e archivia solo una singola copia di ogni file univoco in modo che ogni file venga acquisito una sola volta. Il file wim può avere un solo tipo di compressione assegnato. Pertanto, è possibile aggiungere solo file con lo stesso tipo di compressione.

Questa opzione della riga di comando non si applica ai file VHD (Virtual Disk).

Importante

Assicurarsi di disporre di spazio su disco sufficiente per l'esecuzione dell'opzione /Append-Image . Se si esce dallo spazio su disco durante l'aggiunta dell'immagine, è possibile che il file wim venga danneggiato.

Sintassi:

DISM.exe /Append-Image /ImageFile:<path_to_image_file> /CaptureDir:<source_directory> /Name:<image_name> [/Description:<image_description>] [/ConfigFile:<configuration_file.ini>] [/Bootable] /WIMBoot [/CheckIntegrity] [/Verify] [/NoRpFix]
Parametro Descrizione
/WIMBoot Usare /WIMBoot per aggiungere l'immagine con la configurazione di avvio del file di immagine di Windows (WIMBoot). Questo vale solo per le immagini Windows 8.1 acquisite o esportate come file WIMBoot. Questa funzionalità non è supportata in Windows 10.
/ConfigFile specifica il percorso di un file di configurazione che elenca le esclusioni per l'acquisizione di immagini e comprimere i comandi. Per altre informazioni, vedere Elenco di configurazione DISM e file di WimScript.ini.
/Avviabile Contrassegna un'immagine di volume come immagine avviabile. Questo argomento è disponibile solo per le immagini Windows Preinstallation Environment (WinPE). È possibile contrassegnare soltanto un'immagine di volume come avviabile in un file con estensione wim.
/CheckIntegrity Rileva e tiene traccia del danneggiamento del file con estensione wim quando usato con operazioni di acquisizione, smontaggio, esportazione e commit. /CheckIntegrity arresta l'operazione se DISM rileva che il file con estensione wim viene danneggiato quando viene usato con le operazioni di applicazione e montaggio.
/Verificare Esegue un controllo per rilevare eventuali errori e duplicazioni di file.
/NoRpFix Disattiva la correzione del tag di reparse point. Un reparse point è un file contenente un collegamento a un altro file del file system. Se /NoRpFix non è specificato, non verranno acquisiti i punti reparse che si risolvono ai percorsi esterni al valore specificato da /ImageFile.

Esempio:

Dism /Append-Image /ImageFile:install.wim /CaptureDir:D:\ /Name:Drive-D

/Apply-FFU

Per FFU, questo comando applica un'utilità FFU (Full Flash Utility) o divide FFU (FFU) a un'unità fisica specificata.

Sintassi:

/Apply-Ffu /ImageFile:<path_to_image_file> /ApplyDrive:<physical_drive_path> [/SFUFile:<pattern>]
Parametro Descrizione
/ImageFile Percorso e nome del file di immagine FFU che verrà applicato
/ApplyDrive Percorso dell'unità fisica che verrà immagine
Modello /SFUfile<> Facoltativo, per le FFS suddivise acquisite senza compressione. Usare /SFUFile per fare riferimento ai file FFU (SFUS). Il modello è il modello di denominazione e il percorso dei file di divisione. Usare un carattere jolly quando si specifica il modello di denominazione. Ad esempio, "E:\image\install*.sfu" applicherà tutti i file di divisione nella directory E:\image denominata install1.sfu, install2.sfu e così via.

Esempio:

DISM.exe /Apply-Ffu /ImageFile:flash.ffu /ApplyDrive:\\.\PhysicalDrive0

/Apply-Image

Per WIM, questo comando applica un file di immagine di Windows (con estensione wim) o un file di windows diviso (con estensione swm) a una partizione specificata. A partire da Windows 10, versione 1607, DISM può applicare e acquisire attributi estesi (EA).

Per FFU, questo comando applica un'immagine di aggiornamento flash completo (con estensione ffu) a un'unità specificata. Non supporta l'applicazione di un'immagine da un file di disco rigido virtuale (con estensione vhdx), anche se è possibile usare questo comando per applicare un'immagine completa a un disco rigido virtuale. FFU si applica solo a Windows 10. Anche se è possibile usare questo comando per applicare un FFU, usare /apply-ffu invece.

Questa opzione non supporta l'applicazione di un'immagine da un disco rigido virtuale (VHD), anche se è possibile usare questo comando per applicare immagini a un file con estensione vhdx collegato, partizionato e formattato.

Argomenti per WIM:

DISM.exe /Apply-Image /ImageFile:<path_to_image_file> [/SWMFile:<pattern>] /ApplyDir:<target_directory> {/Index:< image_index> | /Name:<image_name>} [/CheckIntegrity] [/Verify] [/NoRpFix] [/ConfirmTrustedFile] [/WIMBoot (deprecated)] [/Compact] [/EA]

Argomenti per FFU

Vedere /apply-ffu.

Parametro Descrizione
/CheckIntegrity Rileva e tiene traccia del danneggiamento del file con estensione wim quando usato con operazioni di acquisizione, smontaggio, esportazione e commit. /CheckIntegrity arresta l'operazione se DISM rileva che il file con estensione wim viene danneggiato quando viene usato con le operazioni di applicazione e montaggio.
/Verificare Esegue un controllo per rilevare eventuali errori e duplicazioni di file.
/NoRpFix Disattiva la correzione del tag di reparse point. Un reparse point è un file contenente un collegamento a un altro file del file system. Se /NoRpFix non è specificato, non verranno acquisiti i punti reparse che risolvono i percorsi all'esterno del valore specificato da /ImageFile.
/SWMFile Consente di fare riferimento ai file con estensione wim (SWM). Il modello è il modello di denominazione e il percorso dei file di divisione. Usare un carattere jolly quando si specifica il modello di denominazione. Ad esempio, "E:\image\install*.swm" applicherà tutti i file di divisione nella directory E:\image denominata install1.swm, install2.swm e così via.
/ConfirmTrustedFile Convalida l'immagine per Desktop attendibile. Questa opzione può essere eseguita solo in un computer che esegue almeno WinPE 4.0. Quando si usa /Apply-Image con l'opzione /ConfirmTrustedFile in WinPE, specificare sempre l'opzione /ScratchDir che punta a un percorso multimediale fisico. Ciò garantisce che i nomi di file brevi siano sempre disponibili. Per altre informazioni sul comportamento predefinito dell'opzione /ScratchDir , vedere Opzioni globali DISM per Command-Line sintassi . A partire da Windows 10 versione 1607, è possibile usare /EA per applicare attributi estesi.
/WIMBoot Usare /WIMBoot per aggiungere l'immagine con la configurazione di avvio del file di immagine di Windows (WIMBoot). Questo vale solo per le immagini Windows 8.1 acquisite o esportate come file WIMBoot. Questa funzionalità non è supportata in Windows 10.
/Compact Applica un'immagine in modalità compatta, risparmiando spazio su unità. Sostituisce WIMBoot. Per Windows 10 solo per le edizioni desktop (Home, Pro, Enterprise e Education).

Nota: Se si applica un'immagine in modalità compatta con l'opzione /ScratchDir, assicurarsi che la cartella ScratchDir non sia in una partizione formattata FAT32. L'uso di una partizione FAT32 potrebbe comportare riavvii imprevisti durante L'OOBE.
/EA Novità in Windows 10 versione 1607. Applica attributi estesi.
/ApplyDrive Specifica l'unità logica usando DeviceID. per ottenere l'ID dispositivo dalla riga di comando, digitare "wmic diskdrive list brief". Nota: un disco rigido virtuale può essere visualizzato con il nome "PhysicalDrive" nella descrizione, ad esempio .\PhysicalDrive2.
/SFUFile Usare /SFUFile per fare riferimento ai file FFU (SFUS). Il modello è il modello di denominazione e il percorso dei file di divisione.

Esempi:

Dism /apply-image /imagefile:install.wim /index:1 /ApplyDir:D:\
Dism /apply-image /imagefile:install.swm /swmfile:install*.swm /index:1 /applydir:D:

/Capture-CustomImage

Acquisisce le modifiche incrementali del file in base al file install.wim specifico in un nuovo file, custom.wim per un'immagine WIMBoot. Non è possibile acquisire una directory vuota. I file acquisiti vengono convertiti in file puntatore. Il file custom.wim viene inserito nella stessa cartella accanto all'install.wim.

Importante

  • /Capture-CustomImage acquisisce solo i file di personalizzazione. Non può essere usato per acquisire i file di installazione in un nuovo WIM.
  • Mantenere insieme i file install.wim e custom.wim. Non disattivare il file custom.wim o il file install.wim.
  • È possibile acquisire l'immagine personalizzata una sola volta. Non rimuovere o ricaptare un file custom.wim dopo l'acquisizione delle modifiche incrementali del file.

Sintassi:

Dism /Capture-CustomImage /CaptureDir:<source_directory> [/ConfigFile:<configuration_file.ini>] [/CheckIntegrity] [/Verify] [/ConfirmTrustedFile]
Parametro Descrizione
/CaptureDir Specifica la directory a cui è stata applicata e personalizzata l'immagine.
/ConfigFile Specifica la posizione di un file di configurazione che elenca le esclusioni per i comandi di compressione e acquisizione delle immagini. Per altre informazioni, vedere Elenco di configurazione DISM e file di WimScript.ini.
/CheckIntegrity Rileva e tiene traccia del danneggiamento del file con estensione wim quando usato con operazioni di acquisizione, smontaggio, esportazione e commit. /CheckIntegrity arresta l'operazione se DISM rileva che il file con estensione wim viene danneggiato quando viene usato con le operazioni di applicazione e montaggio.
/Verificare Esegue un controllo per rilevare eventuali errori e duplicazioni di file.
[/ConfirmTrustedFile Convalida l'immagine per Desktop attendibile in un Windows 10, Windows 8.1 o Windows 8. Questa opzione può essere eseguita solo in un computer che esegue almeno WinPE 4.0.

Esempio:

Dism /Capture-CustomImage /CaptureDir:D:\

/Capture-FFU

Acquisisce un'immagine delle partizioni di un'unità fisica in un nuovo file ffu.

È possibile acquisire l'immagine come file di utilità flash completo (con estensione ffu) o un set di file ffu (con estensione sfu);

Sintassi:

Dism /Capture-Ffu /ImageFile:<path_to_image_file> /CaptureDrive:<physical_drive_path> /Name:<image_name> [/Description:<image_description>] [/PlatformIds:<platform_ids>] [/Compress:{default|none}] 
Parametro Descrizione
/CaptureDrive Unità fisica da acquisire. È possibile usare diskpart per ottenere informazioni sul numero di unità. Usa il formato \\.\PhysicalDriveX, dove X è il numero di disco fornito da diskpart.
/PlatformIds Non necessario per l'acquisizione desktop. Specifica uno o più ID piattaforma (separati con punto e virgola) da aggiungere all'immagine. Se non specificato, l'ID della piattaforma sarà '*'.
/Comprimere Specifica il tipo di compressione usato per l'acquisizione. Se si divide l'FFU, specificare none, perché DISM non supporta la suddivisione di FFU compressi.

Esempi:

Acquisire un FFU desktop:

DISM.exe /Capture-Ffu /ImageFile:install.ffu /CaptureDrive:\\.\PhysicalDrive0 /Name:Drive0

Acquisire un FFU desktop che verrà suddiviso:

DISM.exe /Capture-Ffu /ImageFile:install.ffu /CaptureDrive:\\.\PhysicalDrive0 /Name:Drive0 /Compress:none

/Capture-Image

Acquisisce un'immagine di un'unità in un nuovo file wim. Le directory acquisite includono tutte le sottocartelle e i dati. Non è possibile acquisire una directory vuota. Una directory deve contenere almeno un file. È anche possibile applicare e acquisire attributi estesi (EA) facoltativamente.

È possibile acquisire l'immagine come file immagine di Windows (con estensione wim) o un set di file di immagine Windows (con estensione swm), ma questa opzione non supporta l'acquisizione di un file disco rigido virtuale (con estensione vhd/.vhdx). Vedere /Capture-FFU se si sta cercando di acquisire un FFU.

Sintassi:

Dism /Capture-Image /ImageFile:<path_to_image_file> /CaptureDir:<source_directory> /Name:<image_name> [/Description:<image_description>]
[/ConfigFile:<configuration_file.ini>] {[/Compress:{max|fast|none}] [/Bootable] | [/WIMBoot]} [/CheckIntegrity] [/Verify] [/NoRpFix] [/EA]
Parametro Descrizione
/ConfigFile Specifica la posizione di un file di configurazione che elenca le esclusioni per i comandi di compressione e acquisizione delle immagini. Per altre informazioni, vedere Elenco di configurazione DISM e file di WimScript.ini.
/Comprimere Specifica il tipo di compressione usato per l'operazione di acquisizione iniziale. L'opzione massima offre la compressione migliore, ma richiede più tempo per acquisire l'immagine. L'opzione veloce offre una compressione più rapida dell'immagine, ma i file risultanti sono più grandi di quelli compressi usando l'opzione massima. Questo è anche il tipo di compressione predefinito usato se non si specifica l'argomento. L'opzione nessuno non comprime l'immagine acquisita.
/Avviabile Contrassegna un'immagine di volume come immagine avviabile. Questo argomento è disponibile solo per le immagini WinPE. È possibile contrassegnare soltanto un'immagine di volume come avviabile in un file con estensione wim.
/CheckIntegrity Rileva e tiene traccia del danneggiamento del file con estensione wim quando usato con operazioni di acquisizione, smontaggio, esportazione e commit. /CheckIntegrity arresta l'operazione se DISM rileva che il file con estensione wim viene danneggiato quando viene usato con le operazioni di applicazione e montaggio.
/Verificare Esegue un controllo per rilevare eventuali errori e duplicazioni di file.
/NoRpFix Disattiva la correzione del tag di reparse point. Un reparse point è un file contenente un collegamento a un altro file del file system. Se /NoRpFix non è specificato, non verranno acquisiti i punti reparse che si risolvono ai percorsi esterni al valore specificato da /ImageFile.
/WIMBoot Usare /WIMBoot per aggiungere l'immagine con la configurazione di avvio del file di immagine di Windows (WIMBoot). Questo vale solo per le immagini Windows 8.1 acquisite o esportate come file WIMBoot. Questa funzionalità non è supportata in Windows 10.
/EA Acquisisce gli attributi estesi. L'opzione deve essere specificata in modo esplicito per acquisire attributi estesi. Gestione dati di configurazione acquisisce bit di attributo estesi se vengono impostati nei componenti da acquisire nell'immagine WIM. Se i bit non sono impostati, il modulo di protezione dei dati non verrà impostato. Solo i componenti della posta in arrivo dei pacchetti CAB e dei driver avranno questi bit di attributo estesi, non i componenti del pacchetto AppX o i componenti dell'applicazione Win32. Attributi estesi con prefisso "$Kernel". in name verrà ignorato perché vengono acquisiti solo gli attributi estesi in modalità utente. Se si usa DISM in Windows 10, versione 1607 per acquisire attributi estesi e usare una versione precedente di DISM per applicare l'immagine, l'operazione avrà esito positivo, ma gli attributi estesi non verranno impostati sull'immagine applicata.

Esempi:

Dism /Capture-Image /ImageFile:install.wim /CaptureDir:D:\ /Name:Drive-D
dism /Capture-Image /CaptureDir:C:\ /ImageFile:"C:\WindowsWithOffice.wim" /Name:"Chinese Traditional" /ea

/Cleanup-Mountpoints

Elimina tutte le risorse associate a un'immagine montata danneggiata. Questo comando non smonterà le immagini già montate, né eliminerà le immagini che possono essere ripristinate usando il comando /Remount-Image .

Esempio:

Dism /Cleanup-Mountpoints

Per altre informazioni, vedere Ripristinare un'immagine di Windows

/Commit-Image

Applica le modifiche apportate all'immagine montata. L'immagine rimane montata finché non viene usata l'opzione /Unmount-Image .

Sintassi:

Dism /Commit-Image /MountDir:<path_to_mount_directory> [/CheckIntegrity] [/Append]
Parametro Descrizione
/CheckIntegrity Rileva e tiene traccia del danneggiamento del file con estensione wim quando usato con operazioni di acquisizione, smontaggio, esportazione e commit. /CheckIntegrity arresta l'operazione se DISM rileva che il file con estensione wim viene danneggiato quando viene usato con le operazioni di applicazione e montaggio.
/Aggiungere Aggiunge l'immagine modificata al file con estensione wim esistente anziché sovrascrivere l'immagine originale. Gli argomenti /CheckIntegrity e /Append non si applicano ai file VHD (Virtual Hard Disk).

Esempio:

Dism /Commit-Image /MountDir:C:\test\offline

/Delete-Image

Elimina l'immagine del volume specificata da un file con estensione wim con più immagini del volume. Questa opzione elimina solo le voci di metadati e le voci XML. Non elimina i dati del flusso e non ottimizza il file wim.

Questa opzione della riga di comando non si applica ai file VHD (Virtual Disk).

Sintassi:

Dism /Delete-Image /ImageFile:<path_to_image_file> {/Index:<image_index> | /Name:<image_name>} [/CheckIntegrity]
Parametro Descrizione
/CheckIntegrity Rileva e tiene traccia del danneggiamento del file con estensione wim quando usato con operazioni di acquisizione, smontaggio, esportazione e commit. /CheckIntegrity arresta l'operazione se DISM rileva che il file con estensione wim viene danneggiato quando viene usato con le operazioni di applicazione e montaggio.

Esempio:

Dism /Delete-Image /ImageFile:install.wim /Index:1

/Export-Image

Esporta una copia dell'immagine specificata in un altro file. I file di origine e di destinazione devono usare lo stesso tipo di compressione. È anche possibile ottimizzare un'immagine esportando in un nuovo file di immagine. Quando si modifica un'immagine, diSM archivia file di risorse aggiuntivi che aumentano le dimensioni complessive dell'immagine. L'esportazione dell'immagine rimuoverà i file di risorse non necessari.

Questa opzione della riga di comando non si applica ai file VHD (Virtual Disk).

Sintassi:

Dism /Export-Image /SourceImageFile:<path_to_image_file> {/SourceIndex:<image_index> | /SourceName:<image_name>} /DestinationImageFile:<path_to_image_file> [/DestinationName:<Name>] [/Compress:{fast|max|none|recovery}] [/Bootable] [/WIMBoot] [/CheckIntegrity]
Parametro Descrizione
/SWMFile Consente di fare riferimento ai file con estensione wim suddivisi. pattern è il modello di denominazione e il percorso dei file di divisione. È anche possibile specificare caratteri jolly. Ad esempio, "E:\image\install*.swm" esportare i file di divisione nella directory E:\image denominata install1.swm, install2.swm e così via.
/Comprimere Specifica il tipo di compressione usato per l'operazione di acquisizione iniziale. L'argomento /Compress non si applica quando si esporta un'immagine in un file con estensione wim esistente, è possibile usare questo argomento solo quando si esporta un'immagine in un nuovo file wim. L'opzione massima offre la compressione migliore, ma richiede più tempo per acquisire l'immagine. L'opzione veloce offre una compressione più rapida dell'immagine, ma i file risultanti sono più grandi di quelli compressi usando l'opzione massima . Questo è anche il tipo di compressione predefinito usato se non si specifica l'argomento. Usare l'opzione di ripristino per esportare immagini di reimpostazione del pulsante push. I file risultanti sono molto più piccoli, che a sua volta riducono notevolmente la quantità di spazio su disco necessario per salvare l'immagine di reimpostazione del pulsante push in un'unità di ripristino. Il file di destinazione deve essere specificato con un'estensione con estensione esd. L'opzione nessuno non comprime l'immagine acquisita.
/Avviabile Contrassegna un'immagine di volume come immagine avviabile. Questo argomento è disponibile solo per le immagini WinPE. È possibile contrassegnare soltanto un'immagine di volume come avviabile in un file con estensione wim.
/WIMBoot Usare /WIMBoot per aggiungere l'immagine con la configurazione di avvio del file di immagine di Windows (WIMBoot). Questo vale solo per le immagini Windows 8.1 acquisite o esportate come file WIMBoot. Questa funzionalità non è supportata in Windows 10.
/CheckIntegrity Rileva e tiene traccia del danneggiamento del file con estensione wim quando usato con operazioni di acquisizione, smontaggio, esportazione e commit. /CheckIntegrity arresta l'operazione se DISM rileva che il file con estensione wim viene danneggiato quando viene usato con le operazioni di applicazione e montaggio.

Esempio:

Dism /Export-Image /SourceImageFile:install.wim /SourceIndex:1 /DestinationImageFile:install2.wim

/Get-ImageInfo

Visualizza informazioni sulle immagini contenute in un file con estensione wim, .ffu, vhd o vhdx. Quando viene usato con l'argomento /Index o /Name, vengono visualizzate informazioni sull'immagine specificata, che include se un'immagine è un'immagine WIMBoot, se l'immagine è Windows 8.1, vedere Eseguire l'inventario di un'immagine o un componente usando diSM. L'argomento /Name non si applica ai file VHD. È necessario specificare /Index:1 per i file FFU e VHDX.

Sintassi:

Dism /Get-ImageInfo /ImageFile:<path_to_image.wim> [{/Index:<Image_index> | /Name:<Image_name>}]

Esempi:

Dism /Get-ImageInfo /ImageFile:C:\test\offline\install.wim
Dism /Get-ImageInfo /ImageFile:C:\test\images\myimage.vhd /Index:1

/Get-MountedImageInfo

Restituisce un elenco di immagini con estensione ffu, vhd, vhdx e wim attualmente montate, nonché informazioni sull'immagine montata, ad esempio se l'immagine è valida, autorizzazioni di lettura/scrittura, percorso di montaggio, percorso di montaggio e indice dell'immagine montato.

Esempio:

Dism /Get-MountedImageInfo

/Get-WIMBootEntry

Usare /Get-WIMBootEntry per visualizzare le voci di configurazione WIMBoot per il volume del disco specificato.

Per altre informazioni su come visualizzare le voci di configurazione di WIMBoot, vedere Eseguire l'inventario di un'immagine o di un componente usando diSM.For more information about how to display WIMBoot configuration e see Take Inventory of an Image or Component Using DISM.

Questo vale solo per Windows 8.1. Questa funzionalità non è supportata in Windows 10.

Sintassi:

Dism /Get-WIMBootEntry /Path:<volume_path>

Esempio:

Dism /Get-WIMBootEntry /Path:C:\

/List-Image

Visualizza un elenco dei file e delle cartelle in un'immagine specificata.

Questa opzione della riga di comando non si applica ai file VHD (Virtual Disk).

Sintassi:

Dism /List-Image /ImageFile:<path_to_image_file> {/Index:<image_index> | /Name:<image_name>}

Esempio:

Dism /List-Image /ImageFile:install.wim /Index:1

/Mount-Image

Monta un'immagine da un file con estensione ffu, wim, vhd o vhdx nella directory specificata in modo che sia disponibile per la manutenzione.

Quando si monta un'immagine, tenere presente quanto segue:

  • La directory di montaggio deve essere creata, ma vuota.
  • Per tutti i tipi di immagine è necessario un valore di indice o nome. Le MACCHINE VIRTUALI possono contenere più di un'immagine. Per FFU e VHD, usare index:1.

Sintassi:

Dism /Mount-Image /ImageFile:<path_to_image_file> {/Index:<image_index> | /Name:<image_name>} /MountDir:<path_to_mount_directory> [/ReadOnly] [/Optimize] [/CheckIntegrity]
Parametro Descrizione
/Readonly Imposta l'immagine montata con autorizzazioni di sola lettura. Facoltativa.
/Ottimizzare Riduce il tempo di montaggio iniziale.
/CheckIntegrity Rileva e tiene traccia del danneggiamento del file con estensione wim quando usato con operazioni di acquisizione, smontaggio, esportazione e commit. /CheckIntegrity arresta l'operazione se DISM rileva che il file con estensione wim viene danneggiato quando viene usato con le operazioni di applicazione e montaggio.

Esempi:

Dism /Mount-Image /ImageFile:C:\test\images\myimage.wim /index:1 /MountDir:C:\test\offline
Dism /Mount-Image /ImageFile:C:\test\images\myimage.vhd /index:1 /MountDir:C:\test\offline /ReadOnly
Dism /Mount-Image /ImageFile:C:\test\images\WinOEM.ffu /MountDir:C:\test\offline /index:1

/Optimize-FFU

Ottimizza un'immagine FFU in modo che sia più veloce per la distribuzione e possa anche essere più facilmente distribuita in dischi di dimensioni diverse. Per altre informazioni, vedere Acquisire e applicare immagini di Windows Full Flash Update .

Sintassi:

Dism /Optimize-FFU /ImageFile:<path-to-ffu-file> [/PartitionNumber:<PartitionNumber>]
Parametro Descrizione
/ImageFile Percorso dell'FFU da ottimizzare.
/PartitionNumber Facoltativa. Per impostazione predefinita, la partizione del sistema operativo viene ottimizzata /Optimize-FFU . /PartitionNumber consente di specificare la partizione da ottimizzare.

Esempi:

Dism /Optimize-FFU /ImageFile:flash.ffu
Dism /Optimize-FFU /ImageFile:flash.ffu /PartitionNumber:2

/Optimize-Image

Questo comando deve essere l'ultimo comando eseguito su un'immagine prima che l'immagine venga applicata a un dispositivo e possa ridurre il tempo sul piano della fabbrica quando si creano dispositivi per scenari di compilazione a magazzino.

Sintassi:

DISM.exe /Image:C:\test\offline /Optimize-Image {/Boot | /WimBoot}
  • /Boot tenta di ridurre il tempo di configurazione online trascorso dal sistema operativo durante l'avvio. Questa ottimizzazione può essere resa non valida se le operazioni di manutenzione vengono eseguite sull'immagine dopo l'ottimizzazione.

    DISM /Optimize-Image /boot è disponibile nei sistemi operativi seguenti:

    • Windows 11

    • Windows 10 versione 1607

    • Windows 10 versione 1809 e successive

    • Windows Server 2012 R2 in seguito

      Usare /Boot per provare a ridurre il tempo di configurazione online trascorso dal sistema operativo durante l'avvio. Si noti che questa ottimizzazione può essere resa non valida se le operazioni di manutenzione vengono eseguite sull'immagine dopo l'ottimizzazione.

  • /WimBoot è per configurare un'immagine offline per l'installazione in un sistema WIMBoot.

Esempi:

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

/Remount-Image

Rimonta un'immagine montata che è diventata inaccessibile e la rende disponibile per la manutenzione.

Sintassi:

Dism /Remount-Image /MountDir:<path_to_mount_directory>

Esempio:

Dism /Remount-Image /MountDir:C:\test\offline

/Split-FFU

Per FFU, questo comando divide un file full-flash update (ffu) esistente in più file sfu di sola lettura. Il servizio di distribuzione non supporta la suddivisione delle FFC compresse. Se si suddivideno le FFU, assicurarsi che il FFU sia stato acquisito con l'opzione /compress:none specifica.

Questa opzione crea i file con estensione sfu nella directory specificata, assegnando una denominazione a ogni file uguale a /SFUFile specificato, ma con un numero aggiunto. Ad esempio, se si usa c:\flash.sfu, si otterrà un file flash.sfu, un file flash2.ffu, un file flash3.sfu e così via, definendo ogni parte del file split .sfu e salvandolo in C:\ Directory.

Sintassi per FFU:

Dism /Split-Ffu /ImageFile:<path_to_image_file> /SFUFile:<pattern> /FileSize:<MB-Size> [/CheckIntegrity]
Parametro Descrizione
/Dimensione Specifica le dimensioni massime in megabyte (MB) per ogni file creato. Se un singolo file è maggiore del valore specificato nell'opzione /FileSize, uno dei file con estensione swm di divisione con estensione swm sarà maggiore del valore specificato nell'opzione /FileSize, in modo da supportare il file di grandi dimensioni.
/CheckIntegrity Rileva e tiene traccia del danneggiamento del file con estensione wim quando usato con operazioni di acquisizione, smontaggio, esportazione e commit. /CheckIntegrity arresta l'operazione se DISM rileva che il file con estensione wim viene danneggiato quando viene usato con le operazioni di applicazione e montaggio.
/ImageFile Specifica il percorso di un oggetto . File FFU, ad esempio: flash.ffu.
/SFUFile Riferimenti suddivideno i file FFU (SFUS). Il modello è il modello di denominazione e il percorso dei file di divisione.

Esempio:

DISM.exe /Split-Ffu /ImageFile:flash.ffu /SFUFile:flash.sfu /FileSize:650

/Split-Image

Per WIM, questo comando suddivide un file con estensione wim esistente in più file con estensione swm di sola lettura.

Questa opzione crea i file con estensione swm nella directory specificata, assegnando un nome a ogni file uguale al path_to_swm specificato, ma con un numero aggiunto. Ad esempio, se si imposta path_to_swm come c:\Data.swm, questa opzione crea un file Data.swm, un file Data2.swm, un file Data3.swm e così via, definendo ogni parte del file con estensione wim diviso e salvandolo in C:\ Directory.

Questa opzione della riga di comando non si applica ai file VHD (Virtual Disk).

Sintassi per WIM:

Dism /Split-Image /ImageFile:<path_to_image_file> /SWMFile:<path_to_swm> /FileSize:<MB-Size> [/CheckIntegrity]
Parametro Descrizione
/Dimensione Specifica le dimensioni massime in megabyte (MB) per ogni file creato. Se un singolo file è maggiore del valore specificato nell'opzione /FileSize, uno dei file con estensione swm di divisione con estensione swm sarà maggiore del valore specificato nell'opzione /FileSize, in modo da supportare il file di grandi dimensioni.
/CheckIntegrity Rileva e tiene traccia del danneggiamento del file con estensione wim quando usato con operazioni di acquisizione, smontaggio, esportazione e commit. /CheckIntegrity arresta l'operazione se DISM rileva che il file con estensione wim viene danneggiato quando viene usato con le operazioni di applicazione e montaggio.
/ImageFile Specifica il percorso di un file di immagine, ad esempio install.wim.

Esempio:

Dism /Split-Image /ImageFile:install.wim /SWMFile:split.swm /FileSize:650

/Unmount-Image

Smonta il file con estensione ffu, wim, vhd o vhdx e esegue il commit o elimina le modifiche apportate quando l'immagine è stata montata.

È necessario usare l'argomento /commit o /discard quando si usa l'opzione /Unmount-Image.

Sintassi:

Dism /Unmount-Image /MountDir:<path_to_mount_directory> {/Commit | /Discard} [/CheckIntegrity] [/Append]
Parametro Descrizione
/CheckIntegrity Rileva e tiene traccia del danneggiamento del file con estensione wim quando usato con operazioni di acquisizione, smontaggio, esportazione e commit. /CheckIntegrity arresta l'operazione se DISM rileva che il file con estensione wim viene danneggiato quando viene usato con le operazioni di applicazione e montaggio.
/Aggiungere Aggiunge l'immagine modificata al file con estensione wim esistente anziché sovrascrivere l'immagine originale. Gli argomenti /CheckIntegrity e /Append non si applicano ai file FFU (VHD, VHDX) o FFU.

Esempi:

Dism /Unmount-Image /MountDir:C:\test\offline /commit
Dism /Unmount-Image /MountDir:C:\test\offline /discard

/Update-WIMBootEntry

Aggiornamenti la voce di configurazione WIMBoot associata all'ID origine dati specificato, con il file di immagine rinominato o il percorso del file immagine spostato.

Nota:/Update-WIMBootEntry richiede un riavvio per consentire agli aggiornamenti di eseguire l'effetto.

Sintassi:

Dism /Update-WIMBootEntry /Path:<Volume_path> /DataSourceID:<Data_source_id> /ImageFile:<Renamed_image_path>
Parametro Descrizione
/Percorso Specifica il volume del disco della configurazione WIMBoot.
/Datasourceid Specifica l'ID origine dati come visualizzato da /Get-WIMBootEntry.

Esempio:

DISM.exe /Update-WIMBootEntry /Path:C:\ /DataSourceID:0 /ImageFile:R:\Install.wim

/Apply-SiloedPackage

Applica uno o più pacchetti di provisioning silo (SPP) a un'immagine specificata. Questa opzione è disponibile solo dopo l'esecuzione di CopyDandI.cmd da ADK, versione 1607 o successiva ed esecuzione dism.exe /Apply-SiloedPackage dalla cartella di destinazione creata da CopyDandI.cmd.

Nota

/Apply-SiloedPackage può essere eseguito una sola volta in un'immagine di Windows, ma /PackagePath può essere usato più volte nello stesso comando per applicare più SPP. Gli SPP verranno applicati nell'ordine specificato, quindi è necessario specificare una dipendenza prima del provider di servizi di configurazione che dipende da esso.

Per altre informazioni sui pacchetti di provisioning siloed e su come usare CopyDandI.cmd, vedere Pacchetti di provisioning siloed.

Per informazioni su come usare i pacchetti di provisioning siloed, vedere Lab 10: Aggiungere applicazioni desktop e impostazioni con pacchetti di provisioning silo (SPP).

/Apply-SiloedPackage /PackagePath:<package_path> /ImagePath:<applied_image_path>
Parametro Descrizione
/PackagePath Specifica il percorso di un file di pacchetto di provisioning silo.
/Imagepath Specifica il percorso dell'immagine di Windows in cui si applica il SPP.

Esempio:

Dism.exe /apply-SiloedPackage /PackagePath:C:\test\Word.spp /PackagePath:C:\test\spp2.spp /ImagePath:C:\

DISM - Informazioni di riferimento tecnico sulla manutenzione e la gestione delle immagini di distribuzione per Windows

Che cos'è DISM?

Opzioni globali DISM per la sintassi di Command-Line

Distribuire Windows usando Full Flash Update (FFU)

WIM e VHD vs FFU: confronto dei formati di file di immagine