New-CMApplicationGroupDeployment

模块:

ConfigurationManager

为应用程序组创建部署。

语法

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 指定部署分配或 截止时间。

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 作为此应用组部署的目标。

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

指定此部署是否可供用户安装，或是否要求在截止时间进行安装。

Type:	DeployPurposeType
Accepted values:	Available, Required
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

-ForceWildcardHandling

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-GenerateScomAlertOnFailure

设置此参数以 $true 在部署失败System Center 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, ApplicationGroupId
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

为应用组指定对象。 若要获取此对象，请使用 Get-CMApplicationGroup cmdlet。

Type:	IResultObject
Aliases:	ApplicationGroup
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-OverrideServiceWindow

设置此参数 $true 以在维护窗口之外安装应用组。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PersistOnWriteFilterDevice

使用此参数可处理嵌入设备Windows筛选器。 如果设置为 ，设备 $true 在截止时间或维护时段提交更改。 此操作需要重新启动。 如果将其设置为 $false ，设备会将更改保存到临时覆盖层，并稍后提交这些更改。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RebootOutsideServiceWindow

设置此参数 $true 以允许设备在维护窗口外重新启动。

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

-TimeBaseOn

指定要使用哪个时区：

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

Type:	TimeType
Accepted values:	LocalTime, Utc
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, ApplicationGroupName
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

IResultObject

备注

此 cmdlet 返回SMS_ApplicationGroupAssignment WMI 类对象。

相关链接

• Get-CMApplicationGroupDeployment
• Remove-CMApplicationGroupDeployment
• Set-CMApplicationGroupDeployment
• Get-CMApplicationGroup
• 创建应用程序组