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. |
| /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.sfu, install2.sfu 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. |
| /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. |
| /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. |
| /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.
Somente se aplica a Windows 8.1. Esse recurso não é compatível no Windows 10.
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}
/Boottenta 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 /bootestá 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
/Bootpara 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.
Nota:/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
Opções globais para sintaxe de linha de comando do DISM