Opções de Command-Line de manutenção do pacote do sistema operacional DISM (.cab ou .msu)

Use o DISM com o gabinete do Windows (.cab) ou Windows Update arquivos do Instalador Autônomo (.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.

Syntax

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

As seguintes opções de manutenção de pacote 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 pacote 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 /Format:Table argumento 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 de .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 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 original 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 Windows 11, versão 21H2 ou posterior. Se você estiver trabalhando com uma imagem do Windows antes do Windows 11, versão 21H2, 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 de .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 contém um .cab ou arquivos .msu em sua raiz, todas as subpastas também serão verificadas recursivamente para 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-Packagenão executa uma marcar completa para a aplicabilidade e as dependências de um pacote:

• Se você estiver adicionando um pacote com dependências, verifique se todas as dependências estão instaladas quando você adicionar o pacote.
• Se você estiver adicionando um .msu, certifique-se de marcar o KB associado para quaisquer 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

/Remove-Package

Remove um pacote de arquivos .cab especificado da imagem. Somente arquivos .cab podem ser especificados. Não é possível usar esse 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 original do pacote, especifique o caminho para o arquivo CAB ou especifique o pacote pelo nome, pois ele está 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 origem 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 de pacote em uma imagem.
• /PackagePath pode apontar para um arquivo .cab ou uma pasta.

Use o /Format:Table argumento 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. É necessário usar /FeatureName. Você pode usar a opção /Get-Features para localizar 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 /Source argumento 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 uma /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 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 ele 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. /AnalyzeComponentStoree /ResetBase podem ser usados com Windows 10, Windows 8.1 e imagens do Windows PE acima da 5.0. A partir do Windows 10, versão 1607, você pode especificar /Defer com /ResetBase, mas só deve usar /Defer como uma opção na fábrica em DISM /Resetbase que requer mais de 30 minutos para concluir.

Dica

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

Sintaxe:

/Cleanup-Image {/RevertPendingActions | /SPSuperseded [/HideSP] | /StartComponentCleanup [/ResetBase [/Defer]] | /AnalyzeComponentStore | /CheckHealth | /ScanHealth | /RestoreHealth [/Source: <filepath>] [/LimitAccess]}

Parâmetro	Descrição
/RevertPendingActions	Se você tiver uma falha de inicialização, 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 Ambiente de Recuperação do Windows (Windows RE). 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.
SPSupersed	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 Atualizações Painel de Controle Instalado. O service pack não pode ser desinstalado depois que a operação /SPSuperseded for concluída.
/StartComponentCleanup	Limpa os componentes substituídos e reduz o tamanho do repositório 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 depois de executar /StartComponentCleanup com a opção /ResetBase. Use /Defer com /ResetBase para adiar operações de limpeza de execução prolongada 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 quanto à corrupção do repositório de componentes. Essa operação levará vários minutos.
/RestoreHealth	Examina a imagem quanto à corrupção do repositório de componentes e, em seguida, executa operações de reparo automaticamente. Essa operação levará vários minutos.
/Fonte	Usado com /RestoreHealth para especificar o local de boas versões 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 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, confira Reparar uma imagem do Windows.

Limitações

• Quando você está instalando um pacote em uma imagem offline, o estado do pacote é "instalar 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 as ações subsequentes forem solicitadas, 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 assumir que as dependências serão atendidas. 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 DISM, vários pacotes podem ser instalados na ordem correta. Para obter mais informações, consulte Adicionar ou remover pacotes offline usando 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 tiver sido bem-sucedida. Isso é por design e não requer nenhuma ação adicional.

Tópicos relacionados

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)