New-CMApplicationGroupDeployment
为应用程序组创建部署。
语法
New-CMApplicationGroupDeployment
[-DeadlineDateTime <DateTime>]
[-DeployAction <DeployActionType>]
[-DeployPurpose <DeployPurposeType>]
[-EnableMomAlert <Boolean>]
[-GenerateScomAlertOnFailure <Boolean>]
[-InputObject] <IResultObject>
[-OverrideServiceWindow <Boolean>]
[-RebootOutsideServiceWindow <Boolean>]
[-TimeBaseOn <TimeType>]
[-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-CMApplicationGroupDeployment
[-DeadlineDateTime <DateTime>]
[-DeployAction <DeployActionType>]
[-DeployPurpose <DeployPurposeType>]
[-EnableMomAlert <Boolean>]
[-GenerateScomAlertOnFailure <Boolean>]
[-Id] <Int32>
[-OverrideServiceWindow <Boolean>]
[-RebootOutsideServiceWindow <Boolean>]
[-TimeBaseOn <TimeType>]
[-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-CMApplicationGroupDeployment
[-DeadlineDateTime <DateTime>]
[-DeployAction <DeployActionType>]
[-DeployPurpose <DeployPurposeType>]
[-EnableMomAlert <Boolean>]
[-GenerateScomAlertOnFailure <Boolean>]
[-Name] <String>
[-OverrideServiceWindow <Boolean>]
[-RebootOutsideServiceWindow <Boolean>]
[-TimeBaseOn <TimeType>]
[-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>] 说明
为应用程序组创建部署。 一个应用组包含多个应用程序，用户可将软件中心中的组视为单个实体。 有关详细信息，请参阅 创建应用程序组。
需要先创建应用组，然后才能部署应用组。 然后，可以将它作为单个部署部署到用户或设备集合。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。
示例
示例 1
$collection = Get-CMCollection -Name "co1"
$distributionPointName = "dp1.contoso.com"
New-CMApplicationGroupDeployment -Id 16777536 -Collection $collection -DistributionPointName $distributionPointName -DistributeContent参数
-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 作为此应用组部署的目标。
| 类型: | 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
指定此部署是可供用户安装，还是需要在截止时间安装。
| 类型: | DeployPurposeType |
| 接受的值: | Available, Required |
| 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 |
-ForceWildcardHandling
此参数处理通配符，并可能导致意外行为， (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-GenerateScomAlertOnFailure
将此参数设置为 以 $true 在部署失败时生成 System Center Operations Manager 警报。
| 类型: | Boolean |
| 别名: | RaiseMomAlertsOnFailure |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Id
指定要部署的应用程序组的 ID。
| 类型: | Int32 |
| 别名: | CIId, CI_ID, ApplicationGroupId |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-InputObject
为应用组指定对象。 若要获取此对象，请使用 Get-CMApplicationGroup cmdlet。
| 类型: | IResultObject |
| 别名: | ApplicationGroup |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-Name
指定此应用组部署的名称。
| 类型: | String |
| 别名: | LocalizedDisplayName, ApplicationGroupName |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-OverrideServiceWindow
将此参数设置为 以 $true 在维护时段外安装应用组。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PersistOnWriteFilterDevice
使用此参数处理 Windows Embedded 设备的写入筛选器。 如果将其设置为 $true，设备会在截止时间或维护时段内提交更改。 此操作需要重启。 如果将其设置为 $false，设备会将更改保存到临时覆盖层，并在以后提交更改。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-RebootOutsideServiceWindow
将此参数设置为 以 $true 允许设备在维护时段外重新启动。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SendWakeupPacket
指示是否在部署开始前将唤醒数据包发送到计算机。 如果此值为 $True，则 Configuration Manager 将计算机从睡眠状态唤醒。 如果此值为 $False，则不会将计算机从睡眠状态唤醒。 对于要唤醒的计算机，请先配置 LAN 唤醒。
| 类型: | Boolean |
| 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 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
输出
IResultObject
备注
此 cmdlet 返回SMS_ApplicationGroupAssignment WMI 类对象。