Set-CMApplicationDeployment

模块:

ConfigurationManager

配置应用程序部署

语法

Set-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   [-AutoCloseExecutable <Boolean>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-CreateAlertBaseOnPercentFailure <Boolean>]
   [-CreateAlertBaseOnPercentSuccess <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   -InputObject <IResultObject>
   [-OverrideServiceWindow <Boolean>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RaiseMomAlertsOnFailure <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-RequireApproval <Boolean>]
   [-SendWakeUpPacket <Boolean>]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UseMeteredNetwork <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   -ApplicationId <String>
   [-AutoCloseExecutable <Boolean>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-CreateAlertBaseOnPercentFailure <Boolean>]
   [-CreateAlertBaseOnPercentSuccess <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   [-OverrideServiceWindow <Boolean>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RaiseMomAlertsOnFailure <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-RequireApproval <Boolean>]
   [-SendWakeUpPacket <Boolean>]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UseMeteredNetwork <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   -ApplicationName <String>
   [-AutoCloseExecutable <Boolean>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-CreateAlertBaseOnPercentFailure <Boolean>]
   [-CreateAlertBaseOnPercentSuccess <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   [-OverrideServiceWindow <Boolean>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RaiseMomAlertsOnFailure <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-RequireApproval <Boolean>]
   [-SendWakeUpPacket <Boolean>]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UseMeteredNetwork <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

Set-CMApplicationDeployment cmdlet 修改 Configuration Manager 中应用程序部署的属性。 有关详细信息，请参阅 使用 Configuration Manager 部署应用程序。

若要指定要修改的应用程序部署，请指定集合名称和应用程序。 可以按名称或 ID 指定应用程序。 还可以使用 Get-CMApplication cmdlet 获取要修改的应用程序。

注意

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

示例

示例 1：修改应用程序部署的可用性和截止时间

Set-CMApplicationDeployment -ApplicationName "Track System 2011" -CollectionName "All Users" -AvailableDateTime (Get-Date) -DeadlineDateTime $(Get-Date).AddDays(30)

此命令为名为“所有用户”的集合修改名为 Track System 2011 的应用程序的应用程序部署。 命令指定应用程序可用的当前日期。 它还配置未来 30 天的部署截止时间。

参数

-AllowRepairApp

在为应用程序创建部署时，使用此参数配置修复应用程序选项。

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

-ApplicationId

指定应用程序的 ID。

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

-ApplicationName

指定应用程序的名称。

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

-AutoCloseExecutable

从版本 2107 开始，将此参数 $true 设置为 ，以便为安装行为启用应用程序部署设置。 然后使用 Add-CMDeploymentTypeInstallBehavior cmdlet 添加可执行文件，以检查是否未运行安装成功。

将此参数设置为 $false 以在以下情况下禁用此选项：

• 使用 Remove-CMDeploymentTypeInstallBehavior cmdlet 删除所有可执行文件时
• 你不希望部署检查正在运行的可执行文件。

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

-AvailableDateTime

指定此部署可用的DateTime 对象。 若要获取此对象，请使用 Get-Date 内置 cmdlet。

使用 DeadlineDateTime 指定部署分配或 截止时间。

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

-Collection

指定应用程序部署到的集合对象。 若要获取此对象，请使用 Get-CMCollection cmdlet。

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

-CollectionId

指定应用程序部署到的集合的 ID。 例如，"SMS00004"。

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

-CollectionName

指定应用程序部署到的集合的名称。

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

-CreateAlertBaseOnPercentFailure

指示是否为一定百分比无法部署的应用程序创建警报。 若要指定百分比值，请使用 FailParameterValue 参数。

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

-CreateAlertBaseOnPercentSuccess

指示是否为成功部署的一定百分比的应用程序创建警报。 若要指定百分比值，请使用 SuccessParameterValue 参数。

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

-DeadlineDateTime

指定分配此部署的时间的 DateTime 对象，也称为 截止时间。 若要获取此对象，请使用 Get-Date 内置 cmdlet。

使用 -AvailableDateTime 指定部署 何时可用。

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

-DisableWildcardHandling

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

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

-EnableMomAlert

将此参数设置为 可 $true 为此部署启用 System Center Operations Manager 维护模式。

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

-EnableSoftDeadline

将此参数设置为 以 $true 启用延迟强制。

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

-FailParameterValue

指定导致警报的应用程序安装失败的百分比。 指定一个介于 1 到 100 的整数。 若要启用此警报，请将 CreatAlertBaseOnPercentFailure 参数设置为 $True。

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

-ForceWildcardHandling

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

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

-InputObject

指定要配置的应用程序部署对象。 若要获取此对象，请使用 Get-CMApplicationDeployment cmdlet。

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

-OverrideServiceWindow

指示部署是否进行，即使计划于维护时段之外也是如此。 维护时段是用于计算机维护和更新的指定时间段。 如果此值为 $True，则即使计划的时间超出维护时段，Configuration Manager 也会部署应用程序。 如果此值为 $False，则 Configuration Manager 不会在窗口外部署应用程序。 它会等待，直到可以在可用窗口中部署。

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

-PassThru

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

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

-PersistOnWriteFilterDevice

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

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

-PostponeDateTime

将 CreateAlertBaseOnPercentSuccess 设置为 $true时，使用此参数指定 DateTime 对象。 在此日期之后，当阈值低于 SuccessParameterValue 时，Configuration Manager 会创建部署警报。

若要获取此对象，请使用 Get-Date 内置 cmdlet。

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

-PreDeploy

指示是否将应用程序预部署到用户的主设备。

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

-RaiseMomAlertsOnFailure

指示在客户端无法安装应用程序时是否创建 Operations Manager 警报。

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

-RebootOutsideServiceWindow

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

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

-ReplaceToastNotificationWithDialog

当客户端上提供所需的软件时，将此参数设置为 $true 以将默认 Toast 通知替换为对话框窗口。 默认情况下，它为 false。 有关详细信息，请参阅 将 Toast 通知替换为对话框窗口。

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

-RequireApproval

如果将此参数设置为 $true，则管理员必须在设备上批准此应用程序的请求。

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

-SendWakeUpPacket

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

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

-SuccessParameterValue

指定导致警报的成功应用程序安装百分比。 指定 0 到 99 的整数。 若要启用此警报，请将 CreateAlertBaseOnPercentSuccess 参数设置为 $True。

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

-TimeBaseOn

指定要使用的时区：

• LocalTime：使用本地时间。
• UTC：使用协调世界时 (UTC) 。

类型:	TimeType
接受的值:	LocalTime, Utc
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

输出

IResultObject

备注

有关此返回对象及其属性的详细信息，请参阅 SMS_ApplicationAssignment服务器 WMI 类。

相关链接

• Get-CMApplication
• Get-CMApplicationDeployment
• New-CMApplicationDeployment
• Remove-CMApplicationDeployment
• 使用 Configuration Manager 部署应用程序