Start-CMApplicationDeployment

(弃用) 在 Configuration Manager 中启动应用程序部署。

语法

Start-CMApplicationDeployment
     [-ApprovalRequired <Boolean>]
     [-AvailableDate <DateTime>]
     [-AvailableDateTime <DateTime>]
     [-AvailableTime <DateTime>]
     -CollectionName <String>
     [-Comment <String>]
     [-DeadlineDate <DateTime>]
     [-DeadlineDateTime <DateTime>]
     [-DeadlineTime <DateTime>]
     [-DeployAction <DeployActionType>]
     [-DeployPurpose <DeployPurposeType>]
     [-EnableMomAlert <Boolean>]
     [-FailParameterValue <Int32>]
     [-GenerateScomAlertOnFailure <Boolean>]
     [-InputObject] <IResultObject>
     [-OverrideServiceWindow <Boolean>]
     [-PassThru]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-PostponeDate <DateTime>]
     [-PostponeDateTime <DateTime>]
     [-PostponeTime <DateTime>]
     [-PreDeploy <Boolean>]
     [-RebootOutsideServiceWindow <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-SuccessParameterValue <Int32>]
     [-TimeBaseOn <TimeType>]
     [-UpdateSupersedence <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UserNotification <UserNotificationType>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMApplicationDeployment
     [-ApprovalRequired <Boolean>]
     [-AvailableDate <DateTime>]
     [-AvailableDateTime <DateTime>]
     [-AvailableTime <DateTime>]
     -CollectionName <String>
     [-Comment <String>]
     [-DeadlineDate <DateTime>]
     [-DeadlineDateTime <DateTime>]
     [-DeadlineTime <DateTime>]
     [-DeployAction <DeployActionType>]
     [-DeployPurpose <DeployPurposeType>]
     [-EnableMomAlert <Boolean>]
     [-FailParameterValue <Int32>]
     [-GenerateScomAlertOnFailure <Boolean>]
     [-Id] <Int32>
     [-OverrideServiceWindow <Boolean>]
     [-PassThru]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-PostponeDate <DateTime>]
     [-PostponeDateTime <DateTime>]
     [-PostponeTime <DateTime>]
     [-PreDeploy <Boolean>]
     [-RebootOutsideServiceWindow <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-SuccessParameterValue <Int32>]
     [-TimeBaseOn <TimeType>]
     [-UpdateSupersedence <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UserNotification <UserNotificationType>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMApplicationDeployment
     [-ApprovalRequired <Boolean>]
     [-AvailableDate <DateTime>]
     [-AvailableDateTime <DateTime>]
     [-AvailableTime <DateTime>]
     -CollectionName <String>
     [-Comment <String>]
     [-DeadlineDate <DateTime>]
     [-DeadlineDateTime <DateTime>]
     [-DeadlineTime <DateTime>]
     [-DeployAction <DeployActionType>]
     [-DeployPurpose <DeployPurposeType>]
     [-EnableMomAlert <Boolean>]
     [-FailParameterValue <Int32>]
     [-GenerateScomAlertOnFailure <Boolean>]
     [-Name] <String>
     [-OverrideServiceWindow <Boolean>]
     [-PassThru]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-PostponeDate <DateTime>]
     [-PostponeDateTime <DateTime>]
     [-PostponeTime <DateTime>]
     [-PreDeploy <Boolean>]
     [-RebootOutsideServiceWindow <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-SuccessParameterValue <Int32>]
     [-TimeBaseOn <TimeType>]
     [-UpdateSupersedence <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UserNotification <UserNotificationType>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

说明

重要

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

Start-CMApplicationDeployment cmdlet 启动应用程序部署。

注意

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

示例

示例 1:启动应用程序部署

PS XYZ:\> Start-CMApplicationDeployment -CollectionName "All Users" -Name "7zip" -AvaliableDate 2012/10/1 -AvaliableTime 12:45 -Comment "test" -DeadlineDate 2013/10/23 -DeadlineTime 21:12 -DeployAction Uninstall -EnableMomAlert $True -FailParameterValue 40 -OverrideServiceWindow $True -PersistOnWriteFilterDevice $False -PostponeDate 2014/2/8 -PostponeTime 11:11 -PreDeploy $True -RaiseMomAlertsOnFailure $True -RebootOutsideServiceWindow $True -SendWakeUpPacket $True -SuccessParameterValue 30 -UseMeteredNetwork $True -UserNotification DisplaySoftwareCenterOnly

此命令启动名为 7zip 的应用程序部署。

参数

-ApprovalRequired

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

-AvailableDate

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

-AvailableDateTime

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

-AvailableTime

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

-CollectionName

指定要部署此应用程序的目标集合。

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

-DeadlineDate

指定安装应用程序的日期。 如果未安装应用程序,则自动安装将执行安装。

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

-DeadlineDateTime

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

-DeadlineTime

指定安装应用程序的时间。 如果未安装应用程序,则自动安装将执行安装。

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

-DeployAction

指定部署的操作。 有效值包含:

  • 安装。 安装应用程序。

  • 卸载。 卸载应用程序。

类型:DeployActionType
接受的值:Install, Uninstall
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DeployPurpose

指定部署的用途。

有效值包含:

  • 可用。 如果目标集合是设备集合,则应用程序可在软件中心使用。 如果目标集合是用户集合,则应用程序在目录网站中可用。

  • 必填。 在截止时间过后进行安装。

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

-DisableWildcardHandling

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

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

-EnableMomAlert

指示是否启用 Operations Manager 维护模式。

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

-FailParameterValue

指定一个值,该值在超出时生成部署警报。

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

-ForceWildcardHandling

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

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

-GenerateScomAlertOnFailure

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

-Id

指定 ID 数组。

类型:Int32
别名:CIId, CI_ID
Position:0
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-InputObject

指定应用程序部署对象。

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

-Name

指定应用程序部署的名称数组。

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

-OverrideServiceWindow

指示应用程序安装是否在维护时段外进行。

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

-PassThru

添加此参数可返回一个对象,该对象表示正在使用的项。 默认情况下,此 cmdlet 可能不会生成任何输出。

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

-PersistOnWriteFilterDevice

指示是在截止时间还是在维护时段内在 Windows Embedded 设备上提交更改。 否则,更改将写入覆盖层并稍后提交。

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

-PostponeDate

指定创建警报的日期。

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

-PostponeDateTime

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

-PostponeTime

指定创建警报的时间。

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

-PreDeploy

指示是否在安装前将软件复制到设备。 若要使用此参数,请将 DeployPurpose 参数设置为 Required。

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

-RebootOutsideServiceWindow

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

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

-SendWakeupPacket

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

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

-SuccessParameterValue

指定在创建警报之前必须超过阈值的值。

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

-TimeBaseOn

指定要使用的时区。

有效值包含:

  • LocalTime。 使用本地时间。
  • UTC。 使用协调世界时 (UTC) ,也称为格林威治标准时间。
类型:TimeType
接受的值:LocalTime, Utc
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-UpdateSupersedence

{{ Fill UpdateSupersedence Description }}

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

-UseMeteredNetwork

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

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

-UserNotification

指定用户通知类型。

有效值包含:

  • DisplayAll。 在软件中心显示并显示所有通知。

  • DisplaySoftwareCenterOnly。 在软件中心显示,仅显示计算机重启通知。

  • HideAll。 不在软件中心显示,也不显示通知。

类型:UserNotificationType
接受的值:DisplayAll, DisplaySoftwareCenterOnly, HideAll
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WhatIf

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

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object