Opções da Linha de Comando de Gerenciamento de Imagem do DISM

O Gerenciamento e Manutenção de Imagens de Implantação (DISM.exe) monta um arquivo de imagem do Windows (.wim) ou disco rígido virtual (.vhd ou .vhdx) para manutenção. Também é possível usar o comando de gerenciamento de imagens DISM para listar os números de índice de imagem, para verificar a arquitetura da imagem que você está montando, acrescentar uma imagem, aplicar uma imagem, capturar uma imagem e excluir uma imagem. Depois de atualizar a imagem, você deve desmontá-la e confirmar ou descartar as alterações feitas.

Este tópico discute os comandos DISM relacionados ao gerenciamento de imagens. Para ver outras opções de linha de comando, consulte Opções de Comando de Linha DISM (Gerenciamento e Manutenção de Imagens de Implantação). Para obter mais informações sobre cenários DISM comuns, consulte O que é DISM?.

Além da ferramenta de linha de comando, o DISM está disponível usando Windows PowerShell. Para obter mais informações, consulte Cmdlets DISM (Gerenciamento de Manutenção de Imagens de Implantação) no Windows PowerShell.

Os comandos a seguir podem ser usados para montar, desmontar, capturar, acrescentar e excluir e consultar arquivos .wim, .vhd e .vhdx. Essas opções não diferenciam maiúsculas de minúsculas.

/Append-Image

Adiciona uma imagem a um arquivo .wim. /Append-Image compara novos arquivos com os recursos no arquivo .wim existente especificado pelo argumento /ImageFile e armazena apenas uma única cópia de cada arquivo exclusivo para que seja capturado apenas uma vez. O arquivo .wim pode ter apenas um tipo de compactação atribuído. Portanto, só é possível acrescentar arquivos com o mesmo tipo de compactação.

Essa opção de linha de comando não se aplica a arquivos VHD (disco rígido virtual).

Importante

Verifique se você tem espaço em disco suficiente para a opção /Append-Image ser executada. Se não tiver espaço em disco enquanto a imagem está sendo anexada, o arquivo .wim pode ser corrompido.

Sintaxe:

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]

Parâmetro	Descrição
/WIMBoot	Use /WIMBoot para anexar a imagem com a configuração de inicialização de arquivo de imagem do Windows (WIMBoot). Somente se aplica a imagens do Windows 8.1 que foram capturadas ou exportadas como um arquivo WIMBoot. Esse recurso não é compatível com o Windows 10 e versões posteriores.
/ConfigFile	Especifica o local de um arquivo de configuração que lista as exclusões para os comandos de captura e compactação de imagens. Para obter mais informações, consulte Lista de Configurações do DISM e Arquivos de WimScript.ini.
/Bootable	Marca uma imagem de volume como sendo uma imagem inicializável. Esse argumento está disponível somente para imagens Windows WinPE (Ambiente de Pré-instalação do Windows). Apenas uma imagem de volume pode ser marcada como inicializável em um arquivo .wim.
/CheckIntegrity	Detecta e rastreia a corrupção do arquivo .wim quando usado com operações de captura, desmontagem, exportação e confirmação. /CheckIntegrity interrompe a operação se o DISM detectar que o arquivo .wim está corrompido quando usado em operações de aplicação e montagem.
/Verify	Verifica se há erros e arquivos duplicados.
/NoRpFix	Desabilita a correção da marca de ponto de nova análise. Um ponto de nova análise é um arquivo que contém um link para outro arquivo no sistema. Se /NoRpFix não for especificado, os pontos de nova análise para caminhos fora do valor especificado para /ImageFile não serão capturados.

Exemplo:

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

/Apply-FFU

Para FFU, esse comando aplica um FFU (Utilitário flash completo) ou FFU dividido(SFU) a uma unidade física especificada.

Sintaxe:

/Apply-Ffu /ImageFile:<path_to_image_file> /ApplyDrive:<physical_drive_path> [/SFUFile:<pattern>]

Parâmetro	Descrição
/ImageFile	O caminho e o nome do arquivo de imagem FFU que será aplicado
/ApplyDrive	O caminho para a unidade física que terá imagem
/SFUfile<pattern>	Opcional, para FFUs divididas que são capturadas sem compactação. Use /SFUFile para fazer referência a SFUs (arquivos FFU divididos). Padrão é o padrão de nomenclatura e o local dos arquivos divididos. Use um caractere curinga ao especificar o padrão de nomenclatura. Por exemplo, "E:\image\install*.sfu" será aplicado a todos os arquivos divididos no diretório E:\image chamado install1.sfu, install2.sfu e assim por diante.

Exemplo:

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

/Apply-Image

Para WIM, esse comando aplica um arquivo de imagem do Windows (.wim) ou um arquivo de imagem do Windows dividido (.swm) a uma partição especificada. A partir do Windows 10, versão 1607, o DISM pode aplicar e capturar atributos estendidos (EA).

Para FFU, esse comando aplica uma imagem de atualização flash completa (.ffu) a uma unidade especificada. O comando não oferece suporte à aplicação de uma imagem de um arquivo de disco rígido virtual (.vhdx), embora seja possível usar esse comando para aplicar uma imagem completa a um VHD. O FFU se aplica somente a Windows 10. Embora você possa usar esse comando para aplicar uma FFU, use em seu lugar /apply-ffu.

Essa opção não oferece suporte à aplicação de uma imagem de um VHD (disco rígido virtual), embora você possa usar esse comando para aplicar imagens a um arquivo .vhdx que foi anexado, particionado e formatado.

Argumentos para 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]

Argumentos para FFU

Consulte /apply-ffu.

Parâmetro	Descrição
/CheckIntegrity	Detecta e rastreia a corrupção do arquivo .wim quando usado com operações de captura, desmontagem, exportação e confirmação. /CheckIntegrity interrompe a operação se o DISM detectar que o arquivo .wim está corrompido quando usado em operações de aplicação e montagem.
/Verify	Verifica se há erros e arquivos duplicados.
/NoRpFix	Desabilita a correção da marca de ponto de nova análise. Um ponto de nova análise é um arquivo que contém um link para outro arquivo no sistema. Se /NoRpFix não for especificado, os pontos de nova análise para caminhos fora do valor especificado para /ImageFile não serão capturados.
/SWMFile	Permite que você faça referência a arquivos .wim divididos (SWMs). Padrão é o padrão de nomenclatura e o local dos arquivos divididos. Use um caractere curinga ao especificar o padrão de nomenclatura. Por exemplo, "E:\image\install*.swm" será aplicado a todos os arquivos divididos no diretório E:\image chamado install1.swm, install2.swm e assim por diante.
/ConfirmTrustedFile	Valida a imagem para a Área de Trabalho Confiável. Essa opção só pode ser executada em um computador que executa pelo menos o WinPE 4.0. Ao usar /Apply-Image com a opção /ConfirmTrustedFile no WinPE, sempre especifique a opção /ScratchDir apontada para um local de mídia física. Assim, garante que nomes de arquivo curtos sempre estarão disponíveis. Consulte Opções globais do DISM para sintaxe Linha de Comando para obter mais informações sobre o comportamento padrão da opção /ScratchDir. A partir do Windows 10, versão 1607, é possível usar /EA para aplicar atributos estendidos.
/WIMBoot	Use /WIMBoot para anexar a imagem com a configuração de inicialização de arquivo de imagem do Windows (WIMBoot). Somente se aplica a imagens do Windows 8.1 que foram capturadas ou exportadas como um arquivo WIMBoot. Esse recurso não é compatível com o Windows 10 e versões posteriores.
/Compact	Aplica uma imagem no modo compacto, economizando espaço na unidade. Substitui WIMBoot. Somente para as edições desktop do Windows 10 (Home, Pro, Enterprise e Educação). Nota: se estiver aplicando uma imagem no modo compacto com a opção /ScratchDir, verifique se a pasta ScratchDir não está em uma partição formatada em FAT32. O uso de uma partição FAT32 pode causar reinicializações inesperadas durante o OOBE.
/EA	Novidades no Windows 10, versão 1607. Aplica atributos estendidos.
/ApplyDrive	Especifica a unidade lógica, usando a DeviceID. para obter a ID do dispositivo da linha de comando, digite "wmic diskdrive list brief". Nota: um VHD pode aparecer com o nome "PhysicalDrive" na descrição, por exemplo, .\PhysicalDrive2.
/SFUFile	Use /SFUFile para fazer referência a SFUs (arquivos FFU divididos). Padrão é o padrão de nomenclatura e o local dos arquivos divididos.

Exemplos:

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

Captura as alterações incrementais de arquivo com base no arquivo install.wim específico para um novo arquivo, custom.wim para uma imagem WIMBoot. Não é possível capturar um diretório vazio. Os arquivos capturados são convertidos em arquivos de ponteiro. O custom.wim é colocado na mesma pasta ao lado do install.wim.

Importante

• /Capture-CustomImage captura apenas os arquivos de personalização. Não pode ser usado para capturar arquivos de instalação em um novo WIM.
• Mantenha os arquivos install.wim e custom.wim juntos. Não alterne o arquivo custom.wim ou o arquivo install.wim.
• Somente é possível capturar a imagem personalizada uma vez. Não remova ou recapture um custom.wim depois de capturar as alterações incrementais do arquivo.

Sintaxe:

Dism /Capture-CustomImage /CaptureDir:<source_directory> [/ConfigFile:<configuration_file.ini>] [/CheckIntegrity] [/Verify] [/ConfirmTrustedFile]

Parâmetro	Descrição
/CaptureDir	Especifica o diretório ao qual a imagem foi aplicada e personalizada.
/ConfigFile	Especifica o local de um arquivo de configuração que lista as exclusões para os comandos de captura e compactação de imagens. Para obter mais informações, consulte Lista de Configurações do DISM e Arquivos de WimScript.ini.
/CheckIntegrity	Detecta e rastreia a corrupção do arquivo .wim quando usado com operações de captura, desmontagem, exportação e confirmação. /CheckIntegrity interrompe a operação se o DISM detectar que o arquivo .wim está corrompido quando usado em operações de aplicação e montagem.
/Verify	Verifica se há erros e arquivos duplicados.
[/ConfirmTrustedFile	Valida a imagem da Área de Trabalho Confiável em um Windows 10, Windows 8.1 ou Windows 8. Essa opção só pode ser executada em um computador que executa pelo menos o WinPE 4.0.

Exemplo:

Dism /Capture-CustomImage /CaptureDir:D:\

/Capture-FFU

Captura uma imagem das partições de uma unidade física em um novo arquivo .ffu.

Você pode capturar a imagem como um arquivo de imagem de utilitário flash completo (.ffu) ou um conjunto de arquivos ffu divididos (.sfu);

Sintaxe:

Dism /Capture-Ffu /ImageFile:<path_to_image_file> /CaptureDrive:<physical_drive_path> /Name:<image_name> [/Description:<image_description>] [/PlatformIds:<platform_ids>] [/Compress:{default|none}] 

Parâmetro	Descrição
/CaptureDrive	A unidade física a ser capturada. É possível usar diskpart para obter informações sobre o número da unidade. Usa o formato \\.\PhysicalDriveX, em que X é o número de disco fornecido pelo diskpart.
/PlatformIds	Não é necessário para a captura da área de trabalho. Especifica uma ou mais IDs de plataforma (separadas por ponto e vírgula) a serem adicionadas à imagem. Se não for especificado, a ID da plataforma será '*'.
/Compress	Especifica o tipo de compactação usado ao fazer a captura. Se você estiver dividindo a FFU, especifique none, pois o DISM não oferece suporte à divisão de FFUs compactadas.

Exemplos:

Capturar uma FFU da área de trabalho:

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

Capture uma FFU da área de trabalho que será dividida:

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

/Capture-Image

Captura uma imagem de uma unidade para um novo arquivo .wim. Os diretórios capturados incluem todas as subpastas e dados. Não é possível capturar um diretório vazio. Um diretório deve conter pelo menos um arquivo. O DISM também pode, opcionalmente, aplicar e capturar atributos estendidos (EA).

É possível capturar a imagem como um arquivo de imagem do Windows (.wim) ou um conjunto de arquivos de imagem dividida do Windows (.swm), mas essa opção não oferece suporte à captura de um arquivo de disco rígido virtual (.vhd/.vhdx). Consulte /Capture-FFU se você deseja capturar uma FFU.

Sintaxe:

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]

Parâmetro	Descrição
/ConfigFile	Especifica o local de um arquivo de configuração que lista as exclusões para os comandos de captura e compactação de imagens. Para obter mais informações, consulte Lista de Configurações do DISM e Arquivos de WimScript.ini.
/Compress	Especifica o tipo de compactação usado para a operação de captura inicial. A opção máxima oferece a melhor compactação, mas leva mais tempo para capturar a imagem. A opção rápida oferece compactação de imagem mais rápida, mas os arquivos resultantes ficam maiores do que os compactados com a opção máxima. Esse também é o tipo de compactação padrão usado quando nenhum argumento é especificado. A opção Nenhum não compacta a imagem capturada.
/Bootable	Marca uma imagem de volume como sendo uma imagem inicializável. Esse argumento está disponível apenas para imagens do WinPE. Apenas uma imagem de volume pode ser marcada como inicializável em um arquivo .wim.
/CheckIntegrity	Detecta e rastreia a corrupção do arquivo .wim quando usado com operações de captura, desmontagem, exportação e confirmação. /CheckIntegrity interrompe a operação se o DISM detectar que o arquivo .wim está corrompido quando usado em operações de aplicação e montagem.
/Verify	Verifica se há erros e arquivos duplicados.
/NoRpFix	Desabilita a correção da marca de ponto de nova análise. Um ponto de nova análise é um arquivo que contém um link para outro arquivo no sistema. Se /NoRpFix não for especificado, os pontos de nova análise para caminhos fora do valor especificado para /ImageFile não serão capturados.
/WIMBoot	Use /WIMBoot para anexar a imagem com a configuração de inicialização de arquivo de imagem do Windows (WIMBoot). Somente se aplica a imagens do Windows 8.1 que foram capturadas ou exportadas como um arquivo WIMBoot. Esse recurso não é compatível com o Windows 10 e versões posteriores.
/EA	Captura atributos estendidos. A opção deve ser especificada explicitamente para capturar atributos estendidos. O DISM capturará bits de atributo estendidos se forem definidos nos componentes a serem capturados na imagem WIM. Se os bits não forem definidos, o DISM não os definirá. Somente os componentes da caixa de entrada de pacotes CAB e drivers terão esses bits de atributo estendidos, mas não os componentes do pacote AppX ou os componentes do aplicativo Win32. Atributos estendidos com o prefixo "$Kernel." no nome será ignorado porque somente os atributos estendidos do modo de usuário são capturados. Se usar o DISM no Windows 10, versão 1607 para capturar atributos estendidos e usar uma versão anterior do DISM para aplicar a imagem, a operação terá êxito, mas os atributos estendidos não serão definidos como a imagem aplicada.

Exemplos:

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

Exclui todos os recursos associados a uma imagem montada que foi corrompida. Esse comando não desmontará imagens que já estão montadas, nem excluirá imagens que podem ser recuperadas usando o comando /Remount-Image.

Exemplo:

Dism /Cleanup-Mountpoints

Para saber mais, consulte Reparar uma imagem do Windows

/Commit-Image

Aplica as alterações feitas à imagem montada. A imagem permanece montada até que a opção /Unmount-Image seja usada.

Sintaxe:

Dism /Commit-Image /MountDir:<path_to_mount_directory> [/CheckIntegrity] [/Append]

Parâmetro	Descrição
/CheckIntegrity	Detecta e rastreia a corrupção do arquivo .wim quando usado com operações de captura, desmontagem, exportação e confirmação. /CheckIntegrity interrompe a operação se o DISM detectar que o arquivo .wim está corrompido quando usado em operações de aplicação e montagem.
/Append	Adiciona a imagem modificada ao arquivo .wim existente em vez de substituir a imagem original. Os argumentos /CheckIntegrity e /Append não se aplicam a arquivos VHD (disco rígido virtual).

Exemplo:

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

/Delete-Image

Exclui a imagem de volume especificada de um arquivo .wim que tem várias imagens de volume. Essa opção exclui apenas as entradas de metadados e entradas XML. Não exclui os dados de fluxo e não otimiza o arquivo .wim.

Essa opção de linha de comando não se aplica a arquivos VHD (disco rígido virtual).

Sintaxe:

Dism /Delete-Image /ImageFile:<path_to_image_file> {/Index:<image_index> | /Name:<image_name>} [/CheckIntegrity]

Parâmetro	Descrição
/CheckIntegrity	Detecta e rastreia a corrupção do arquivo .wim quando usado com operações de captura, desmontagem, exportação e confirmação. /CheckIntegrity interrompe a operação se o DISM detectar que o arquivo .wim está corrompido quando usado em operações de aplicação e montagem.

Exemplo:

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

/Export-Image

Exporta uma cópia da imagem especificada para outro arquivo. Os arquivos de origem e destino devem usar o mesmo tipo de compactação. Você também pode otimizar uma imagem exportando para um novo arquivo de imagem. Quando você modifica uma imagem, o DISM armazena arquivos de recursos adicionais que aumentam o tamanho geral da imagem. A exportação da imagem remove arquivos de recurso desnecessários.

Essa opção de linha de comando não se aplica a arquivos VHD (disco rígido virtual).

Sintaxe:

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]

Parâmetro	Descrição
/SWMFile	Permite que você faça referência a arquivos .wim divididos. Padrão é o padrão de nomenclatura e o local dos arquivos divididos. Também é possível especificar caracteres curingas. Por exemplo, "E:\image\install*.swm" exporta os arquivos divididos no diretório E:\image chamado install1.swm, install2.swm e assim por diante.
/Compress	Especifica o tipo de compactação usado para a operação de captura inicial. O parâmetro /Compress não se aplica quando uma imagem é exportada para um arquivo .wim existente. Somente é possível usar este argumento ao exportar uma imagem para um novo arquivo .wim. A opção máxima oferece a melhor compactação, mas leva mais tempo para capturar a imagem. A opção rápida oferece compactação de imagem mais rápida, mas os arquivos resultantes ficam maiores do que os compactados com a opção máxima. Esse também é o tipo de compactação padrão usado quando nenhum argumento é especificado. Use a opção recuperação para exportar imagens de redefinição de botão de ação. Os arquivos resultantes têm um tamanho muito menor, o que, por sua vez, reduz consideravelmente a quantidade de espaço em disco necessária para salvar a imagem de redefinição de botão de ação em uma unidade de recuperação. O arquivo de destino deve ser especificado com uma extensão .esd. A opção Nenhum não compacta a imagem capturada.
/Bootable	Marca uma imagem de volume como sendo uma imagem inicializável. Esse argumento está disponível apenas para imagens do WinPE. Apenas uma imagem de volume pode ser marcada como inicializável em um arquivo .wim.
/WIMBoot	Use /WIMBoot para anexar a imagem com a configuração de inicialização de arquivo de imagem do Windows (WIMBoot). Somente se aplica a imagens do Windows 8.1 que foram capturadas ou exportadas como um arquivo WIMBoot. Esse recurso não é compatível com o Windows 10 e versões posteriores.
/CheckIntegrity	Detecta e rastreia a corrupção do arquivo .wim quando usado com operações de captura, desmontagem, exportação e confirmação. /CheckIntegrity interrompe a operação se o DISM detectar que o arquivo .wim está corrompido quando usado em operações de aplicação e montagem.

Exemplo:

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

/Get-ImageInfo

Exibe informações sobre as imagens contidas em um arquivo .wim, .ffu, .vhd ou .vhdx. Quando usadas com o argumento /Index ou /Name, as informações sobre a imagem especificada são exibidas, o que inclui se uma imagem é uma imagem WIMBoot, se a imagem for Windows 8.1, consulte Fazer inventário de uma imagem ou componente usando DISM. O argumento /Name não se aplica a arquivos VHD. Especifique /Index:1 para arquivos FFU e VHDX.

Sintaxe:

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

Exemplos:

Dism /Get-ImageInfo /ImageFile:C:\test\offline\install.wim

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

/Get-MountedImageInfo

Retorna uma lista de imagens .ffu, .vhd, .vhdx e .wim que estão montadas no momento, bem como informações sobre a imagem montada, como se a imagem é válida, permissões de leitura/gravação, local de montagem, caminho de arquivo montado e índice de imagem montado.

Exemplo:

Dism /Get-MountedImageInfo

/Get-WIMBootEntry

Use /Get-WIMBootEntry para exibir entradas de configuração WIMBoot para o volume de disco especificado.

Para obter mais informações sobre como exibir entradas de configuração wimboot, consulte Fazer inventário de uma imagem ou componente usando DISM.

Esse recurso se aplica apenas ao Windows 8.1; ele não é compatível com o Windows 10 e versões posteriores.

Sintaxe:

Dism /Get-WIMBootEntry /Path:<volume_path>

Exemplo:

Dism /Get-WIMBootEntry /Path:C:\

/List-Image

Exibe uma lista dos arquivos e pastas em uma imagem especificada.

Essa opção de linha de comando não se aplica a arquivos VHD (disco rígido virtual).

Sintaxe:

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

Exemplo:

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

/Mount-Image

Monta uma imagem de um arquivo .ffu, .wim, .vhd ou .vhdx no diretório especificado para que ela esteja disponível para manutenção.

Ao montar uma imagem, observe:

• O diretório de montagem deve ser criado, mas vazio.
• Um valor de índice ou nome é necessário para todos os tipos de imagem. Os WIMs podem conter mais do que a imagem. Para FFU e VHD, use index:1.

Sintaxe:

Dism /Mount-Image /ImageFile:<path_to_image_file> {/Index:<image_index> | /Name:<image_name>} /MountDir:<path_to_mount_directory> [/ReadOnly] [/Optimize] [/CheckIntegrity]

Parâmetro	Descrição
/ReadOnly	Define a imagem montada com permissões somente leitura. Opcional.
/Optimize	Reduz o tempo de montagem inicial.
/CheckIntegrity	Detecta e rastreia a corrupção do arquivo .wim quando usado com operações de captura, desmontagem, exportação e confirmação. /CheckIntegrity interrompe a operação se o DISM detectar que o arquivo .wim está corrompido quando usado em operações de aplicação e montagem.

Exemplos:

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

Otimiza uma imagem FFU para que seja mais rápida de implantar e também pode ser implantada com mais facilidade em discos de tamanho diferente. Consulte Capturar e aplicar imagens do Windows Full Flash Update para obter mais informações.

Sintaxe:

Dism /Optimize-FFU /ImageFile:<path-to-ffu-file> [/PartitionNumber:<PartitionNumber>]

Parâmetro	Descrição
/ImageFile	Caminho para a FFU que você deseja otimizar.
/PartitionNumber	Opcional. Por padrão, /Optimize-FFU otimiza a partição do sistema operacional. /PartitionNumber permite que você especifique a partição que deseja otimizar.

Exemplos:

Dism /Optimize-FFU /ImageFile:flash.ffu

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

/Optimize-Image

Esse comando deve ser o último comando executado em uma imagem antes de ser aplicada a um dispositivo e pode reduzir o tempo no chão de fábrica ao criar dispositivos para cenários build to stock.

Sintaxe:

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

• /Boot tenta reduzir o tempo de configuração online que o sistema operacional gasta durante a inicialização. Essa otimização pode ser inválida se qualquer operação de manutenção for executada na imagem após a otimização.

  DISM /Optimize-Image /boot está disponível nos seguintes sistemas operacionais:

  • Windows 11

  • Windows 10, versão 1607

  • Windows 10 versão 1809 e posterior

  • Windows Server 2012 R2 ou versões posteriores

    Use /Boot para tentar reduzir o tempo de configuração online que o sistema operacional gasta durante a inicialização. Observe que essa otimização pode se tornar inválida se qualquer operação de manutenção for executada na imagem após a otimização.

• /WimBoot é para configurar uma imagem offline para instalação em um sistema WIMBoot.

Exemplos:

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

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

/Remount-Image

Monta novamente uma imagem que se tornou inacessível e a disponibiliza para manutenção.

Sintaxe:

Dism /Remount-Image /MountDir:<path_to_mount_directory>

Exemplo:

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

/Split-FFU

Para FFU, esse comando divide um arquivo .ffu (atualização flash completa) existente em vários arquivos .sfu divididos somente leitura. O DISM não oferece suporte à divisão de FFUs compactadas. Se você estiver dividindo FFUs, verifique se a FFU foi capturada com a opção /compress:none específica.

Essa opção cria os arquivos .sfu no diretório especificado, nomeando cada arquivo como o /SFUFile especificado, mas com um número anexado. Por exemplo, se você usar c:\flash.sfu, terá um arquivo flash.sfu, um arquivo flash2.ffu, um arquivo flash3.sfu e assim por diante, definindo cada parte do arquivo .sfu dividido e salvando-o no diretório C:\.

Sintaxe para FFU:

Dism /Split-Ffu /ImageFile:<path_to_image_file> /SFUFile:<pattern> /FileSize:<MB-Size> [/CheckIntegrity]

Parâmetro	Descrição
/FileSize	Especifica o tamanho máximo, em megabytes (MB) para cada arquivo criado. Se um único arquivo for maior que o valor especificado na opção /FileSize, um dos arquivos .swm divididos será maior do que o valor especificado na opção /FileSize, a fim de acomodar o arquivo grande.
/CheckIntegrity	Detecta e rastreia a corrupção do arquivo .wim quando usado com operações de captura, desmontagem, exportação e confirmação. /CheckIntegrity interrompe a operação se o DISM detectar que o arquivo .wim está corrompido quando usado em operações de aplicação e montagem.
/ImageFile	Especifica o caminho de um arquivo .FFU, exemplo: flash.ffu.
/SFUFile	Referências dividem arquivos FFU (SFUs). Padrão é o padrão de nomenclatura e o local dos arquivos divididos.

Exemplo:

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

/Split-Image

Para WIM, esse comando divide um arquivo .wim existente em vários arquivos .swm divididos somente leitura.

Essa opção cria os arquivos .swm no diretório especificado, nomeando cada arquivo como o path_to_swm especificado, mas com um número anexado. Por exemplo, se você definir path_to_swm como c:\Data.swm, essa opção criará um arquivo Data.swm, um arquivo Data2.swm, um arquivo Data3.swm e assim por diante, definindo cada parte do arquivo .wim dividido e salvando-o no diretório C:\.

Essa opção de linha de comando não se aplica a arquivos VHD (disco rígido virtual).

Sintaxe para WIM:

Dism /Split-Image /ImageFile:<path_to_image_file> /SWMFile:<path_to_swm> /FileSize:<MB-Size> [/CheckIntegrity]

Parâmetro	Descrição
/FileSize	Especifica o tamanho máximo, em megabytes (MB) para cada arquivo criado. Se um único arquivo for maior que o valor especificado na opção /FileSize, um dos arquivos .swm divididos será maior do que o valor especificado na opção /FileSize, a fim de acomodar o arquivo grande.
/CheckIntegrity	Detecta e rastreia a corrupção do arquivo .wim quando usado com operações de captura, desmontagem, exportação e confirmação. /CheckIntegrity interrompe a operação se o DISM detectar que o arquivo .wim está corrompido quando usado em operações de aplicação e montagem.
/ImageFile	Especifica o caminho de um arquivo de imagem, por exemplo: install.wim.

Exemplo:

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

/Unmount-Image

Desmonta o arquivo .ffu, .wim, .vhd ou .vhdx e confirma ou descarta as alterações feitas quando a imagem foi montada.

Use o argumento /commit ou /discard ao usar a opção /Unmount-Image.

Sintaxe:

Dism /Unmount-Image /MountDir:<path_to_mount_directory> {/Commit | /Discard} [/CheckIntegrity] [/Append]

Parâmetro	Descrição
/CheckIntegrity	Detecta e rastreia a corrupção do arquivo .wim quando usado com operações de captura, desmontagem, exportação e confirmação. /CheckIntegrity interrompe a operação se o DISM detectar que o arquivo .wim está corrompido quando usado em operações de aplicação e montagem.
/Append	Adiciona a imagem modificada ao arquivo .wim existente em vez de substituir a imagem original. Os argumentos /CheckIntegrity e /Append não se aplicam a arquivos de disco rígido virtual (VHD, VHDX) ou FFU.

Exemplos:

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

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

/Update-WIMBootEntry

Atualiza a entrada de configuração WIMBoot, associada à ID da fonte de dados especificada, com o arquivo de imagem renomeado ou o caminho do arquivo de imagem movido.

Observação: /Update-WIMBootEntry requer uma reinicialização para que todas as atualizações entrem em vigor.

Sintaxe:

Dism /Update-WIMBootEntry /Path:<Volume_path> /DataSourceID:<Data_source_id> /ImageFile:<Renamed_image_path>

Parâmetro	Descrição
/Path	Especifica o volume de disco da configuração WIMBoot.
/DataSourceID	Especifica a ID da fonte de dados conforme exibido por /Get-WIMBootEntry.

Exemplo:

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

/Apply-SiloedPackage

Aplica um ou mais SPPs (pacotes de provisionamento em silo) a uma imagem especificada. Essa opção somente está disponível depois de executar CopyDandI.cmd no ADK, versão 1607 ou versão posterior e em execução dism.exe /Apply-SiloedPackage na pasta de destino criada por CopyDandI.cmd.

Observação

/Apply-SiloedPackage somente pode ser executado uma vez em uma imagem do Windows, mas /PackagePath pode ser usado mais de uma vez no mesmo comando para aplicar vários SPPs. Os SPPs serão aplicados na ordem especificada, portanto, uma dependência deve ser especificada antes do SPP que depende dela.

Para obter mais informações sobre pacotes de provisionamento em silos e como usar CopyDandI.cmd, consulte Pacotes de provisionamento em silos.

Para descobrir como trabalhar com pacotes de provisionamento em silos, consulte Laboratório 10: adicionar aplicativos e configurações da área de trabalho com SPPs (pacotes de provisionamento em silos).

/Apply-SiloedPackage /PackagePath:<package_path> /ImagePath:<applied_image_path>

Parâmetro	Descrição
/PackagePath	Especifica o caminho de um arquivo de pacote de provisionamento em silos.
/ImagePath	Especifica o caminho da imagem do Windows em que você está aplicando o SPP.

Exemplo:

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

Tópicos relacionados

DISM – Referência técnica de gerenciamento e manutenção de imagens de implantação para Windows

O que é DISM?

Opções globais para sintaxe de linha de comando do DISM

Implantar o Windows usando o FFU (Full Flash Update)

WIM x VHD x FFU: comparar formatos de arquivo de imagem