Compartilhar via

Opções de linha de comando de manutenção do pacote do sistema operacional DISM (.cab ou .msu)

  • Artigo

Use o DISM com arquivos de gabinete do Windows (.cab) ou do instalador autônomo do Windows Update (.msu) para instalar ou remover atualizações, pacotes de idiomas e para habilitar ou desabilitar recursos do Windows. Os recursos são componentes opcionais para o sistema operacional principal.

Sintaxe

DISM.exe {/Image:<path_to_image_directory> | /Online} [dism_global_options] {servicing_option} [<servicing_argument>]

As seguintes opções de manutenção de pacotes do sistema operacional estão disponíveis para uma imagem offline:

DISM.exe /Image:<path_to_image_directory> [/Get-Packages | /Get-PackageInfo | /Add-Package | /Remove-Package ] [/Get-Features | /Get-FeatureInfo | /Enable-Feature | /Disable-Feature ] [/Cleanup-Image]

As seguintes opções de manutenção de pacotes do sistema operacional estão disponíveis para um sistema operacional em execução:

DISM.exe /Online [/Get-Packages | /Get-PackageInfo | /Add-Package | /Remove-Package ] [/Get-Features | /Get-FeatureInfo | /Enable-Feature | /Disable-Feature ] [/Cleanup-Image]

/Get-Help /?

Quando usado imediatamente após uma opção de linha de comando de manutenção de pacote, as informações sobre a opção e os argumentos são exibidas.

Tópicos adicionais podem ficar disponíveis quando uma imagem é especificada.

Sintaxe:

Dism /Get-Help

Exemplos:

Dism /Image:C:\test\offline /Add-Package /?

Dism /Online /Get-Packages /?

/Get-Packages

Exibe informações básicas sobre todos os pacotes na imagem. Use o argumento /Format:Table ou /Format:List para exibir a saída como uma tabela ou uma lista.

Sintaxe:

Dism /Get-Packages [/Format:{Table | List}]

Exemplos:

Dism /Image:C:\test\offline /Get-Packages

Dism /Image:C:\test\offline /Get-Packages /Format:Table

Dism /Online /Get-Packages

/Get-PackageInfo

Exibe informações detalhadas sobre um pacote fornecido como um arquivo .cab. Somente arquivos .cab podem ser especificados. Você não pode usar esse comando para obter informações de pacote para arquivos .msu. /PackagePath:<path_to_package> pode apontar para um arquivo .cab ou para uma pasta.

Você pode usar a opção /Get-Packages para localizar o nome do pacote na imagem ou especificar o caminho para o arquivo .cab. O caminho para o arquivo .cab deve apontar para a origem do pacote, não para onde o arquivo está instalado na imagem offline.

Sintaxe:

Dism /Get-PackageInfo {/PackageName:<name_in_image> | /PackagePath:<path_to_cabfile>}

Exemplos:

Dism /Image:C:\test\offline /Get-PackageInfo /PackagePath:C:\packages\package.cab

Dism /Image:C:\test\offline /Get-PackageInfo /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0

/Add-Package

Instala um pacote .cab ou .msu especificado na imagem.

Observação

Você pode usar /Add-Package para adicionar um pacote .msu a uma imagem online ou offline do Windows 11, versão 21H2 ou posterior. Se estiver trabalhando com uma imagem do Windows anterior ao Windows 11, versão 21H2, você só poderá adicionar pacotes .msu em imagens de destino offline.

Vários pacotes podem ser adicionados em uma linha de comando. A aplicabilidade de cada pacote será verificada. Se o pacote não puder ser aplicado à imagem especificada, você receberá uma mensagem de erro. Use o argumento /IgnoreCheck se quiser que o comando seja processado sem verificar a aplicabilidade de cada pacote.

Sintaxe:

Dism /Add-Package /PackagePath:<path_to_cabfile> [/IgnoreCheck] [/PreventPending]

  • /PackagePath pode apontar para:

    • Um único arquivo .cab ou .msu.
    • Uma pasta que contém um único arquivo .cab expandido.
    • Uma pasta que contém um único arquivo .msu.
    • Uma pasta que contém vários arquivos .cab ou .msu.

  • Se /PackagePath apontar para uma pasta que contenha um .cab ou arquivos .msu em sua raiz, todas as subpastas também serão verificadas recursivamente em busca de arquivos .cab e .msu.

  • Use a opção /PreventPending para ignorar a instalação do pacote se o pacote ou a imagem do Windows tiver ações online pendentes.

Observação

/Add-Package não executa uma verificação completa da aplicabilidade e das dependências de um pacote:

  • Se você estiver adicionando um pacote com dependências, verifique se todas as dependências estão instaladas ao adicionar o pacote.
  • Se você estiver adicionando um .msu, verifique o KB associado para obter instruções de instalação específicas do pacote.

Exemplos:

Dism /Image:C:\test\offline /LogPath:AddPackage.log /Add-Package /PackagePath:C:\packages\package.msu

Dism /Image:C:\test\offline /Add-Package /PackagePath:C:\packages\package1.cab /PackagePath:C:\packages\package2.cab /IgnoreCheck

Dism /Image:C:\test\offline /Add-Package /PackagePath:C:\test\packages\package.cab /PreventPending

Atualizações cumulativas do ponto de verificação

A partir do Windows 11, versão 24H2, a atualização cumulativa mais recente pode ter uma atualização cumulativa de pré-requisito que deve ser instalada primeiro. Para instalar essas atualizações cumulativas de ponto de verificação, chame /Add-Package com a atualização cumulativa de destino. A pasta de -PackagePath será usada para descobrir e instalar um ou mais pontos de verificação, conforme necessário. Somente a atualização cumulativa de destino e todas as atualizações cumulativas de ponto de verificação de pré-requisito devem estar na pasta -PackagePath. Os pacotes de atualização cumulativa com uma revisão menor ou igual à atualização cumulativa de destino serão processados.

/Remove-Package

Remove um pacote de arquivos .cab especificado da imagem. Somente arquivos .cab podem ser especificados. Você não pode usar este comando para remover arquivos .msu.

Observação

Usar esse comando para remover um pacote de uma imagem offline não reduzirá o tamanho da imagem.

Sintaxe:

/Remove-Package {/PackageName:<name_in_image> | /PackagePath:<path_to_cabfile>}
  • Use /PackagePath para apontar para a origem do pacote, especificar o caminho para o arquivo CAB ou especificar o pacote pelo nome, conforme listado na imagem. Use a opção /Get-Packages para localizar o nome do pacote na imagem.

Exemplos:

Dism /Image:C:\test\offline /LogPath:C:\test\RemovePackage.log /Remove-Package /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0

Dism /Image:C:\test\offline /LogPath:C:\test\RemovePackage.log /Remove-Package /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0 /PackageName:Microsoft-Windows-MediaPlayer-Package~31bf3856ad364e35~x86~~6.1.6801.0

Dism /Image:C:\test\offline /LogPath:C:\test\RemovePackage.log /Remove-Package /PackagePath:C:\packages\package1.cab /PackagePath:C:\packages\package2.cab

/Get-Features

Exibe informações básicas sobre todos os recursos (componentes do sistema operacional que incluem recursos opcionais do Windows Foundation) em um pacote.

Sintaxe:

/Get-Features {/PackageName:<name_in_image> | /PackagePath:<path_to_cabfile>} [/Format:{Table | List}]
  • /Get-Features localiza o nome dos pacotes na imagem ou na fonte original do pacote. Se você não especificar um nome ou caminho de pacote, todos os recursos na imagem serão listados.
  • /PackageName é um pacote em uma imagem. Você pode usar /DISM Get-Packages para ver os nomes dos pacotes em uma imagem.
  • /PackagePath pode apontar para um arquivo .cab ou para uma pasta.

Use o argumento /Format:Table ou /Format:List para exibir a saída como uma tabela ou uma lista.

Exemplos:

Dism /Image:C:\test\offline /Get-Features

Dism /Image:C:\test\offline /Get-Features /Format:List

Dism /Image:C:\test\offline /Get-Features /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0

Dism /Image:C:\test\offline /Get-Features /PackagePath:C:\packages\package1.cab

/Get-FeatureInfo

Exibe informações detalhadas sobre um recurso. Você deve usar /FeatureName. Você pode usar a opção /Get-Features para encontrar o nome do recurso na imagem.

Sintaxe:

/Get-FeatureInfo /FeatureName:<name_in_image> [{/PackageName:<name_in_image> | /PackagePath:<path_to_cabfile>}]

/PackageName e /PackagePath são opcionais e podem ser usados para encontrar um recurso específico em um pacote.

Exemplos:

Dism /Image:C:\test\offline /Get-FeatureInfo /FeatureName:Hearts

Dism /Image:C:\test\offline /Get-FeatureInfo /FeatureName:Hearts /PackagePath:C:\packages\package.cab

/Enable-Feature

Habilita ou atualiza o recurso especificado na imagem. Você deve usar a opção /FeatureName. Use a opção /Get-Features para localizar o nome do recurso na imagem.

Sintaxe:

/Enable-Feature /FeatureName:<name_in_image> [/PackageName:<name_in_image>] [/Source: <source>] [/LimitAccess] [/All]

Você pode especificar a opção /FeatureName várias vezes em uma linha de comando para recursos que compartilham o mesmo pacote pai.

Você não precisa especificar o nome do pacote usando a opção /PackageName se o pacote for um Pacote do Windows Foundation. Caso contrário, use /PackageName para especificar o pacote pai do recurso.

Você pode restaurar e habilitar um recurso que foi removido anteriormente da imagem. Use o argumento /Source para especificar o local dos arquivos necessários para restaurar o recurso. A origem dos arquivos pode ser usada pela pasta do Windows em uma imagem montada, por exemplo, c:\test\mount\Windows. Você também pode usar uma pasta lado a lado do Windows como a origem dos arquivos, por exemplo, z:\sources\SxS.

Se forem especificados múltiplos argumentos /Source, os arquivos serão coletados do primeiro local encontrado e os outros locais serão ignorados. Se você não especificar um /Source para um recurso que foi removido, o local padrão no registro será usado ou, para imagens online, Windows Update (WU) será usado.

  • Use /LimitAccess para impedir que o DISM entre em contato com o WU para obter imagens online.
  • Use /All para habilitar todos os recursos pai do recurso especificado.

Exemplos:

Dism /Online /Enable-Feature /FeatureName:Hearts /All

Dism /Online /Enable-Feature /FeatureName:Calc /Source:c:\test\mount\Windows /LimitAccess

Dism /Image:C:\test\offline /Enable-Feature /FeatureName:Calc /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0

/Disable-Feature

Desabilita o recurso especificado na imagem. Você deve usar a opção /FeatureName. Use a opção /Get-Features para localizar o nome do recurso na imagem.

Sintaxe:

/Disable-Feature /FeatureName:<name_in_image> [/PackageName:<name_in_image>] [/Remove]

Você pode especificar /FeatureName várias vezes em uma linha de comando para recursos no mesmo pacote pai.

Você não precisa especificar o nome do pacote usando a opção /PackageName se o pacote for um Pacote do Windows Foundation. Caso contrário, use /PackageName para especificar o pacote pai do recurso.

Use /Remove para remover um recurso sem remover o manifesto do recurso da imagem. O recurso será listado como "Removido" quando você usar /Get-FeatureInfo para exibir detalhes do recurso e pode ser restaurado e habilitado usando /Enable-Feature com a opção /Source.

Exemplos:

*Dism /Online /Disable-Feature /FeatureName:Hearts

Dism /Image:C:\test\offline /Disable-Feature /FeatureName:Calc /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0

/Cleanup-Image

Executa operações de limpeza ou recuperação na imagem. /AnalyzeComponentStore e /ResetBase podem ser usados com imagens do Windows 10, Windows 8.1 e Windows PE acima do 5.0. A partir do Windows 10, versão 1607, você pode especificar /Defer com /ResetBase, mas deve apenas usar /Defer como uma opção na fábrica em que DISM /Resetbase exige mais de 30 minutos para ser concluído.

Dica

Para determinar quando a opção /ResetBase foi executada pela última vez, verifique a entrada do Registro LastResetBase_UTC no caminho do Registro HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Component Based Servicing.

Sintaxe:

/Cleanup-Image {/RevertPendingActions | /SPSuperseded [/HideSP] | /StartComponentCleanup [/ResetBase [/Defer]] | /AnalyzeComponentStore | /CheckHealth | /ScanHealth | /RestoreHealth [/Source: <filepath>] [/LimitAccess]}
Parâmetro Descrição
/RevertPendingActions Se ocorrer uma falha de inicialização, você poderá usar a opção /RevertPendingActions para tentar recuperar o sistema. A operação reverte todas as ações pendentes das operações de manutenção anteriores porque essas ações podem ser a causa da falha de inicialização. Não há suporte para a opção /RevertPendingActions em um sistema operacional em execução ou em uma imagem do Windows PE ou do Windows RE (Ambiente de Recuperação do Windows). Importante: você deve usar a opção /RevertPendingActions somente em um cenário de recuperação do sistema em uma imagem do Windows que não foi inicializada.
SPSuperseded Remove todos os arquivos de backup criados durante a instalação de um service pack. Use /HideSP para impedir que o service pack seja listado no Painel de Controle de Atualizações Instaladas. O service pack não pode ser desinstalado após a conclusão da operação /SPSuperseded.
/StartComponentCleanup Limpa os componentes substituídos e reduz o tamanho do armazenamento de componentes. Use /ResetBase para redefinir a base de componentes substituídos, o que pode reduzir ainda mais o tamanho do repositório de componentes. As atualizações instaladas do Windows não podem ser desinstaladas após a execução de /StartComponentCleanup com a opção /ResetBase. Use /Defer com /ResetBase para adiar operações de limpeza de longa duração para a próxima manutenção automática.
/AnalyzeComponentStore Cria um relatório do repositório de componentes. Para obter mais informações sobre o relatório e como usar as informações fornecidas no relatório, consulte Determinar o tamanho real da pasta WinSxS.
/CheckHealth Verifica se a imagem foi sinalizada como corrompida por um processo com falha e se a corrupção pode ser reparada.
/ScanHealth Verifica a imagem em busca de corrupção no repositório de componentes. Essa operação levará vários minutos.
/RestoreHealth Verifica se há corrupção no armazenamento de componentes na imagem e executa operações de reparo automaticamente. Essa operação levará vários minutos.
/Source Usado com /RestoreHealth para especificar o local de versões válidas conhecidas de arquivos que podem ser usados para o reparo, como um caminho para o diretório Windows de uma imagem montada.
/LimitAccess Impede que o DISM entre em contato com o Windows Update para reparo de imagens online.

Exemplos:

Dism /Image:C:\test\offline /Cleanup-Image /RevertPendingActions

Dism /Image:C:\test\offline /Cleanup-Image /SPSuperseded /HideSP

Dism /Online /Cleanup-Image /ScanHealth

Dism /Online /Cleanup-Image /RestoreHealth /Source:c:\test\mount\windows /LimitAccess

Para saber mais, consulte Reparar uma imagem do Windows.

Limitações

  • Quando você está instalando um pacote em uma imagem offline, o estado do pacote é "instalação pendente" devido a ações online pendentes. Em outras palavras, o pacote será instalado quando a imagem for inicializada e as ações online forem processadas. Se forem solicitadas ações subsequentes, elas não poderão ser processadas até que a ação online pendente anterior seja concluída. Você pode usar a opção /PreventPending ao adicionar um pacote com /AddPackage para ignorar a instalação de um pacote quando houver ações online pendentes.
  • Alguns pacotes exigem que outros pacotes sejam instalados primeiro. Você não deve presumir que as dependências serão satisfeitas. Se um pacote tiver requisitos de dependência, use um arquivo de resposta para instalar os pacotes necessários. Ao passar um arquivo de resposta para o DISM, vários pacotes poderão ser instalados na ordem correta. Para obter mais informações, consulte Adicionar ou remover pacotes offline usando o DISM.
  • Os pacotes são instalados na ordem em que estão listados na linha de comando.
  • Ao usar o DISM para listar os componentes opcionais em uma imagem do Windows PE, os componentes opcionais sempre serão listados como pendentes, mesmo quando a operação de manutenção for bem-sucedida. Isso ocorre por design e não requer nenhuma ação adicional.

O que é DISM?

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

Opções da Linha de Comando de DISM (Gerenciamento e Manutenção de Imagens de Implantação)