New-CMApplicationDeployment

模块:

ConfigurationManager

创建应用程序部署。

语法

New-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   [-ApprovalRequired <Boolean>]
   [-AutoCloseExecutable <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-DeployAction <DeployActionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-DisableContentDependencyDetection]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-InputObject] <IResultObject>
   [-OverrideServiceWindow <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-Simulation]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UpdateSupersedence <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   [-ApprovalRequired <Boolean>]
   [-AutoCloseExecutable <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-DeployAction <DeployActionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-DisableContentDependencyDetection]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-Id] <Int32>
   [-OverrideServiceWindow <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-Simulation]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UpdateSupersedence <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   [-ApprovalRequired <Boolean>]
   [-AutoCloseExecutable <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-DeployAction <DeployActionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-DisableContentDependencyDetection]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-Name] <String>
   [-OverrideServiceWindow <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-Simulation]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UpdateSupersedence <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

New-CMApplicationDeployment cmdlet 创建应用程序部署。 有关详细信息，请参阅 使用 Configuration Manager 部署应用程序。

注意

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

示例

示例 1：安装应用程序

此命令创建 Visual Studio 2019 到集合 开发人员工作站的新部署。 它安装应用，并且是必需的。 可用日期和截止时间都是过去相同的时间，因此客户端一收到此策略，就会安装应用。

New-CMApplicationDeployment -Name "Visual Studio 2019" -AvailableDateTime '01/01/2020 00:00:00' -CollectionName 'Developers Workstation' -DeadlineDateTime '01/01/2020 00:00:00' -DeployAction Install -DeployPurpose Required

参数

-AllowRepairApp

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

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

-ApprovalRequired

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

类型:	Boolean
别名:	AppRequiresApproval
Position:	Named
默认值:	None
必需:	False
接受管道输入:	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
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DeadlineDateTime

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

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

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

-DeployAction

指定部署操作以安装或卸载应用程序。 如果竞争部署面向同一设备， 则安装 操作优先。

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

-DeployPurpose

指定部署目的：

• Available：用户在软件中心看到应用程序。 他们可以按需安装。

• Required：客户端根据你设置的计划自动安装应用。 如果未隐藏应用程序，用户可以跟踪其部署状态。 他们还可以使用软件中心在截止时间之前安装应用程序。

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

-DisableContentDependencyDetection

添加此参数以不自动分发相关应用的内容。

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

-DisableWildcardHandling

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

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

-DistributeCollectionName

站点将内容分发到与此集合名称关联的分发点。

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

-DistributeContent

如果需要先分发应用内容，请添加此参数。

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

-DistributionPointGroupName

若要分发应用程序内容，请指定分发点组的名称。

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

-DistributionPointName

若要分发应用程序内容，请指定分发点的名称。

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

-GenerateScomAlertOnFailure

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

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

-Id

指定要部署的应用程序的 ID。

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

-InputObject

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

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

-Name

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

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

-OverrideServiceWindow

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

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

-RebootOutsideServiceWindow

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

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

-ReplaceToastNotificationWithDialog

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

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

-SendWakeupPacket

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

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

-Simulation

添加此参数以创建部署模拟。 有关详细信息，请参阅 使用 Configuration Manager 模拟应用程序部署。

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

-UpdateSupersedence

对于可用部署，请使用此参数指定安装截止时间，以升级安装了被取代应用程序的用户或设备。 使用 DeadlineDateTime 指定特定时间，否则为 在 AvailableDateTime 之后尽快指定。

类型:	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
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object

相关链接

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