Start-CMPackageDeployment

  • 参考
模块:
ConfigurationManager

(已弃用) 开始将软件包部署到 Configuration Manager 集合。

语法

Start-CMPackageDeployment
     [-AllowSharedContent <Boolean>]
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentAvailableDateTime <DateTime>]
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentExpireDateTime <DateTime>]
     [-DeploymentExpireDay <DateTime>]
     [-DeploymentExpireTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-FastNetworkOption <FastNetworkOptionType>]
     [-Package] <IResultObject>
     [-PassThru]
     [-PersistOnWriteFilterDevice <Boolean>]
     -ProgramName <String>
     [-RerunBehavior <RerunBehaviorType>]
     [-RunFromSoftwareCenter <Boolean>]
     [-Schedule <IResultObject[]>]
     [-ScheduleEvent <ScheduleEventType>]
     [-SendWakeupPacket <Boolean>]
     [-SlowNetworkOption <SlowNetworkOptionType>]
     [-SoftwareInstallation <Boolean>]
     [-StandardProgram]
     [-SystemRestart <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtcForAvailableSchedule <Boolean>]
     [-UseUtcForExpireSchedule <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMPackageDeployment
     [-AllowSharedContent <Boolean>]
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentAvailableDateTime <DateTime>]
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentExpireDateTime <DateTime>]
     [-DeploymentExpireDay <DateTime>]
     [-DeploymentExpireTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-FastNetworkOption <FastNetworkOptionType>]
     -PackageName <String>
     [-PassThru]
     [-PersistOnWriteFilterDevice <Boolean>]
     -ProgramName <String>
     [-RerunBehavior <RerunBehaviorType>]
     [-RunFromSoftwareCenter <Boolean>]
     [-Schedule <IResultObject[]>]
     [-ScheduleEvent <ScheduleEventType>]
     [-SendWakeupPacket <Boolean>]
     [-SlowNetworkOption <SlowNetworkOptionType>]
     [-SoftwareInstallation <Boolean>]
     [-StandardProgram]
     [-SystemRestart <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtcForAvailableSchedule <Boolean>]
     [-UseUtcForExpireSchedule <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMPackageDeployment
     [-AllowSharedContent <Boolean>]
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentAvailableDateTime <DateTime>]
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentExpireDateTime <DateTime>]
     [-DeploymentExpireDay <DateTime>]
     [-DeploymentExpireTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-FastNetworkOption <FastNetworkOptionType>]
     -PackageId <String>
     [-PassThru]
     [-PersistOnWriteFilterDevice <Boolean>]
     -ProgramName <String>
     [-RerunBehavior <RerunBehaviorType>]
     [-RunFromSoftwareCenter <Boolean>]
     [-Schedule <IResultObject[]>]
     [-ScheduleEvent <ScheduleEventType>]
     [-SendWakeupPacket <Boolean>]
     [-SlowNetworkOption <SlowNetworkOptionType>]
     [-SoftwareInstallation <Boolean>]
     [-StandardProgram]
     [-SystemRestart <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtcForAvailableSchedule <Boolean>]
     [-UseUtcForExpireSchedule <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMPackageDeployment
     [-AllowSharedContent <Boolean>]
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentAvailableDateTime <DateTime>]
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentExpireDateTime <DateTime>]
     [-DeploymentExpireDay <DateTime>]
     [-DeploymentExpireTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-FastNetworkOption <FastNetworkOptionType>]
     [-PassThru]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-Program] <IResultObject>
     [-RerunBehavior <RerunBehaviorType>]
     [-RunFromSoftwareCenter <Boolean>]
     [-Schedule <IResultObject[]>]
     [-ScheduleEvent <ScheduleEventType>]
     [-SendWakeupPacket <Boolean>]
     [-SlowNetworkOption <SlowNetworkOptionType>]
     [-SoftwareInstallation <Boolean>]
     [-StandardProgram]
     [-SystemRestart <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtcForAvailableSchedule <Boolean>]
     [-UseUtcForExpireSchedule <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMPackageDeployment
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentStartDateTime <DateTime>]
     [-DeploymentStartDay <DateTime>]
     [-DeploymentStartTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-DeviceProgram]
     -PackageName <String>
     [-PassThru]
     -ProgramName <String>
     [-RecurUnit <RecurUnitType>]
     [-RecurValue <Int32>]
     [-Rerun <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtc <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMPackageDeployment
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentStartDateTime <DateTime>]
     [-DeploymentStartDay <DateTime>]
     [-DeploymentStartTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-DeviceProgram]
     -PackageId <String>
     [-PassThru]
     -ProgramName <String>
     [-RecurUnit <RecurUnitType>]
     [-RecurValue <Int32>]
     [-Rerun <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtc <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMPackageDeployment
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentStartDateTime <DateTime>]
     [-DeploymentStartDay <DateTime>]
     [-DeploymentStartTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-DeviceProgram]
     [-Package] <IResultObject>
     [-PassThru]
     -ProgramName <String>
     [-RecurUnit <RecurUnitType>]
     [-RecurValue <Int32>]
     [-Rerun <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtc <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMPackageDeployment
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentStartDateTime <DateTime>]
     [-DeploymentStartDay <DateTime>]
     [-DeploymentStartTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-DeviceProgram]
     [-PassThru]
     [-Program] <IResultObject>
     [-RecurUnit <RecurUnitType>]
     [-RecurValue <Int32>]
     [-Rerun <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtc <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

说明

重要

[!注释] 不推荐使用此 cmdlet。 请改用 New-CMPackageDeployment 。

Start-CMPackageDeployment cmdlet 开始将指定的软件包部署到属于 Configuration Manager 集合的计算机。 可以选择包何时可用以及包部署何时过期。 可以指定 Configuration Manager 是只部署一次包还是重复部署包，以及当计算机安装失败时会发生什么情况。

注意

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

示例

示例 1：启动定期部署

PS XYZ:\> Start-CMPackageDeployment -CollectionName "All Systems" -DeviceProgramName "DPM" -PackageName "User State Migration Tool for Windows 8" -Comment "DPM for all systems." -DeploymentStartDay 2012/10/26 -DeploymentStartTime 12:12 -RecurUnit Days -RecurValue 7 -Rerun $True -UseMeteredNetwork $True -UseUtc $True

此命令开始将命名包部署到名为 DPM 的设备程序的名为“所有系统”的集合。 命令指定开始日期和开始时间。 命令包含描述性注释。 Rerun 参数的值为 $True 命令将递归值指定为 7，将递归单位指定为 Days，因此部署每七天重新运行一次。 部署使用按流量计费的网络。 部署使用 UTC 时间。

示例 2：为可用包启动定期部署

PS XYZ:\> Start-CMPackageDeployment -CollectionName "Western Computers" -DeviceProgramName "DPM" -PackageName "User State Migration Tool for Windows 8" -Comment "Deployment for Western office." -DeployPurpose Available -Rerun $True -UseUtc $True

此命令开始将命名包部署到名为 DPM 的设备程序的名为 Western Computers 的集合。 命令包含描述性注释。 命令指定“可用”作为 DeployPurpose，因此用户可以决定是否安装此软件。 Rerun 参数的值为 $True。 部署使用 UTC 时间。

示例 3：启动标准程序的部署

PS XYZ:\> Start-CMPackageDeployment -CollectionName "All Systems" -PackageName "User State Migration Tool for Windows 8" -StandardProgramName "SPM" AllowSharedContent $False

此命令开始将名为“Windows 8 用户状态迁移工具”的包部署到名为 SPM 的标准程序的“所有系统”集合。 命令不允许计算机使用共享内容。

参数

-AllowSharedContent

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

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

-CollectionName

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

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

-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

-DeploymentAvailableDay

已过时。 使用 DeploymentAvailableDateTime。

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

-DeploymentAvailableTime

已过时。 请改用 DeploymentAvailableDateTime 。

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

-DeploymentExpireDateTime

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

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

-DeploymentExpireDay

已过时。 请改用 DeploymentExpireDateTime 。

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

-DeploymentExpireTime

已过时。 使用 DeploymentExpireDateTime。

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

-DeploymentStartDateTime

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

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

-DeploymentStartDay

已过时。 使用 DeploymentStartDateTime。

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

-DeploymentStartTime

已过时。 使用 DeploymentStartDateTime。

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

-DeployPurpose

指定部署的用途。 此参数可接受的值为：

  • 可用
  • 必需
类型:DeployPurposeType
接受的值:Available, Required
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DeviceProgram

指定设备程序。

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

-DisableWildcardHandling

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

类型:SwitchParameter
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

-Package

指定包对象。 若要获取包对象，请使用 Get-CMPackage cmdlet。

类型:IResultObject
Position:0
默认值: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

-Program

指定程序。

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

-ProgramName

指定程序的名称。

类型:String
别名:StandardProgramName, DeviceProgramName
Position:Named
默认值:None
必需:True
接受管道输入: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, AlwaysRetunProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RunFromSoftwareCenter

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

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

-Schedule

指定部署的计划对象。

类型: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

-StandardProgram

指示部署包中的程序类型是标准程序。

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

-SystemRestart

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

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

-UseMeteredNetwork

指示是否允许客户端在截止时间后通过按流量计费的 Internet 连接下载内容，这可能会产生额外的费用。

类型: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