New-CMOperatingSystemInstaller
创建 OS 升级包。
语法
New-CMOperatingSystemInstaller
[-Description <String>]
[-Name <String>]
[-Index <Int32>]
-Path <String>
[-Version <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 说明
使用此 cmdlet 将 OS 升级包添加到 Configuration Manager 站点。 Configuration Manager 中的 OS 升级包包含用于升级计算机上现有 OS 的 Windows 安装程序源文件。 有关详细信息，请参阅 使用 Configuration Manager 管理 OS 升级包。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。
示例
示例 1：添加 OS 升级包
此命令添加名为 Windows 10 最新 版的 OS 升级包，并指定安装源文件的网络路径。
New-CMOperatingSystemInstaller -Name "Windows 10 latest" -Path "\\Contoso01\CM\Win10latest"参数
-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 |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Path
指定 OS 升级包源文件的网络路径。 安装源文件包含用于安装 OS 的 setup.exe 和其他文件和文件夹。
| 类型: | 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_OperatingSystemInstallPackage服务器 WMI 类。