New-CMOperatingSystemImage

创建 OS 映像。

语法

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

说明

使用此 cmdlet 将 OS 映像添加到Configuration Manager站点。 OS 映像是表示引用文件和文件夹的压缩集合的 WIM 文件。 Configuration Manager将这些映像与任务序列一起使用,以在计算机上部署 OS。 有关详细信息,请参阅使用 Configuration Manager 管理 OS 映像

注意

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

示例

示例 1:创建 OS 映像

此命令从 OS 映像的安装源文件的网络路径创建名为“Windows 10最新”的 OS 映像。

New-CMOperatingSystemImage -Name "Windows 10 latest" -Path "\\Contoso01\CM\Images\win10_latest.wim"

参数

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

指定可选说明以帮助识别图像。 最大长度为 127 个字符。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Index

添加此参数时,站点将从多索引图像中提取单个索引图像。 然后,它将新图像放置在与原始图像相同的源文件夹中。

使用此选项可生成更小的映像文件,并加快脱机服务速度。 它还支持在应用软件更新后 较小的映像文件优化映像服务的过程。

Type:Int32
Aliases:ImageIndex
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

指定 OS 映像的名称。 最大长度为 50 个字符。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Path

指定 OS 映像 WIM 文件的网络路径。 路径需要包含扩展名为 .wim 的 WIM 文件名。

Type:String
Aliases:PackageSourcePath
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Version

指定 OS 映像的可选版本。 此值用于内部版本控制,而不是操作系统版本。 最大长度为 32 个字符。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输入

None

输出

IResultObject

备注

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