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-Package
nã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.
/AnalyzeComponentStore
e /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
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)