Set-CMPackageDeployment

模块:

ConfigurationManager

更改定义 Configuration Manager 如何部署软件包的值。

语法

Set-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-Comment <String>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-EnableExpireSchedule <Boolean>]
   [-FastNetworkOption <FastNetworkOptionType>]
   -InputObject <IResultObject>
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   -StandardProgramName <String>
   [-SystemRestart <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-Comment <String>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-EnableExpireSchedule <Boolean>]
   [-FastNetworkOption <FastNetworkOptionType>]
   -PackageName <String>
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   -StandardProgramName <String>
   [-SystemRestart <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-Comment <String>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-EnableExpireSchedule <Boolean>]
   [-FastNetworkOption <FastNetworkOptionType>]
   -PackageId <String>
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   -StandardProgramName <String>
   [-SystemRestart <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMPackageDeployment
   [-Comment <String>]
   [-DeploymentStartDateTime <DateTime>]
   -DeviceProgramName <String>
   -PackageName <String>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseRecurrencePattern <Boolean>]
   [-UseUtc <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMPackageDeployment
   [-Comment <String>]
   [-DeploymentStartDateTime <DateTime>]
   -DeviceProgramName <String>
   -PackageId <String>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseRecurrencePattern <Boolean>]
   [-UseUtc <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMPackageDeployment
   [-Comment <String>]
   [-DeploymentStartDateTime <DateTime>]
   -DeviceProgramName <String>
   -InputObject <IResultObject>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseRecurrencePattern <Boolean>]
   [-UseUtc <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

Set-CMPackageDeployment cmdlet 更改定义 Configuration Manager 如何部署软件包的值。 部署包括设备或用户的集合、要部署的包以及设备程序名称或标准程序名称。 若要指定要修改的部署，请指定集合名称、包和程序名称。 可以按名称或 ID 指定包，也可以使用 Get-CMPackage cmdlet 获取包对象。

注意

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

示例

示例 1：设置重复周期属性

PS XYZ:\> Set-CMPackageDeployment -CollectionName "All Systems" -DeviceProgramName "DPM" -PackageName "User State Migration Tool for Windows 8" -RecurUnit Hours -RecurValue 7 -UseRecurrencePattern $True

此命令对名为“所有系统”的集合、名为 DPM 的设备程序以及名为“Windows 8 的用户状态迁移工具”的包指定的部署进行更改。 命令将 UseRecurrencePattern 参数设置为 $True 值。 命令指定一个递归单位“小时”和一个递归值 7。 因此，部署每 7 小时重复一次。

示例 2：设置可用性日期和时间

PS XYZ:\> Set-CMPackageDeployment -CollectionName "All Systems" -PackageName "User State Migration Tool for Windows 8" -StandardProgramName "SPM" -DeploymentAvailableDay 2012/10/18 -DeploymentAvailableTime 15:41 -UseUtcForAvailableSchedule $False

此命令对名为“所有系统”的集合、名为 Windows 8 的用户状态迁移工具的包和名为 SPM 的标准程序指定的部署进行更改。 命令指定部署可用的日期和时间。 命令还指定部署不对可用性计划使用 UTC。 计划是指本地时区。

参数

-AllowFallback

{{ Fill AllowFallback Description }}

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

-AllowSharedContent

指示客户端是否使用共享内容。 如果此值$True，则客户端会尝试从下载该内容的其他客户端下载内容。 如果此值$False，则客户端不会尝试从其他客户端下载。

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

-Collection

指定用户集合。

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

-CollectionId

指定设备或用户集合的 ID。

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

-CollectionName

指定设备或用户集合的 ID。

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

-Comment

指定部署的注释。

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

-Confirm

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

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

-DeploymentAvailableDateTime

指定部署变为可用的日期和时间，作为 DateTime 对象。 若要获取 DateTime 对象，请使用 Get-Date cmdlet。

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

-DeploymentExpireDateTime

指定部署过期的日期和时间（作为 DateTime 对象）。 若要获取 DateTime 对象，请使用 Get-Date cmdlet。

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

-DeploymentStartDateTime

指定部署开始的日期和时间（作为 DateTime 对象）。 若要获取 DateTime 对象，请使用 Get-Date cmdlet。

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

-DeviceProgramName

指定设备程序的名称。

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

-DisableWildcardHandling

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

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

-EnableExpireSchedule

指示是否启用计划以使部署过期。

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

-FastNetworkOption

指定快速网络上的客户端行为。 此参数可接受的值为：

• DownloadContentFromDistributionPointAndRunLocally
• RunProgramFromDistributionPoint

类型:	FastNetworkOptionType
接受的值:	RunProgramFromDistributionPoint, DownloadContentFromDistributionPointAndRunLocally
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ForceWildcardHandling

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

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

-InputObject

指定包对象。

类型:	IResultObject
别名:	Package, DeploymentSummary, Advertisement
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-PackageId

指定包的 ID。

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

-PackageName

指定包的名称。

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

-PassThru

返回当前工作对象。 默认情况下，此 cmdlet 不生成任何输出。

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

-PersistOnWriteFilterDevice

指示是否为嵌入式设备启用写入筛选器。 对于值 $True，设备在维护时段内提交更改。 此操作需要重启。 对于值 $False，设备会将更改保存在覆盖中，并在以后提交更改。

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

-RecurUnit

指定定期部署的单位。 此参数可接受的值为：

• 天
• 小时
• 分钟

类型:	RecurUnitType
接受的值:	Minutes, Hours, Days
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RecurValue

指定部署的重复频率。 此参数取决于 RecurUnit 参数中指定的单位类型。 如果单位为“小时”，则此值可以介于 1 到 23 之间;如果单位为“天”，则此值介于 1 到 31 之间;如果单位为“分钟”，则此值介于 1 到 59 之间。

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

-Rerun

指示部署是否重新运行。 如果此值$True，则部署会再次针对 RerunBehavior 参数中指定的客户端运行。 如果此值$False，则部署不会再次运行。

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

-RerunBehavior

指定部署在客户端上重新运行的方式。 此参数可接受的值为：

• AlwaysRerunProgram。 即使部署成功，仍按计划重新运行。 可以将此值用于定期部署。
• NeverRerunDeployedProgram。 即使部署失败或文件已更改，也不会重新运行。
• RerunIfFailedPreviousAttempt。 如果部署在上一次尝试中失败，则按计划重新运行。
• RerunIfSucceededOnpreviousAttempt。 仅当上一次尝试成功时重新运行。 可以将此值用于依赖于上一个更新的更新。

类型:	RerunBehaviorType
接受的值:	NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RunFromSoftwareCenter

指示是否从软件中心运行。

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

-Schedule

指定 CMSchedule 对象。 计划指定维护时段的发生时间。 若要创建 CMSchedule 对象，请使用 New-CMSchedule cmdlet。

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

-ScheduleEvent

指定计划事件类型的数组。 此参数可接受的值为：

• AsSoonAsPossible
• 注销
• LogOn
• SendWakeUpPacket

类型:	ScheduleEventType[]
接受的值:	AsSoonAsPossible, LogOn, LogOff
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SendWakeupPacket

指示是否在部署开始前将唤醒数据包发送到计算机。 如果此值$True，则 Configuration Manager 会从睡眠状态唤醒计算机。 如果此值$False，则不会将计算机从睡眠状态唤醒。 要唤醒计算机，必须首先配置 LAN 唤醒。

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

-SlowNetworkOption

指定 Configuration Manager 如何在慢速网络中部署此包。 此参数可接受的值为：

• DoNotRunProgram
• DownloadContentFromDistributionPointAndLocally
• RunProgramFromDistributionPoint

类型:	SlowNetworkOptionType
接受的值:	DoNotRunProgram, DownloadContentFromDistributionPointAndLocally, RunProgramFromDistributionPoint
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SoftwareInstallation

指示是否在维护时段外安装已部署的软件。 维护时段是用于计算机维护和更新的指定时间段。 如果此值$True，则即使计划超出维护时段，Configuration Manager 也会根据计划安装软件。 如果此值$False，则 Configuration Manager 不会在任何窗口外安装已部署的软件，而是等待维护时段。

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

-StandardProgramName

指定标准程序名称。

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

-SystemRestart

指示系统是否在维护时段外重新启动。 维护时段是用于计算机维护和更新的指定时间段。 如果此值是$True，则会进行任何所需的重启，而不考虑维护时段。 如果此值$False，则计算机不会在维护时段外重启。

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

-UseMeteredNetwork

{{ Fill UseMeteredNetwork Description }}

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

-UseRecurrencePattern

指示是否使用重复模式。

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

-UseUtc

指示是否使用协调世界时 (UTC) ，也称为格林威治标准时间。 如果此值$True，则 Configuration Manager 对此部署使用 UTC。 如果此值$False，则 Configuration Manager 将使用本地时间。

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

-UseUtcForAvailableSchedule

指示是否对可用计划使用 UTC。 如果此值$True，则 Configuration Manager 使用 UTC。 如果此值$False，则 Configuration Manager 将使用本地时间。

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

-UseUtcForExpireSchedule

指示是否对过期计划使用 UTC。 如果此值$True，则 Configuration Manager 使用 UTC。 如果此值$False，则 Configuration Manager 将使用本地时间。

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

-WhatIf

显示在 cmdlet 运行时发生的情况。 此 cmdlet 未运行。

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object

相关链接

• New-CMPackageDeployment
• Get-CMPackageDeployment
• Get-CMPackageDeploymentStatus
• Remove-CMPackageDeployment
• Get-CMPackage