DISM 命令列語法的全域選項

全域選項會與部署映像服務與管理 (DISM) 中的大部分維護與映射處理選項搭配使用。 這些選項可用來存取命令列說明、指定檔案位置,以及控制記錄。

維護命令的基本語法

掛接或套用 Windows 映像之後,它可離線作為一般檔案結構,您可以指定 DISM 全域選項、映射的服務選項,以及離線映射的位置。 每個命令列只能使用一個服務選項。

如果您要維護執行中的電腦,請使用 /Online 選項。 如果您要維護掛接或套用的映射,請指定 /Image:<path_to_image> 。 用於維護映射的命令和選項取決於您正在維護的 Windows 作業系統。 它們也會取決於映射是離線還是執行中的作業系統。 所有命令都可以在離線 Windows 映像上運作。 命令的子集可用於維護執行中的作業系統。

DISM 維護命令的基底語法如下:

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

如需維護命令的詳細資訊,請參閱 部署映像服務與管理 (DISM) Command-Line選項

映射處理命令的基本語法

許多全域選項也可用於映射處理命令。 DISM 映射命令的基底語法如下:

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

如需使用 DISM 進行映射管理的詳細資訊,例如套用或掛接映射,請參閱 DISM 映射管理Command-Line選項

服務與映射處理命令的全域選項

離線影像語法

離線映射可使用下列 DISM 全域選項。

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>]

線上影像語法

下列 DISM 全域選項適用于執行中的作業系統。

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>]

選項

下表提供如何使用每個 DISM 全域選項的描述。 這些選項不區分大小寫。

Global 選項 描述

/Get-Help

/?

顯示可用 DISM 命令列選項和引數的相關資訊。

使用 /?/Get-Help 選項,而不指定映射檔來取得映射管理命令的說明,例如 /Mount-Image

範例:

Dism /?

使用/Image:<path_to_an_image> 選項指定映射檔,或使用/Online選項來取得映射中服務命令的說明,例如/Get-Packages。 用於維護映射的選項取決於映射中可用的服務技術。

範例:

Dism /image:C:\test\offline /?

Dism /online /?

您可以藉由指定命令列選項來顯示其他說明。

範例:

Dism /image:C:\test\offline /Add-Driver /?

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

Dism /online /Get-Drivers /?

/LogPath:<log file.log 的路徑>

指定要記錄的完整路徑與檔案名稱。 如果未設定,預設值為: %WINDIR%\Logs\Dism\dism.log

重要

在 Windows PE 中,預設目錄是 RAMDISK 臨時空間,其可能最低為 32 MB。

將會自動封存記錄檔。 封存的記錄檔將會以附加至檔名結尾的 .bak 儲存,並且將會產生新的記錄檔。 每次封存記錄檔時,都會覆寫 .bak 檔案。

使用未加入網域的網路共用時,請先使用 net use 命令搭配網域認證來設定存取權限,再設定 DISM 記錄檔的記錄路徑。

範例:

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

/LogLevel:<n>

指定在記錄中顯示的最大輸出等級。 預設的記錄層級是 3。 接受的值如下所示:

1 = 僅限錯誤

2 = 錯誤和警告

3 = 錯誤、警告和參考

4 = 先前列出的所有資訊,加上偵錯輸出

範例:

Dism /image:C:\test\offline /LogPath:AddPackage.log /LogLevel:1 /Add-Package /PackagePath:C:\packages\package.cab

/圖像:<path_to_offline_image_directory>

這是您將服務之離線 Windows 映像根目錄的完整路徑。 如果名為 Windows 的目錄不是根目錄的子目錄,則必須指定 /WinDir

此選項無法與 /Online搭配使用。

範例:

Dism /image:C:\test\offline /LogPath:AddPackage.log /LogLevel:1 /Add-Package /PackagePath:C:\packages\package.cab

/WinDir:<path_to_%WINDIR%>

/Image 選項搭配使用,以指定相對於映射路徑之 Windows 目錄的路徑。 這不可以是 Windows 目錄的完整路徑;它應該是相對路徑。 如果未指定,預設值是離線映像目錄之根目錄中的 Windows 目錄。

此選項無法與 /Online 選項搭配使用。

範例:

Dism /image:C:\test\offline /WinDir:WinNT /Add-Package /PackagePath:C:\packages\package.cab

/線上

指定要在目前正在執行的作業系統上採取動作。

此選項不能與 /Image/WinDir 選項搭配使用。 使用 /Online 時,會自動偵測到線上映射的 Windows 目錄。

範例:

Dism /online /Get-Packages

/SysDriveDir:<path_to_sysdrive_directory>

使用 /SysDriveDir 從 Windows PE 環境服務已安裝的 Windows 映像。

/SysDriveDir選項會指定 BootMgr 檔案位置的路徑。 只有 BootMgr 檔案所在的磁碟分割並不是您執行命令的磁碟分割時才需要。

例如,在 Windows PE 命令提示字元中,輸入:

Dism /image:C:\Windows /SysDriveDir:C: < /strong>

/安靜

關閉主控台的資訊和進度輸出。 只會顯示錯誤訊息。

若要以無訊息模式執行,每次執行命令列公用程式時,都必須設定此選項。

注意

請勿搭配/Get命令使用/Quiet選項。 不會顯示任何資訊。

範例:

Dism /image:C:\test\offline /Add-Package /PackagePath:C:\packages\package.cab /quiet

/NoRestart

抑制重新啟動。 如果不需要重新啟動,則此命令不會執行任何動作。 此選項會讓應用程式無法提示重新開機 (,或在使用 /Quiet 選項) 時自動重新開機。

範例:

Dism /online /Add-Package /PackagePath:C:\packages\package.cab /NoRestart /quiet

/ScratchDir:<path_to_scratchdirectory>

指定在服務期間擷取檔案以供暫時使用的臨時目錄。 此目錄必須存在於本機。 如果未指定,則會使用 \Windows < em > %Temp% 目錄,並針對每個 DISM 執行隨機產生的十六進位值子目錄名稱。 在臨時目錄中的項目會在每個操作完成後刪除。

您不應該用網路共用位置當作臨時目錄來展開安裝所需的封裝 (.cab 或 .msu 檔案)。 服務時用來解壓縮檔案以供暫時使用的目錄必須是本機目錄。

範例:

Dism /image:C:\test\offline /ScratchDir:C:\Scratch /Add-Package /PackagePath:C:\packages\package.cab

/英語

以英文顯示命令列輸出。

注意

某些資源無法以英文顯示。

當您使用 DISM /? 命令時,不支援此選項。

範例:

Dism /Get-ImageInfo /ImageFile:C:\test\offline\install.wim /index:1 /English

/Format:{Table |List}

指定報表輸出格式。

範例:

Dism /Image:C:\test\offline /Get-Apps /Format:table

部署映像服務與管理 (DISM) 命令列選項

DISM 應用程式服務Command-Line選項

DISM Windows Edition-Servicing 命令列選項

DISM 語言和國際維護命令列選項

DISM 作業系統套件服務命令列選項

DISM 驅動程式服務Command-Line選項

DISM 自動維護命令列選項

DISM Windows PE 服務Command-Line選項