New-CMApplicationDeployment
创建应用程序部署。
语法
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
在创建应用程序的部署时,使用此参数配置修复应用程序选项。
Type: | Boolean |
Aliases: | AllowUserRepairApplication |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApprovalRequired
如果此参数设置为 $true
,管理员必须在设备上批准此应用程序的请求。
Type: | Boolean |
Aliases: | AppRequiresApproval |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoCloseExecutable
从版本 2107 开始,设置此参数以 $true
启用安装行为的应用程序部署设置。 然后,使用 Add-CMDeploymentTypeInstallBehavior cmdlet 添加可执行文件,以检查安装是否运行成功。
设置此参数 $false
以在下列情况下禁用此选项:
- 使用 Remove-CMDeploymentTypeInstallBehavior cmdlet 删除所有可执行文件时
- 不希望部署检查是否运行可执行文件。
Type: | Boolean |
Aliases: | AutoCloseExeOnInstallBehavior |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AvailableDateTime
指定此部署何时可用的 DateTime 对象。 若要获取此对象,请使用 Get-Date 内置 cmdlet。
使用 DeadlineDateTime 指定部署分配或 截止时间。
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Collection
指定应用程序部署到的集合对象。 若要获取此对象,请使用 Get-CMCollection cmdlet。
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionId
指定将此应用程序部署到的集合的 ID。 例如,"SMS00004"
。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
指定将此应用程序部署到的集合的名称。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-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: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineDateTime
指定分配 此 部署的日期时间对象,也称为截止 时间。 若要获取此对象,请使用 Get-Date 内置 cmdlet。
使用 -AvailableDateTime 指定部署何时 可用。
Type: | DateTime |
Aliases: | SupersedenceDeadlineDateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeployAction
指定部署操作,以安装或卸载应用程序。 如果竞争部署面向同一设备, 则安装 操作优先。
Type: | DeployActionType |
Accepted values: | Install, Uninstall |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeployPurpose
指定部署目的:
Available
:用户在软件中心看到应用程序。 他们可以按需安装它。Required
:客户端根据你设置的计划自动安装应用。 如果应用程序未隐藏,用户可以跟踪其部署状态。 他们还可使用软件中心在截止时间之前安装应用程序。
Type: | DeployPurposeType |
Accepted values: | Available, Required |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableContentDependencyDetection
添加此参数,以不自动分配从属应用的内容。
Type: | SwitchParameter |
Aliases: | DisableDetectAssociatedContentDependencies |
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 |
-DistributeCollectionName
网站将内容分发到与此集合名称关联的分发点。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DistributeContent
如果需要先分发应用内容,请添加此参数。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DistributionPointGroupName
若要分发应用程序内容,请指定分发点组的名称。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DistributionPointName
若要分发应用程序内容,请指定分发点的名称。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableMomAlert
设置此参数 $true
以为此部署System Center Operations Manager 维护模式。
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableSoftDeadline
设置此参数 $true
以启用延迟强制执行。
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FailParameterValue
指定导致警报的失败应用程序安装的百分比。
指定从 1 到 100 的整数。
若要启用此警报,将 CreatAlertBaseOnPercentFailure 参数设置为 $True
。
Type: | Int32 |
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 |
-GenerateScomAlertOnFailure
指示客户端无法安装应用程序时是否创建 Operations Manager 警报。
Type: | Boolean |
Aliases: | RaiseMomAlertsOnFailure |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
指定要部署的应用程序的 ID。
Type: | Int32 |
Aliases: | CIId, CI_ID, ApplicationId |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
指定要部署的应用程序对象。 若要获取此对象,请使用 Get-CMApplication cmdlet。
Type: | IResultObject |
Aliases: | Application |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-OverrideServiceWindow
指示是否进行部署,即使计划在维护时段之外。
维护窗口是一个指定时间段,用于计算机维护和更新。
如果此值为 ,Configuration Manager 将部署应用程序,即使计划的时间 $True
超出维护时段。
如果此值为 $False
,Configuration Manager 不会在窗口外部署应用程序。 它一直等待,直到可以在可用窗口中部署。
Type: | Boolean |
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 |
-PostponeDateTime
将 CreateAlertBaseOnPercentSuccess 设置为 时,使用此参数 $true
指定 DateTime 对象。 当阈值在此日期之后低于 SuccessParameterValue 时,Configuration Manager 将创建部署警报。
若要获取此对象,请使用 Get-Date 内置 cmdlet。
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PreDeploy
指示是否将应用程序预部署到用户的主设备。
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RebootOutsideServiceWindow
指示计算机是否在维护窗口外重新启动。
维护窗口是一个指定时间段,用于计算机维护和更新。
如果此值为 $True
,则执行任何所需的重启,而不考虑维护窗口。
如果此值为 $False
,则计算机不会在维护窗口外重新启动。
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReplaceToastNotificationWithDialog
当客户端上提供所需软件时,请将此参数设置为 $true
,以将默认 Toast 通知替换为对话框窗口。 默认情况下为 false。 有关详细信息,请参阅将 Toast 通知替换为对话框窗口。
Type: | Boolean |
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 |
-Simulation
添加此参数以创建部署模拟。 有关详细信息,请参阅使用 Configuration Manager 模拟应用程序部署。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SuccessParameterValue
指定导致警报的应用程序安装成功所占的百分比。
指定从 0 到 99 的整数。
若要启用此警报,将 CreateAlertBaseOnPercentSuccess 参数 设置为 $True
。
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeBaseOn
指定使用哪个时区:
LocalTime
:使用本地时间。UTC
:使用协调世界时 (UTC) 。
Type: | TimeType |
Accepted values: | LocalTime, Utc |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpdateSupersedence
对于可用部署,使用此参数指定升级安装了取代应用程序的用户或设备的安装截止时间。 使用 DeadlineDateTime 指定特定时间,否则它尽快在 AvailableDateTime 之后。
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 |
-UserNotification
指定用户通知的类型。
DisplayAll
:在软件中心中显示,并显示所有通知。DisplaySoftwareCenterOnly
:在软件中心中显示,并且仅显示计算机重新启动的通知。HideAll
:在软件中心和所有通知中隐藏。
Type: | UserNotificationType |
Accepted values: | DisplayAll, DisplaySoftwareCenterOnly, HideAll |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不运行。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-名称
指定要部署的应用程序的名称。
Type: | String |
Aliases: | LocalizedDisplayName, ApplicationName |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
输入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
输出
System.Object