New-WindowsImage
New-WindowsImage
Captures an image of a drive to a new WIM file.
構文
Parameter Set: Default
New-WindowsImage -CapturePath <String> -ImagePath <String> -Name <String> [-CheckIntegrity] [-CompressionType <String> ] [-ConfigFilePath <String> ] [-Description <String> ] [-LogLevel <LogLevel> ] [-LogPath <String> ] [-NoRpFix] [-ScratchDirectory <String> ] [-Setbootable] [-Verify] [-WIMBoot] [ <CommonParameters>]
詳細説明
The New-WindowsImage cmdlet captures an image of a drive to a new WIM file. Captured directories include all subfolders and data. You cannot capture an empty directory. A directory must contain at least one file.
This cmdlet does not apply to virtual hard disk (VHD) files.
パラメーター
-CapturePath<String>
Specifies the drive or path to the Windows operating system that is to be captured to an image file.
エイリアス |
なし |
必須? |
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 |
-CompressionType<String>
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-ConfigFilePath<String>
Specifies the location of a configuration file that lists exclusions for image capture commands and compress commands. For more information, see DISM Configuration List and WimScript.ini Files, https://go.microsoft.com/fwlink/?LinkID=313768.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-Description<String>
Specifies the description of the image to be captured.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-ImagePath<String>
Specifies the location of a WIM file.
エイリアス |
なし |
必須? |
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 |
-Setbootable
ボリューム イメージを起動可能なイメージとしてマークします。この引数は、Windows PE イメージでのみ使用できます。.wim ファイルで起動可能としてマークできるボリューム イメージは 1 つだけです。
エイリアス |
SB |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-Verify
エラーおよびファイルの重複を確認します。適用操作中に、たとえば、Add-WindowsImage コマンドレットを使用する際に、適用されるファイルのサイズとハッシュがイメージ ファイルに照らしてチェックされ、両者が等しいことが確認されます。キャプチャ操作中、たとえば、New-WindowsImage コマンドレットを使用する際に、ファイルが Windows イメージにキャプチャされた後で、一時ファイルに書き込まれ、元のファイルとビット単位で比較されます。
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-WIMBoot
Specifies that the image 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 captures the Drive D image in the WIM file located on d:\ and save to the file c:\imagestore\custom.wim.
PS C:\> New-WindowsImage -ImagePath c:\imagestore\custom.wim -CapturePath d:\ -Name "Drive D"