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

Artigo
06/20/2023

As opções globais são usadas com a maioria das opções de manutenção e geração de imagens no DISM (Gerenciamento e Manutenção de Imagens de Implantação). Essas opções podem ser usadas para acessar a ajuda da linha de comando, especificar locais de arquivo e controlar o registro em log.

Sintaxe básica para comandos de manutenção

Depois de montar ou aplicar uma imagem do Windows, ela estará disponível offline como uma estrutura de arquivos simples que você pode especificar opções globais do DISM, uma opção de manutenção para sua imagem e o local da imagem offline. Você pode usar apenas uma opção de manutenção por linha de comando.

Se você estiver atendendo um computador em execução, use a opção /Online . Se você estiver atendendo a uma imagem montada ou aplicada, especifique /Image:<path_to_image>. Os comandos e opções disponíveis para manutenção de uma imagem dependem de qual sistema operacional Windows você está atendendo. Eles também dependem se a imagem está offline ou um sistema operacional em execução. Todos os comandos funcionam em uma imagem offline do Windows. Subconjuntos dos comandos estão disponíveis para manutenção de um sistema operacional em execução.

A sintaxe base para comandos de manutenção DISM é:

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

Para obter mais informações sobre comandos de manutenção, consulte DisM (Gerenciamento e Manutenção de Imagens de Implantação) Command-Line Opções.

Sintaxe básica para comandos de geração de imagens

Muitas das opções globais também estão disponíveis para comandos de geração de imagens. A sintaxe base para comandos de imagem DISM é:

DISM.exe [dism_global_options] {servicing_option} [<servicing_argument>]

Para obter mais informações sobre como usar o DISM para gerenciamento de imagens, como aplicar ou montar uma imagem, consulte Opções de Command-Line de Gerenciamento de Imagens do DISM.

Opções globais para comandos de manutenção e geração de imagens

Sintaxe de imagens offline

As opções globais do DISM a seguir estão disponíveis para uma imagem offline.

DISM.exe /image:<path_to_offline_image_directory> [/WinDir:<path_to_%WINDIR>] [/LogPath:<path_to_log_file.log>] [/LogLevel:<n>] [/SysDriveDir:<path_to_bootMgr_file>] [/Quiet] [/NoRestart] [/ScratchDir:<path_to_scratch_directory>] [/English] [/Format:<output_format>]

Sintaxe de imagens online

As opções globais do DISM a seguir estão disponíveis para um sistema operacional em execução.

DISM.exe /online [/LogPath:<path_to_log_file>] [/LogLevel:<n>] [/SysDriveDir:<path_to_bootMgr_file>] [/Quiet] [/NoRestart] [/ScratchDir:<path_to_scratch_directory>] [/English] [/Format:<output_format>]

Opções

A tabela a seguir fornece uma descrição de como cada opção global dism pode ser usada. Essas opções não diferenciam maiúsculas de minúsculas.

Opção global	Descrição
/Get-Help /?	Exibe informações sobre opções e argumentos de linha de comando dism disponíveis. Use a opção /? ou /Get-Help sem especificar um arquivo de imagem para obter ajuda sobre comandos de gerenciamento de imagens, como /Mount-Image. Exemplo: Dism/? Especifique um arquivo de imagem com a opção /Image:<path_to_an_image> ou use a opção /Online para obter ajuda sobre o comando de manutenção na imagem, como /Get-Packages. As opções disponíveis para manutenção de uma imagem dependem da tecnologia de manutenção disponível em sua imagem. Exemplo: Dism /image:C:\test\offline /? Dism /online /? Você pode exibir ajuda adicional especificando uma opção de linha de comando. Exemplo: Dism /image:C:\test\offline /Add-Driver /? Dism /image:C:\test\offline /Add-Package /? Dism /online /Get-Drivers /?
/Logpath:<caminho para log file.log>	Especifica o caminho completo e o nome do arquivo para log. Se não estiver definido, o padrão será: %WINDIR%\Logs\Dism\dism.log Importante No Windows PE, o diretório padrão é o espaço de rascunho RAMDISK que pode ser tão baixo quanto 32 MB. O arquivo de log será armazenado automaticamente. O arquivo de log armazenado será salvo com .bak anexado ao nome do arquivo, e um novo arquivo de log será gerado. Sempre que o arquivo de log é armazenado, o arquivo .bak é substituído. Ao usar um compartilhamento de rede que não está associado a um domínio, use o comando net use junto com as credenciais de domínio para definir permissões de acesso antes de definir o caminho de log para o log do DISM. Exemplo: Dism /image:C:\test\offline /LogPath:AddPackage.log /Add-Package /PackagePath:C:\packages\package.cab
/Loglevel:<N>	Especifica o nível máximo de saída mostrado nos logs. O nível de log padrão é 3. Os valores aceitos são os seguintes: 1 = Somente erros 2 = Erros e avisos 3 = Erros, avisos e informativos 4 = Todas as informações listadas anteriormente, além da saída de depuração Exemplo: Dism /image:C:\test\offline /LogPath:AddPackage.log /LogLevel:1 /Add-Package /PackagePath:C:\packages\package.cab
/Imagem:<path_to_offline_image_directory>	Esse é o caminho completo para o diretório raiz da imagem offline do Windows que você atenderá. Se o diretório chamado Windows não for um subdiretório do diretório raiz, /WinDir deverá ser especificado. Essa opção não pode ser usada com /Online. Exemplo: Dism /image:C:\test\offline /LogPath:AddPackage.log /LogLevel:1 /Add-Package /PackagePath:C:\packages\package.cab
/Windir:<path_to_%WINDIR%>	Usado com a opção /Image para especificar o caminho para o diretório do Windows em relação ao caminho da imagem. Ele não pode ser o caminho completo para o diretório do Windows, mas sim um caminho relativo. Se não for especificado, o padrão será o diretório do Windows na raiz do diretório de imagem offline. Essa opção não pode ser usada com a opção /Online . Exemplo: Dism /image:C:\test\offline /WinDir:WinNT /Add-Package /PackagePath:C:\packages\package.cab
/Online	Especifica que a ação deve ser executada no sistema operacional que está em execução no momento. Essa opção não pode ser usada com a opção /Image ou /WinDir . Quando /Online é usado, o diretório do Windows para a imagem online é detectado automaticamente. Exemplo: Dism /online /Get-Packages
/SysDriveDir:<path_to_sysdrive_directory>	Use /SysDriveDir para atender a uma imagem do Windows instalada de um ambiente do Windows PE. A opção /SysDriveDir especifica o caminho para o local dos arquivos BootMgr. Isso apenas é necessário quando os arquivos BootMgr estão localizados em uma partição diferente daquela da qual você está executando o comando. Por exemplo, em um prompt de comando do Windows PE, digite: Dism /image:C:\Windows /SysDriveDir:C:</strong>
/Tranquila	Desativa as informações e a saída de progresso para o console. Somente mensagens de erro serão exibidas. Para ser executada no modo silencioso, essa opção deve ser definida sempre que o utilitário de linha de comando for executado. Observação Não use a opção /Quiet com comandos /Get . Nenhuma informação será exibida. Exemplo: Dism /image:C:\test\offline /Add-Package /PackagePath:C:\packages\package.cab /quiet
/NoRestart	Suprime a reinicialização. Se não for necessário reinicializar, esse comando não fará nada. Essa opção impedirá que o aplicativo solicite uma reinicialização (ou impedirá que ele seja reiniciado automaticamente se a opção /Quiet for usada). Exemplo: Dism /online /Add-Package /PackagePath:C:\packages\package.cab /NoRestart /quiet
/ScratchDir:<path_to_scratchdirectory>	Especifica um diretório temporário que será usado ao extrair arquivos para uso temporário durante a manutenção. O diretório deve existir localmente. Se não for especificado, o diretório \Windows<em>%Temp% será usado, com um nome de subdiretório de valor hexadecimal gerado aleatoriamente para cada execução do DISM. Os itens no diretório temporário são excluídos depois de cada operação. Não convém usar um local de compartilhamento de rede como diretório temporário para expandir um pacote (arquivo .cab ou .msu) para instalação. O diretório usado para a extração de arquivos para uso temporário durante a manutenção deve ser um diretório local. Exemplo: Dism /image:C:\test\offline /ScratchDir:C:\Scratch /Add-Package /PackagePath:C:\packages\package.cab
/Inglês	Exibe a saída da linha de comando em inglês. Observação Alguns recursos não podem ser exibidos em inglês. Não há suporte para essa opção quando você usa o comando DISM /? . Exemplo: Dism /Get-ImageInfo /ImageFile:C:\test\offline\install.wim /index:1 /English
/Format:{Table \| List}	Especifica o formato de saída do relatório. Exemplo: Dism /Image:C:\test\offline /Get-Apps /Format:table