コマンドライン構文での DISM のグローバルオプション

[アーティクル]
05/30/2023

グローバルオプションは、展開イメージのサービスと管理 (DISM) のサービスとイメージングのオプションのほとんどで使用されます。これらのオプションを使用して、コマンドラインヘルプへのアクセス、ファイルの場所の指定、ログ記録の制御を行うことができます。

サービスコマンドの基本構文

Windows イメージをマウントまたは適用した後は、DISM グローバルオプション、イメージのサービスオプション、オフラインイメージの場所を指定できるフラットファイル構造として、オフラインで使用できます。 1 つのコマンドラインに使用できるサービスオプションは 1 つのみです。

実行中のコンピューターを操作している場合は、/Online オプションを使用します。マウントされたイメージまたは適用されたイメージを操作している場合は、/Image:<path_to_image> を指定します。イメージの操作に使用できるコマンドとオプションは、操作している Windows オペレーティングシステムによって異なる場合があります。また、イメージがオフラインであるか、実行中のオペレーティングシステムであるかによっても異なります。すべてのコマンドは、オフラインの Windows イメージで機能します。コマンドのサブセットは、実行中のオペレーティングシステムの操作に使用できます。

DISM サービスコマンドの基本構文は次のとおりです。

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

サービスコマンドの詳細については、「展開イメージのサービスと管理 (DISM) のコマンドラインオプション」をご覧ください。

イメージングコマンドの基本構文

グローバルオプションの多くは、イメージングコマンドにも使用できます。 DISM イメージングコマンドの基本構文は次のとおりです。

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

イメージの適用やマウントなど、イメージの管理に DISM を使用する方法の詳細については、「DISM イメージ管理のコマンドラインオプション」をご覧ください。

サービスコマンドとイメージングコマンドのグローバルオプション

オフラインイメージの構文

オフラインイメージでは、次の 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 コマンドラインオプションおよび引数に関する情報を表示します。 /Mount-Image などのイメージ管理コマンドに関するヘルプを表示するには、イメージファイルを指定せずに /? または /Get-Help オプションを使用します。例: 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:<file.log を記録するためのパス>	ログの記録先の完全なパスとファイル名を指定します。設定しない場合、既定値の %WINDIR%\Logs\Dism\dism.log となります。重要 Windows PE では、既定のディレクトリは RAMDISK スクラッチ領域で、32 MB 程度しかない場合があります。ログファイルは自動的にアーカイブされます。アーカイブされたログファイルはファイル名に .bak が追加されて保存され、新たなログファイルが生成されます。ログファイルがアーカイブされるたびに、.bak ファイルが上書きされます。ドメインに参加していないネットワーク共有を使用する場合、DISM ログのパスを設定する前に、ドメイン資格情報を指定して net use コマンドを使ってアクセス許可を設定します。例: 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
/Image:<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
/Online	現在実行中のオペレーティングシステムに対して操作が行われることを指定します。このオプションは、/Image オプションまたは /WinDir オプションと共に使用することはできません。 /Online を使用すると、オンラインイメージの Windows ディレクトリが自動的に検出されます。例: Dism /online /Get-Packages
/SysDriveDir:<path_to_sysdrive_directory>	インストールされた Windows イメージを Windows PE 環境から提供するには、/SysDriveDir を使います。 /SysDriveDir オプションは、BootMgr ファイルの場所へのパスを指定します。これは、コマンドの実行元でないパーティションに BootMgr ファイルが配置されている場合にのみ指定する必要があります。たとえば、Windows PE コマンドプロンプトで、次のように入力します。 Dism /image:C:\Windows /SysDriveDir:C:</strong>
/Quiet	コンソールへの情報と進行状況の出力をオフにします。エラーメッセージのみ、引き続き表示されます。 Quiet モードで実行するには、コマンドラインユーティリティを実行するたびにこのオプションを設定する必要があります。注 /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 の実行ごとにランダムに生成された 16 進数値が使用されます。各操作の終了後、このスクラッチディレクトリ内の項目は削除されます。インストール時のパッケージ (.cab または .msu ファイル) の展開用として、ネットワーク共有の場所をスクラッチディレクトリとして使用しないでください。操作の実行中にファイルの展開に一時的に使用するディレクトリはローカルディレクトリであることが必要です。例: Dism /image:C:\test\offline /ScratchDir:C:\Scratch /Add-Package /PackagePath:C:\packages\package.cab
/English	コマンドライン出力を英語で表示します。注一部のリソースは英語で表示できません。このオプションは、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