Expand-WindowsImage
Expand-WindowsImage
Applies an image to a specified location.
構文
Parameter Set: InputByFilePathAndIndex
Expand-WindowsImage -ApplyPath <String> -ImagePath <String> -Index <UInt32> [-CheckIntegrity] [-ConfirmTrustedFile] [-LogLevel <LogLevel> ] [-LogPath <String> ] [-NoRpFix] [-ScratchDirectory <String> ] [-SplitImageFilePattern <String> ] [-Verify] [-WIMBoot] [ <CommonParameters>]
Parameter Set: InputByFilePathAndName
Expand-WindowsImage -ApplyPath <String> -ImagePath <String> -Name <String> [-CheckIntegrity] [-ConfirmTrustedFile] [-LogLevel <LogLevel> ] [-LogPath <String> ] [-NoRpFix] [-ScratchDirectory <String> ] [-SplitImageFilePattern <String> ] [-Verify] [-WIMBoot] [ <CommonParameters>]
詳細説明
The Expand-WindowsImage cmdlet applies an image to a specified location.
This cmdlet does not apply to virtual hard disk (VHD) files.
パラメーター
-ApplyPath<String>
Specifies the location where the image is to be applied.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-CheckIntegrity
Add—WindowsImage、Dismount-WindowsImage、または Save-WindowsImage コマンドレットと共に使用したときに、.wim ファイルの破損を検出して追跡します。CheckIntegrity は、Expand-WindowsImage コマンドレットまたは Mount-WindowsImage コマンドレットと共に使用したときに、.wim ファイルが破損していることを DISM で検出した場合、操作を停止します。
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-ConfirmTrustedFile
Validates the image for Trusted Desktop on a Windows® 8 or Windows® 8.1. This option can only be run on a computer running at least Windows® プレインストール環境 (Windows PE) 4.0.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-ImagePath<String>
Specifies the location of a WIM file.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-Index<UInt32>
WIM ファイルまたは VHD ファイル内の Windows イメージのインデックス番号を指定します。VHD ファイルの場合、このインデックスは 1 にする必要があります。
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-LogLevel<LogLevel>
ログに表示する最大の出力レベルを指定します。既定のログ レベルは 3 です。指定できる値は次のとおりです。1 = エラーのみ2 = エラーと警告3 = エラー、警告、および情報4 = 以上のすべての情報とデバッグ出力
エイリアス |
LL |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-LogPath<String>
ログの記録先の完全なパスとファイル名を指定します。設定しない場合、既定値は %WINDIR%\Logs\Dism\dism.log
です。Windows PE では、既定のディレクトリは RAMDISK スクラッチ領域 (最低 32 MB) です。ログ ファイルは自動的にアーカイブされます。アーカイブされたログ ファイルは、ファイル名に .bak が追加されて保存され、新しいログ ファイルが生成されます。ログ ファイルがアーカイブされるたびに、.bak ファイルが上書きされます。ドメインに参加していないネットワーク共有を使用する場合は、DISM ログのパスを設定する前に、ドメイン資格情報を指定して net use コマンドを使用し、アクセス許可を設定します。
エイリアス |
LP |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-Name<String>
Specifies the name of an image in a WIM file.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-NoRpFix
再解析ポイント タグの修正を無効にします。再解析ポイントとは、ファイル システム上の他のファイルへのリンクを含んでいるファイルです。このパラメーターを指定しない場合、ImagePath パラメーターで指定された値以外のパスに解決される再解析ポイントはキャプチャされません。
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-ScratchDirectory<String>
操作の実行中に使用するファイルの展開時に使用される一時ディレクトリを指定します。このディレクトリはローカルに存在する必要があります。指定しない場合は \Windows\%Temp%
ディレクトリが使用され、サブディレクトリ名には DISM の実行ごとにランダムに生成される 16 進数値が使用されます。各操作の終了後、このスクラッチ ディレクトリ内の項目は削除されます。インストール用のパッケージ (.cab または .msu ファイル) を展開する際に、ネットワーク共有の場所をスクラッチ ディレクトリとして使用しないでください。操作の実行中にファイルを展開するために一時的に使用されるディレクトリは、ローカル ディレクトリである必要があります。
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-SplitImageFilePattern<String>
基本分割イメージ ファイルの場所と名前を指定します。
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-Verify
エラーおよびファイルの重複を確認します。適用操作中に、たとえば、Add-WindowsImage コマンドレットを使用する際に、適用されるファイルのサイズとハッシュがイメージ ファイルに照らしてチェックされ、両者が等しいことが確認されます。キャプチャ操作中、たとえば、New-WindowsImage コマンドレットを使用する際に、ファイルが Windows イメージにキャプチャされた後で、一時ファイルに書き込まれ、元のファイルとビット単位で比較されます。
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-WIMBoot
Specifies that the offline image to be added will be formatted to install on a Windows Image Format Boot (WIMBoot) system.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
<CommonParameters>
このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。
入力
入力型は、コマンドレットにパイプできるオブジェクトの型です。
- System.String[]
- Microsoft.Dism.Commands.ImageObject
- Microsoft.Dism.Commands.ImageObjectWithState
出力
出力型は、コマンドレットによって生成されるオブジェクトの型です。
- Microsoft.Dism.Commands.OfflineImageObject
例
Example 1
This command applies an image at index 1 in the c:\imagestore\custom.wim file to partition d:.
PS C:\> Expand-WindowsImage -ImagePath c:\imagestore\custom.wim -ApplyPath d:\ -Index 1
Example 2
This command applies the split image with a name that matches c:\imagestore\split\custom*.swm with a name of Windows Pro to partition d:. Check for errors and file duplication while applying the image.
PS C:\> Expand-WindowsImage -ImagePath c:\imagestore\split\custom.swm -SplitImageFilePattern c:\imagestore\split\custom*.swm -ApplyPath d:\ -Name "Windows Pro" -Verify