オペレーティング システムのパッケージ サービスのコマンド ライン オプション

発行: 2009年10月

更新日: 2009年10月

適用対象: Windows 7

オペレーティング システム パッケージのサービス コマンドをオフラインで使用して、キャビネット (.cab) または Windows Update スタンドアロン インストーラー (.msu) ファイルとして提供される Windows® パッケージをインストール、削除、または更新することができます。Microsoft では、ソフトウェア更新プログラム、サービス パック、および言語パックを配布するときにパッケージを使用します。パッケージには Windows 機能も含めることができます。また、これらのサービス コマンドを使用し、オフラインまたは実行中の Windows インストールで、Windows の機能を有効にしたり無効にすることができます。機能はコア オペレーティング システムのオプション コンポーネントです。

DISM を使用して Windows イメージを操作する場合の基本構文は次のとおりです。

DISM.exe {/Image:<path_to_ image_directory> | /Online} [dism_options] {servicing_command} [<servicing_argument>]

次のオペレーティング システム パッケージのサービス オプションはオフライン イメージに対して使用できます。

DISM.exe /Image:<path_to_ image_directory> [/Get-Packages | /Get-PackageInfo | /Add-Package | /Remove-Package ] [/Get-Features | /Get-FeatureInfo | /Enable-Feature | /Disable-Feature ]

次のオペレーティング システム パッケージのサービス オプションは実行中のオペレーティング システムに対して使用できます。

DISM.exe /Online [/Get-Packages | /Get-PackageInfo | /Add-Package | /Remove-Package ] [/Get-Features | /Get-FeatureInfo | /Enable-Feature | /Disable-Feature ]

次の表では、オペレーティング システム パッケージの各サービス オプションの使用方法を説明します。これらのオプションでは、大文字と小文字は区別されません。ただし、機能の名前では大文字と小文字が区別されます。

 

オプション 引数 説明

/Get-Help

/?

 

パッケージ サービスのコマンドライン オプションのすぐ後に使用すると、オプションと引数に関する情報が表示されます。

イメージが指定されていると、追加のトピックを表示できるようになる場合もあります。

例:

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

/Get-Packages

/Format:Table

/Format:List

イメージ内のすべてのパッケージに関する基本情報を表示します。/Format:Table または /Format:List 引数を使用すると、表形式または一覧形式で情報が出力されます。

例:

Dism /image:C:\test\offline /Get-Packages 
Dism /image:C:\test\offline /Get-Packages /Format:Table
Dism /online /Get-Packages

/Get-PackageInfo

/PackageName:<name_in_image>

/PackagePath:<path_to_cabfile>

.cab ファイルとして提供されたパッケージの詳細情報を表示します。.cab ファイルのみ指定できます。このコマンドを使用して .msu ファイルのパッケージ情報を取得することはできません。/PackagePath では .cab ファイルまたはフォルダーを指定できます。

/Get-Packages オプションを使用してイメージ内のパッケージの名前を確認するか、または .cab ファイルへのパスを指定することができます。.cab ファイルのパスは、ファイルがインストールされているオフライン イメージ上の場所ではなく、パッケージのインストール元を指定する必要があります。

例:

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

/PackagePath:<path_to_cabfile>

/IgnoreCheck

指定された .cab または .msu パッケージをイメージにインストールします。1 行のコマンド ラインで複数のパッケージを追加できます。各パッケージを適用できるかどうかが確認されます。パッケージを指定のイメージに適用できない場合は、エラー メッセージが表示されます。各パッケージを適用できるかどうか確認することなくコマンドが処理されるようにする場合は、/IgnoreCheck 引数を使用します。

/PackagePath では、次のファイルを指定できます。

  • 単一の .cab ファイルまたは .msu ファイル

  • 1 つの展開された .cab ファイルを含むフォルダー

  • 1 つの .msu ファイルを含むフォルダー

  • 複数の .cab ファイルまたは .msu ファイルを含むフォルダー

例:

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

/Remove-Package

/PackageName:<name_in_image>

/PackagePath:<path_to_cabfile>

指定された .cab ファイル パッケージをイメージから削除します。.cab ファイルのみ指定できます。このコマンドで .msu ファイルを削除することはできません。

noteメモ
このコマンドを使用してオフライン イメージからパッケージを削除しても、イメージのサイズは小さくなりません。

/PackagePath オプションを使用してパッケージのインストール元を指定するか、CAB ファイルへのパスを指定するか、またはパッケージをイメージに表示されている名前で指定することができます。イメージ内のパッケージの名前を確認するには、/Get-Packages オプションを使用します。

例:

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:RemovePackage.log /Remove-Package /PackagePath:C:\packages\package1.cab /PackagePath: C:\packages\package2.cab

/Get-Features

/PackageName:<name_in_image>

/PackagePath:<path_to_cabfile>

/Format:Table

/Format:List

パッケージ内のすべての機能 (オプションの Windows の基本機能が含まれているオペレーティング システム コンポーネント) に関する基本情報を表示します。/Get-Packages オプションを使用してイメージ内のパッケージの名前を確認するか、またはパッケージのインストール元のパスを指定できます。パッケージの名前またはパスを指定しない場合は、イメージ内のすべての機能が表示されます。/PackagePath では .cab ファイルまたはフォルダーを指定できます。

機能の名前では、大文字と小文字が区別されます。

/Format:Table または /Format:List 引数を使用すると、表形式または一覧形式で情報が出力されます。

例:

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

/FeatureName:<name_in_image>

/PackageName:<name_in_image>

/PackagePath:<path_to_cabfile>

機能の詳細情報を表示します。/FeatureName を使用する必要があります。イメージ内の機能の名前を確認するには、/Get-Features オプションを使用します。機能の名前では、大文字と小文字が区別されます。

/PackageName および /PackagePath は任意指定であり、パッケージ内の特定の機能を確認するのに使用できます。

例:

Dism /image:C:\test\offline /Get-FeatureInfo /FeatureName:Hearts
Dism /image:C:\test\offline /Get-FeatureInfo /FeatureName:Feature /PackagePath:C:\packages\package.cab

/Enable-Feature

/FeatureName:<name_in_image>

/PackageName:<name_in_image>

/PackagePath:<path_to_package>

指定されたイメージ内の機能を有効にするか、または更新します。/FeatureName をオプションを使用する必要があります。イメージ内の機能の名前を確認するには、/Get-Features オプションを使用します。機能の名前では、大文字と小文字が区別されます。

Windows Foundation パッケージの場合は、/PackageName を指定する必要はありません。

/PackagePath を使用して、パッケージのインストール元を指定します。パッケージがまだインストールされていない場合は、インストールされて有効にされます。

例:

Dism /image:C:\test\offline /Enable-Feature /FeatureName:Hearts
Dism /image:C:\test\offline /Enable-Feature /FeatureName:Calc /PackagePath:C:\packages\Calc.cab
Dism /image:C:\test\offline /Enable-Feature /FeatureName:Calc /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0

/Disable-Feature

/FeatureName:<name_in_image>

/PackageName:<name_in_image>

イメージ内の指定された機能を無効にします。/FeatureName をオプションを使用する必要があります。イメージ内の機能の名前を確認するには、/Get-Features オプションを使用します。

機能名では、大文字と小文字が区別されます。

例:

Dism /image:C:\test\offline /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

/RevertPendingActions

イメージに対してクリーンアップ操作または回復操作を実行します。

起動エラーが発生した場合は、/RevertPendingActions オプションを使用して、システムの回復を試してみることができます。このオプションを使用すると、直前のサービス操作で保留になっていた処理がすべて元に戻されます。これらの処理が起動エラーの原因である可能性があるためです。/RevertPendingActions オプションは、実行中のオペレーティング システム、Windows PE または Windows 回復環境 (Windows RE) イメージではサポートされていません。

Important重要
/RevertPendingActions オプションは、起動できなかった Windows イメージを回復するために、システム回復のシナリオでのみ使用する必要があります。

例:

DISM /Image:C:\test\offline /Cleanup-Image /RevertPendingActions

制限事項

  • オフライン イメージにパッケージをインストールする場合、オンライン操作が保留中になるため、パッケージの状態は "インストールの保留中" になります。つまり、パッケージが実際にインストールされるのは、イメージが起動され、オンライン操作が実行されるときです。続いて操作を要求しても、前の保留中のオンライン操作が完了するまでは処理されません。

    パッケージが "インストールの保留中" 状態の場合に、このパッケージをステージングすると、パッケージの状態が "アンインストールの保留中" に設定されます。パッケージはステージングする前にアンインストールする必要があるためです。

  • 一部のパッケージでは、最初に他のパッケージをインストールする必要があります。依存関係が適宜解決されるものとは想定しないでください。依存関係の要件がある場合は、応答ファイルを使用して必要なパッケージをインストールする必要があります。応答ファイルを DISM に渡すことにより、複数のパッケージを正しい順序でインストールできます。これは、複数のパッケージをインストールする場合に適した方法です。

  • パッケージはコマンド ラインで指定された順序でインストールされます。

  • DISM を使用して Windows PE イメージ内の機能パッケージを一覧表示する場合、サービス操作が正常に終了していてもパッケージの状態は常に保留中と表示されます。これは仕様によるものであり、ユーザー側での対応は特に必要ありません。

関連項目

コミュニティの追加

追加
表示: