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 latest”的 OS 映像。
New-CMOperatingSystemImage -Name "Windows 10 latest" -Path "\\Contoso01\CM\Images\win10_latest.wim"
参数
-Confirm
提示你在运行 cmdlet 之前进行确认。
类型: | SwitchParameter |
别名: | cf |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Description
指定可选说明以帮助识别图像。 最大长度为 127 个字符。
类型: | 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
添加此参数时,站点将从多索引图像中提取单个索引图像。 然后,它将新图像放置在与原始图像相同的源文件夹中。
使用此选项可生成更小的映像文件,并加快脱机服务速度。 它还支持在应用软件更新后 为较小的映像文件优化映像服务的过程。
类型: | Int32 |
别名: | ImageIndex |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Name
指定 OS 映像的名称。 最大长度为 50 个字符。
类型: | String |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-Path
指定 OS 映像 WIM 文件的网络路径。 路径需要包含扩展名为 .wim
的 WIM 文件名。
类型: | String |
别名: | PackageSourcePath |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-Version
指定 OS 映像的可选版本。 此值用于内部版本控制,而不是操作系统版本。 最大长度为 32 个字符。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
类型: | SwitchParameter |
别名: | wi |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
输入
None
输出
IResultObject
备注
有关此返回对象及其属性的详细信息,请参阅 SMS_ImagePackage服务器 WMI 类。