New-CMOperatingSystemImageUpdateSchedule

创建操作系统映像更新计划。

语法

New-CMOperatingSystemImageUpdateSchedule
   [-ContinueOnError <Boolean>]
   [-CustomSchedule <DateTime>]
   -InputObject <IResultObject>
   [-RemoveSupersededUpdates <Boolean>]
   -SoftwareUpdate <IResultObject[]>
   [-UpdateDistributionPoint <Boolean>]
   [-Utc <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMOperatingSystemImageUpdateSchedule
   [-ContinueOnError <Boolean>]
   [-CustomSchedule <DateTime>]
   [-RemoveSupersededUpdates <Boolean>]
   -SoftwareUpdate <IResultObject[]>
   [-UpdateDistributionPoint <Boolean>]
   [-Utc <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMOperatingSystemImageUpdateSchedule
   [-ContinueOnError <Boolean>]
   [-CustomSchedule <DateTime>]
   [-RemoveSupersededUpdates <Boolean>]
   -SoftwareUpdate <IResultObject[]>
   [-UpdateDistributionPoint <Boolean>]
   [-Utc <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMOperatingSystemImageUpdateSchedule
   [-ContinueOnError <Boolean>]
   [-CustomSchedule <DateTime>]
   [-RemoveSupersededUpdates <Boolean>]
   -SoftwareUpdate <IResultObject[]>
   [-UpdateDistributionPoint <Boolean>]
   [-Utc <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMOperatingSystemImageUpdateSchedule
   [-ContinueOnError <Boolean>]
   -Id <String>
   [-RemoveSupersededUpdates <Boolean>]
   [-RunNow]
   -SoftwareUpdate <IResultObject[]>
   [-UpdateDistributionPoint <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMOperatingSystemImageUpdateSchedule
   [-ContinueOnError <Boolean>]
   -InputObject <IResultObject>
   [-RemoveSupersededUpdates <Boolean>]
   [-RunNow]
   -SoftwareUpdate <IResultObject[]>
   [-UpdateDistributionPoint <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMOperatingSystemImageUpdateSchedule
   [-ContinueOnError <Boolean>]
   -Name <String>
   [-RemoveSupersededUpdates <Boolean>]
   [-RunNow]
   -SoftwareUpdate <IResultObject[]>
   [-UpdateDistributionPoint <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMOperatingSystemImageUpdateSchedule
   [-ContinueOnError <Boolean>]
   [-RemoveSupersededUpdates <Boolean>]
   [-RunNow]
   -SoftwareUpdate <IResultObject[]>
   [-UpdateDistributionPoint <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

New-CMOperatingSystemImageUpdateSchedule cmdlet 创建操作系统映像更新计划。

注意

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

示例

示例 1:创建操作系统映像更新计划

PS ABC:\> $Win10Image = Get-CMOperatingSystemImage -Name "Windows 10 Enterprise"
PS ABC:\> $Win10SU = Get-CMSoftwareUpdate -UpdateGroupName "Win10SUgroup01"
PS ABC:\> New-CMOperatingSystemImageUpdateSchedule -Name $Win10Image.Name -SoftwareUpdate $Win10SU -RunNow -ContinueOnError $True

第一个命令获取名为 Windows 10 企业版的操作系统映像对象,并将对象存储在 $Win 10Image 变量中。

第二个命令获取名为 Win10SUgroup01 的更新组的软件更新对象,并将对象存储在 $Win 10SU 变量中。

最后一个命令创建操作系统映像更新计划,以使用存储在 $Win 10SU 中的更新更新名为 Windows 10 企业版的操作系统映像。 更新将立即运行,并且即使遇到错误,也会继续应用更新。

参数

-Confirm

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

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

-ContinueOnError

指示是否应在出现错误时将软件更新应用于映像。

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

-CustomSchedule

指定软件更新应用于操作系统映像的日期和时间。

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

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-Id

指定操作系统映像的 ID。

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

-InputObject

指定操作系统映像对象。 若要获取操作系统映像对象,请使用 Get-CMOperatingSystemImage cmdlet。

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

-Name

指定操作系统映像的名称。

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

-RemoveSupersededUpdates

{{ Fill RemoveSupersededUpdates Description }}

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

-RunNow

指示更新应立即运行。

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

-SoftwareUpdate

指定软件更新对象的数组。 若要获取软件更新对象,请使用 Get-CMSoftwareUpdate cmdlet。

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

-UpdateDistributionPoint

指示在应用软件更新后是否更新分发点上的操作系统映像。

类型:Boolean
别名:UpdateDistributionPointsWithImage, UpdateDistributionPoints
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Utc

指示是否使用 UTC 时间。

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

-WhatIf

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

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

IResultObject