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 的设备程序的名为 All Systems 的集合。 该命令指定开始日期和开始时间。 该命令包含一个描述性注释。 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 的集合。 该命令包含一个描述性注释。 该命令将 Available 指定为 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，客户端不会尝试从其他客户端下载。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CollectionName

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Comment

指定部署的注释。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DeploymentAvailableDateTime

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

Type:	DateTime
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeploymentAvailableDay

已过时。 使用 DeploymentAvailableDateTime。

Type:	DateTime
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeploymentAvailableTime

已过时。 请改为使用 DeploymentAvailableDateTime。

Type:	DateTime
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeploymentExpireDateTime

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

Type:	DateTime
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeploymentExpireDay

已过时。 请改为使用 DeploymentExpireDateTime。

Type:	DateTime
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeploymentExpireTime

已过时。 使用 DeploymentExpireDateTime。

Type:	DateTime
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeploymentStartDateTime

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

Type:	DateTime
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeploymentStartDay

已过时。 使用 DeploymentStartDateTime。

Type:	DateTime
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeploymentStartTime

已过时。 使用 DeploymentStartDateTime。

Type:	DateTime
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeployPurpose

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

• 可用
• 必需

Type:	DeployPurposeType
Accepted values:	Available, Required
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeviceProgram

指定设备程序。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-FastNetworkOption

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

• DownloadContentFromDistributionPointAndRunLocally
• RunProgramFromDistributionPoint

Type:	FastNetworkOptionType
Accepted values:	RunProgramFromDistributionPoint, DownloadContentFromDistributionPointAndRunLocally
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Package

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

Type:	IResultObject
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-PackageId

指定包的 ID。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PackageName

指定包的名称。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PersistOnWriteFilterDevice

指示是否为嵌入设备启用写入筛选器。 对于值 $True，设备在维护窗口期间提交更改。 此操作需要重新启动。 对于值 $False，设备会将更改保存在覆盖层中，并稍后提交这些更改。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Program

指定程序。

Type:	IResultObject
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-ProgramName

指定程序的名称。

Type:	String
Aliases:	StandardProgramName, DeviceProgramName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RecurUnit

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

• 天
• 工作时间
• 分钟

Type:	RecurUnitType
Accepted values:	Minutes, Hours, Days
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RecurValue

指定部署重复出现频繁。 此参数取决于 RecurUnit 参数中指定的单位类型。 如果单位为"小时"，则此值介于 1 到 23 之间;如果单位为"天"，则介于 1 和 31 之间;如果单位为"分钟数"，该值介于 1 和 59 之间。

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Rerun

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RerunBehavior

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

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

Type:	RerunBehaviorType
Accepted values:	NeverRerunDeployedProgram, AlwaysRetunProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RunFromSoftwareCenter

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

Type:	Boolean
Aliases:	AllowUsersRunIndependently
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Schedule

指定部署的计划对象。

Type:	IResultObject[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ScheduleEvent

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

• AsSoonAsPossible
• LogOff
• LogOn
• SendWakeUpPacket

Type:	ScheduleEventType
Accepted values:	AsSoonAsPossible, LogOn, LogOff
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SendWakeupPacket

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

Type:	Boolean
Position:	Named
Default value:	None
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
Accept pipeline input:	False
Accept wildcard characters:	False

-SoftwareInstallation

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-StandardProgram

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SystemRestart

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UseMeteredNetwork

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UseUtc

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UseUtcForAvailableSchedule

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UseUtcForExpireSchedule

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object

相关链接

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