Condividi tramite


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

La manutenzione e la gestione delle immagini di distribuzione (DISM.exe) monta un file immagine Windows (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 dell'immagine, per verificare l'architettura dell'immagine che si sta montando, aggiungere un'immagine, applicare un'immagine, acquisire un'immagine ed eliminare un'immagine. Dopo aver aggiornato l'immagine, è necessario smontarla ed eseguirne il commit o annullare le modifiche apportate.

In questo argomento vengono illustrati i comandi DISM correlati alla gestione delle immagini. Per visualizzare altre opzioni della riga di comando, vedere Deployment Image Servicing and Management (DISM) Command-Line Options( Opzioni della riga di comando). Per altre informazioni sugli scenari comuni di gestione delle dipendenze, vedere Che cos'è gestione e manutenzione e manutenzione distribuzione.

Oltre allo strumento da riga di comando, gestione e manutenzione distribuzione è disponibile tramite Windows PowerShell. Per altre informazioni, vedere Deployment Imaging Servicing Management (DISM) Cmdlets in Windows PowerShell.For more information, see Deployment Imaging Servicing Management (DISM) Cmdlets in Windows PowerShell.

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

/Append-Image

Aggiunge un'immagine aggiuntiva a un file wim. /Append-Image confronta i nuovi file con le risorse nel file wim esistente specificato dall'argomento /ImageFile e archivia una sola 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 del disco rigido virtuale .This command-line option does not apply to virtual hard disk (VHD).

Importante

Assicurarsi di disporre di spazio su disco sufficiente per l'esecuzione dell'opzione /Append-Image . Se si esaurisce lo spazio su disco durante l'aggiunta dell'immagine, è possibile danneggiare il file wim.

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 di Windows 8.1 acquisite o esportate come file WIMBoot. Questa funzionalità non è supportata in Windows 10 e versioni successive.
/ConfigFile specifica il percorso di un file di configurazione che elenca le esclusioni per l'acquisizione di immagini e comprime i comandi. Per altre informazioni, vedere Elenco di configurazione gestione e WimScript.ini file.
/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 dei file wim quando vengono usati con le operazioni di acquisizione, smontaggio, esportazione e commit. /CheckIntegrity arresta l'operazione se Gestione e manutenzione immagine distribuzione rileva che il file wim è 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, i punti reparse che si risolvono in percorsi esterni al valore specificato da /ImageFile non verranno acquisiti.

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 una divisione FFU (SFU) 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à immagineta
Modello /SFUfile<> Facoltativo, per le FFU suddivise acquisite senza compressione. Usare /SFUFile per fare riferimento a file FFU divisi (SFU). Il modello è il modello di denominazione e il percorso dei file divisi. Usare un carattere jolly quando si specifica il modello di denominazione. Ad esempio, "E:\image\install*.sfu" applicherà tutti i file divisi 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 windows (wim) o uno split Windows image (swm) a una partizione specificata. A partire da Windows 10, versione 1607, Gestione e manutenzione immagini distribuzione può applicare e acquisire attributi estesi (EA).

Per FFU, questo comando applica un'immagine di aggiornamento flash completo (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 dei file wim quando vengono usati con le operazioni di acquisizione, smontaggio, esportazione e commit. /CheckIntegrity arresta l'operazione se Gestione e manutenzione immagine distribuzione rileva che il file wim è 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, i punti di reparse che si risolvono in percorsi esterni al valore specificato da /ImageFile non verranno acquisiti.
/SWMFile Consente di fare riferimento a file con estensione wim divisi (SWM). Il modello è il modello di denominazione e il percorso dei file divisi. Usare un carattere jolly quando si specifica il modello di denominazione. Ad esempio, "E:\image\install*.swm" applicherà tutti i file divisi 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. In questo modo si garantisce che i nomi di file brevi saranno sempre disponibili. Per altre informazioni sul comportamento predefinito dell'opzione /ScratchDir, vedere Opzioni globali DISM per la sintassi della riga di comando. A partire da Windows 10, versione 1607, puoi 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 di Windows 8.1 acquisite o esportate come file WIMBoot. Questa funzionalità non è supportata in Windows 10 e versioni successive.
/Compatto Applica un'immagine in modalità compatta, risparmiando spazio su unità. Sostituisce WIMBoot. Solo per Windows 10 per le edizioni desktop (Home, Pro, Enterprise ed Education).

Nota: se si applica un'immagine in modalità compatta con l'opzione /ScratchDir, assicurarsi che la cartella ScratchDir non si trovi in una partizione in formato FAT32. L'uso di una partizione FAT32 potrebbe comportare riavvii imprevisti durante la configurazione guidata.
/EA Novità di Windows 10 versione 1607. Applica gli attributi estesi.
/ApplyDrive Specifica l'unità logica utilizzando 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 a file FFU divisi (SFU). Il modello è il modello di denominazione e il percorso dei file divisi.

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 dei 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. Custom.wim viene inserito nella stessa cartella accanto a 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 ricapitolare 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 gestione e WimScript.ini file.
/CheckIntegrity Rileva e tiene traccia del danneggiamento dei file wim quando vengono usati con le operazioni di acquisizione, smontaggio, esportazione e commit. /CheckIntegrity arresta l'operazione se Gestione e manutenzione immagine distribuzione rileva che il file wim è 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 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 con estensione ffu.

È possibile acquisire l'immagine come file di immagine dell'utilità flash completa (con estensione ffu) o un set di file ffu divisi (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 piattaforma sarà '*'.
/Comprimere Specifica il tipo di compressione utilizzato per durante l'acquisizione. Se si dividerà il FFU, specificare none, perché gestione e manutenzione immagini distribuzione non supporta la suddivisione delle FFU compresse.

Esempi:

Acquisire un FFU desktop:

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

Acquisire un FFU desktop che verrà diviso:

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. Gestione e manutenzione immagini distribuzione può anche applicare e acquisire attributi estesi (EA).

È possibile acquisire l'immagine come file di immagine windows (wim) o un set di file di immagine Windows (con estensione swm), ma questa opzione non supporta l'acquisizione di un file di disco rigido virtuale (.vhd/.vhdx). Verifica /Capture-FFU se stai 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 gestione e WimScript.ini file.
/Comprimere Specifica il tipo di compressione utilizzata per l'operazione di acquisizione iniziale. L'opzione massima offre la compressione migliore, ma richiede più tempo per acquisire l'immagine. L'opzione rapida offre una compressione delle immagini più rapida , 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 none non comprime affatto 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 dei file wim quando vengono usati con le operazioni di acquisizione, smontaggio, esportazione e commit. /CheckIntegrity arresta l'operazione se Gestione e manutenzione immagine distribuzione rileva che il file wim è 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, i punti reparse che si risolvono in percorsi esterni al valore specificato da /ImageFile non verranno acquisiti.
/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 di Windows 8.1 acquisite o esportate come file WIMBoot. Questa funzionalità non è supportata in Windows 10 e versioni successive.
/EA Acquisisce gli attributi estesi. L'opzione deve essere specificata in modo esplicito per acquisire gli attributi estesi. Gestione e manutenzione immagini distribuzione acquisisce i bit degli attributi estesi se sono impostati nei componenti da acquisire nell'immagine WIM. Se i bit non sono impostati, gestione e manutenzione e manutenzione distribuzione non li imposta. 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 Gestione e manutenzione immagini distribuzione in Windows 10 versione 1607 per acquisire gli attributi estesi e usare una versione precedente di Gestione e manutenzione immagini distribuzione 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 recuperate 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 fino a quando 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 dei file wim quando vengono usati con le operazioni di acquisizione, smontaggio, esportazione e commit. /CheckIntegrity arresta l'operazione se Gestione e manutenzione immagine distribuzione rileva che il file wim è danneggiato quando viene usato con le operazioni di applicazione e montaggio.
/Aggiungere Aggiunge l'immagine modificata al file 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 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 del disco rigido virtuale .This command-line option does not apply to virtual hard disk (VHD).

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 dei file wim quando vengono usati con le operazioni di acquisizione, smontaggio, esportazione e commit. /CheckIntegrity arresta l'operazione se Gestione e manutenzione immagine distribuzione rileva che il file wim è 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, gestione e manutenzione immagini 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 del disco rigido virtuale .This command-line option does not apply to virtual hard disk (VHD).

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 divisi. pattern è il modello di denominazione e il percorso dei file divisi. È anche possibile specificare caratteri jolly. Ad esempio, "E:\image\install*.swm" esportare i file divisi nella directory E:\image denominata install1.swm, install2.swm e così via.
/Comprimere Specifica il tipo di compressione utilizzata per l'operazione di acquisizione iniziale. L'argomento /Compress non si applica quando si esporta un'immagine in un file 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 rapida offre una compressione delle immagini più rapida , 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 le immagini di reimpostazione rapida del pulsante. I file risultanti sono molto più piccoli di dimensioni, che a loro volta riducono notevolmente la quantità di spazio su disco necessaria per salvare l'immagine di reimpostazione rapida su un'unità di ripristino. Il file di destinazione deve essere specificato con estensione esd. L'opzione none non comprime affatto 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 di Windows 8.1 acquisite o esportate come file WIMBoot. Questa funzionalità non è supportata in Windows 10 e versioni successive.
/CheckIntegrity Rileva e tiene traccia del danneggiamento dei file wim quando vengono usati con le operazioni di acquisizione, smontaggio, esportazione e commit. /CheckIntegrity arresta l'operazione se Gestione e manutenzione immagine distribuzione rileva che il file wim è 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 Take Inventory of an Image or Component Using DISM .When used with the /Index or /Name argument, information about the specified image or component is a WIMBoot image, if the image is Windows 8.1, see Take Inventory of an Image or Component Using 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, posizione di montaggio, percorso di file montato e indice di 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 tramite gestione e manutenzione immagini distribuzione.

Questo vale solo per Windows 8.1; questa funzionalità non è supportata in Windows 10 e versioni successive.

Sintassi:

Dism /Get-WIMBootEntry /Path:<volume_path>

Esempio:

Dism /Get-WIMBootEntry /Path:C:\

/List-Image

Visualizza un elenco di file e cartelle in un'immagine specificata.

Questa opzione della riga di comando non si applica ai file del disco rigido virtuale .This command-line option does not apply to virtual hard disk (VHD).

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 di windows 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. Facoltativo.
/Ottimizzare Riduce il tempo di montaggio iniziale.
/CheckIntegrity Rileva e tiene traccia del danneggiamento dei file wim quando vengono usati con le operazioni di acquisizione, smontaggio, esportazione e commit. /CheckIntegrity arresta l'operazione se Gestione e manutenzione immagine distribuzione rileva che il file wim è 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 da distribuire e possa anche essere distribuita più facilmente in dischi di dimensioni diverse. Per altre informazioni, vedi 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 Facoltativo. Per impostazione predefinita /Optimize-FFU , ottimizza la partizione del sistema operativo. /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 dell'applicazione dell'immagine a un dispositivo e può ridurre il tempo nel piano di fabbrica durante la creazione di dispositivi per scenari da 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. Il rendering di questa ottimizzazione potrebbe non essere valido se vengono eseguite operazioni di manutenzione 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 versioni successive

      Usare /Boot per provare e ridurre il tempo di configurazione online trascorso dal sistema operativo durante l'avvio. Si noti che il rendering di questa ottimizzazione potrebbe non essere valido se vengono eseguite operazioni di manutenzione sull'immagine dopo l'ottimizzazione.

  • /WimBoot è per la configurazione di 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 suddivide un file di aggiornamento full-flash esistente (con estensione ffu) in più file sfu di sola lettura. Gestione e manutenzione immagini distribuzione non supporta la suddivisione delle FFU compresse. Se si suddivideno le FFU, assicurarsi che il FFU sia stato acquisito con l'opzione /compress:none specificata.

Questa opzione crea i file con estensione sfu nella directory specificata, assegnando a ogni file lo stesso valore di /SFUFile specificato, ma con un numero accodato. 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 sfu di divisione e salvandolo nella directory C:\.

Sintassi per FFU:

Dism /Split-Ffu /ImageFile:<path_to_image_file> /SFUFile:<pattern> /FileSize:<MB-Size> [/CheckIntegrity]
Parametro Descrizione
/FileSize 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 split sarà maggiore del valore specificato nell'opzione /FileSize, in modo da contenere il file di grandi dimensioni.
/CheckIntegrity Rileva e tiene traccia del danneggiamento dei file wim quando vengono usati con le operazioni di acquisizione, smontaggio, esportazione e commit. /CheckIntegrity arresta l'operazione se Gestione e manutenzione immagine distribuzione rileva che il file wim è danneggiato quando viene usato con le operazioni di applicazione e montaggio.
/ImageFile Specifica il percorso di un oggetto . File FFU, esempio: flash.ffu.
/SFUFile I riferimenti suddividono i file FFU (SFU). Il modello è il modello di denominazione e il percorso dei file divisi.

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 a ogni file lo stesso valore del 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 nella directory C:\.

Questa opzione della riga di comando non si applica ai file del disco rigido virtuale .This command-line option does not apply to virtual hard disk (VHD).

Sintassi per WIM:

Dism /Split-Image /ImageFile:<path_to_image_file> /SWMFile:<path_to_swm> /FileSize:<MB-Size> [/CheckIntegrity]
Parametro Descrizione
/FileSize 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 split sarà maggiore del valore specificato nell'opzione /FileSize, in modo da contenere il file di grandi dimensioni.
/CheckIntegrity Rileva e tiene traccia del danneggiamento dei file wim quando vengono usati con le operazioni di acquisizione, smontaggio, esportazione e commit. /CheckIntegrity arresta l'operazione se Gestione e manutenzione immagine distribuzione rileva che il file wim è 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 rimuove le modifiche apportate al momento del montaggio dell'immagine.

È 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 dei file wim quando vengono usati con le operazioni di acquisizione, smontaggio, esportazione e commit. /CheckIntegrity arresta l'operazione se Gestione e manutenzione immagine distribuzione rileva che il file wim è danneggiato quando viene usato con le operazioni di applicazione e montaggio.
/Aggiungere Aggiunge l'immagine modificata al file wim esistente anziché sovrascrivere l'immagine originale. Gli argomenti /CheckIntegrity e /Append non si applicano ai file VHD, VHDX o FFU.

Esempi:

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

/Update-WIMBootEntry

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

Nota: /Update-WIMBootEntry richiede un riavvio per rendere effettivo qualsiasi aggiornamento.

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 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 aver eseguito CopyDandI.cmd da ADK, versione 1607 o successiva ed eseguire dism.exe /Apply-SiloedPackage dalla cartella di destinazione creata da CopyDandI.cmd.

Nota

/Apply-SiloedPackage può essere eseguito una sola volta su 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 silo, vedere Lab 10: Aggiungere applicazioni desktop e impostazioni con pacchetti di provisioning silo (SPP) silo.

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

Esempio:

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

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

Che cos'è gestione e manutenzione e manutenzione distribuzione?

Opzioni globali DISM per la sintassi della riga di comando

Distribuire Windows con Full Flash Update (FFU)

WIM e VHD e FFU: confronto tra formati di file di immagine