Set-CMPackageDeployment
更改定义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此命令对名为“所有系统”的集合、名为 User State Migration Tool for Windows 8 的包和名为 SPM 的标准程序指定的部署进行更改。 命令指定部署可用的日期和时间。 命令还指定部署不对可用性计划使用 UTC。 计划是指本地时区。
参数
-AllowFallback
{{ Fill AllowFallback Description }}
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowSharedContent
指示客户端是否使用共享内容。 如果此值$True，则客户端会尝试从下载该内容的其他客户端下载内容。 如果此值$False，则客户端不会尝试从其他客户端下载。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Collection
指定用户集合。
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CollectionId
指定设备或用户集合的 ID。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CollectionName
指定设备或用户集合的 ID。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Comment
指定部署的注释。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeploymentAvailableDateTime
指定部署变为可用的日期和时间（作为 DateTime 对象）。 若要获取 DateTime 对象，请使用 Get-Date cmdlet。
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeploymentExpireDateTime
指定部署过期的日期和时间（作为 DateTime 对象）。 若要获取 DateTime 对象，请使用 Get-Date cmdlet。
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeploymentStartDateTime
指定部署开始的日期和时间（作为 DateTime 对象）。 若要获取 DateTime 对象，请使用 Get-Date cmdlet。
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeviceProgramName
指定设备程序的名称。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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 |
-EnableExpireSchedule
指示是否启用计划以使部署过期。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FastNetworkOption
指定快速网络上的客户端行为。 此参数可接受的值为：
- DownloadContentFromDistributionPointAndRunLocally
- RunProgramFromDistributionPoint
| Type: | FastNetworkOptionType |
| Accepted values: | RunProgramFromDistributionPoint, DownloadContentFromDistributionPointAndRunLocally |
| 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 |
-InputObject
指定包对象。
| Type: | IResultObject |
| Aliases: | Package, DeploymentSummary, Advertisement |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PackageId
指定包的 ID。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PackageName
指定包的名称。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
返回当前工作对象。 默认情况下，此 cmdlet 不生成任何输出。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PersistOnWriteFilterDevice
指示是否为嵌入式设备启用写入筛选器。 对于值 $True，设备在维护时段内提交更改。 此操作需要重启。 对于值 $False，设备会将更改保存在覆盖中，并在以后提交更改。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RecurUnit
指定定期部署的单位。 此参数可接受的值为：
- 天
- 工作时间
- 分钟
| Type: | RecurUnitType |
| Accepted values: | Minutes, Hours, Days |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RecurValue
指定部署的重复频率。 此参数取决于 RecurUnit 参数中指定的单位类型。 如果单位为“小时”，则此值可以介于 1 到 23 之间;如果单位为“天”，则此值介于 1 到 31 之间;如果单位为“分钟”，则此值介于 1 到 59 之间。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Rerun
指示部署是否重新运行。 如果此值$True，则部署会再次针对 RerunBehavior 参数中指定的客户端运行。 如果此值$False，则部署不会再次运行。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RerunBehavior
指定部署在客户端上重新运行的方式。 此参数可接受的值为：
- AlwaysRerunProgram。 即使部署成功，仍按计划重新运行。 可以将此值用于定期部署。
- NeverRerunDeployedProgram。 即使部署失败或文件已更改，也不会重新运行。
- RerunIfFailedPreviousAttempt。 如果部署在上一次尝试中失败，则按计划重新运行。
- RerunIfSucceededOnpreviousAttempt。 仅当上一次尝试成功时重新运行。 可以将此值用于依赖于上一个更新的更新。
| Type: | RerunBehaviorType |
| Accepted values: | NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunFromSoftwareCenter
指示是否从软件中心运行。
| Type: | Boolean |
| Aliases: | AllowUsersRunIndependently |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Schedule
指定 CMSchedule 对象。 计划指定维护时段的发生时间。 若要创建 CMSchedule 对象，请使用 New-CMSchedule cmdlet。
| Type: | IResultObject[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ScheduleEvent
指定计划事件类型的数组。 此参数可接受的值为：
- AsSoonAsPossible
- 注销
- 登录
- SendWakeUpPacket
| Type: | ScheduleEventType[] |
| Accepted values: | AsSoonAsPossible, LogOn, LogOff |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SendWakeupPacket
指示是否在部署开始前将唤醒数据包发送到计算机。 如果此值$True，Configuration Manager从睡眠状态唤醒计算机。 如果此值$False，则不会将计算机从睡眠状态唤醒。 要唤醒计算机，必须首先配置 LAN 唤醒。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SlowNetworkOption
指定Configuration Manager如何在慢速网络中部署此包。 此参数可接受的值为：
- DoNotRunProgram
- DownloadContentFromDistributionPointAndLocally
- RunProgramFromDistributionPoint
| Type: | SlowNetworkOptionType |
| Accepted values: | DoNotRunProgram, DownloadContentFromDistributionPointAndLocally, RunProgramFromDistributionPoint |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SoftwareInstallation
指示是否在维护时段外安装已部署的软件。 维护时段是用于计算机维护和更新的指定时间段。 如果此值$True，则即使计划超出维护时段，Configuration Manager也会按计划安装软件。 如果此值$False，Configuration Manager不会在任何窗口外安装已部署的软件，而是等待维护时段。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StandardProgramName
指定标准程序名称。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SystemRestart
指示系统是否在维护时段外重新启动。 维护时段是用于计算机维护和更新的指定时间段。 如果此值是$True，则会进行任何所需的重启，而不考虑维护时段。 如果此值$False，则计算机不会在维护时段外重启。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseMeteredNetwork
{{ Fill UseMeteredNetwork Description }}
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseRecurrencePattern
指示是否使用重复模式。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseUtc
指示是否使用协调世界时 (UTC) ，也称为格林威治标准时间。 如果此值$True，Configuration Manager对此部署使用 UTC。 如果此值$False，Configuration Manager使用本地时间。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseUtcForAvailableSchedule
指示是否对可用计划使用 UTC。 如果此值$True，Configuration Manager使用 UTC。 如果此值$False，Configuration Manager使用本地时间。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseUtcForExpireSchedule
指示是否对过期计划使用 UTC。 如果此值$True，Configuration Manager使用 UTC。 如果此值$False，Configuration Manager使用本地时间。
| Type: | Boolean |
| 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 |
输入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
输出
System.Object
相关链接
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈