New-CMBootImage

New-CMBootImage

Adds a new operating system boot image.

構文

Parameter Set: New
New-CMBootImage -Index <Int32> -Name <String> -Path <String> [-Description <String> ] [-Version <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細説明

The New-CMBootImage cmdlet adds a new Windows Preinstallation Environment (Windows PE) operating system boot image to Microsoft System Center 2012 Configuration Manager. Operating system images are .wim format files. These files contain a compressed set of reference files and folders that are required to successfully install and configure a boot image on a computer. By default, System Center 2012 Configuration Manager includes both x86 and x64 operating system images.

You must run New-CMBootImage on the computer that is running the Systems Management Server (SMS) provider. The computer account of the computer that is running the SMS provider must have Read and Write access to the package source of the boot image. For more information about the SMS provider, see Planning for the SMS Provider in Configuration Manager (https://go.microsoft.com/fwlink/?LinkID=263566) on TechNet.

パラメーター

-Description<String>

Specifies a description of the boot image.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-Index<Int32>

Specifies an index. An index is the number of an image in a .wim file.

エイリアス

ImageIndex

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-Name<String>

Specifies the name of a new boot image.

エイリアス

なし

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-Path<String>

Specifies the location of the original WIM file for the boot image.

エイリアス

ImagePath

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-Version<String>

Specifies the version of the boot image.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-Confirm

コマンドレットを実行する前に、ユーザーに確認を求めます。

必須?

false

位置は?

named

既定値

false

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-WhatIf

コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。

必須?

false

位置は?

named

既定値

false

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

Example 1: Create a new boot image object

This command creates a new boot image object and provides it with a source path for its WIM file, an index value, a name, an operating system version, and a description.

PS C:\> New-CMBootImage -Path "\\Server99.Contoso.com\SMS_CCC\osd\boot\i386\boot.wim" -Index 1 -Name "WinPE Boot Image" -Version 11 -Description "WinPE Boot Image x86 Approved 9/1/2012"

関連トピック

Get-CMBootImage

Remove-CMBootImage

Set-CMBootImage