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

类型:	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 类对象。

反馈

此页面是否有帮助？