通过

New-CMBootImage

  • 参考
模块:
ConfigurationManager

创建自定义启动映像。

语法

New-CMBootImage
   [-Description <String>]
   -Index <Int32>
   -Name <String>
   -Path <String>
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

使用此 cmdlet (Windows PE) OS 启动映像创建自定义 Windows 预安装环境。 默认情况下，Configuration Manager 包括两个适用于 x86 和 x64 体系结构的启动映像。 有关详细信息，请参阅 使用 Configuration Manager 管理启动映像。

注意

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。

示例

示例 1：创建自定义启动映像

此命令创建自定义启动映像。 它指定其 WIM 文件的源路径、索引值、名称、版本和说明。

New-CMBootImage -Path "\\Server99.Contoso.com\SMS_CCC\osd\boot\x64\boot.wim" -Index 1 -Name "Custom boot image" -Version "11" -Description "WinPE Boot Image x64 Approved 9/1/2012"

参数

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-Description

指定启动映像的可选说明，以帮助你识别它。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ForceWildcardHandling

此参数处理通配符，并可能导致意外行为， (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Index

指定要用于此启动映像的 WinPE 文件中映像的索引。

类型:Int32
别名:ImageIndex
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Name

指定启动映像的名称。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Path

为启动映像指定原始 WIM 文件的网络路径。

类型:String
别名:ImagePath
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Version

指定启动映像的版本。 此值不是 OS 版本，而是你管理的字符串。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

输入

None

输出

IResultObject

备注

有关此返回对象及其属性的详细信息，请参阅 SMS_BootImagePackage服务器 WMI 类。