Set-CMApplicationGroupDeployment

模块:

ConfigurationManager

配置应用程序组的部署。

语法

Set-CMApplicationGroupDeployment
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-TimeBaseOn <TimeType>]
   -InputObject <IResultObject>
   [-AvailableDateTime <DateTime>]
   [-UserNotification <UserNotificationType>]
   [-EnableMomAlert <Boolean>]
   [-RaiseMomAlertsOnFailure <Boolean>]
   [-OverrideServiceWindow <Boolean>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationGroupDeployment
   -ApplicationGroudId <String>
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-TimeBaseOn <TimeType>]
   [-AvailableDateTime <DateTime>]
   [-UserNotification <UserNotificationType>]
   [-EnableMomAlert <Boolean>]
   [-RaiseMomAlertsOnFailure <Boolean>]
   [-OverrideServiceWindow <Boolean>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationGroupDeployment
   -ApplicationGroupName <String>
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-TimeBaseOn <TimeType>]
   [-AvailableDateTime <DateTime>]
   [-UserNotification <UserNotificationType>]
   [-EnableMomAlert <Boolean>]
   [-RaiseMomAlertsOnFailure <Boolean>]
   [-OverrideServiceWindow <Boolean>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

配置应用程序组的部署。 一个应用组包含多个应用程序，用户可将软件中心中的组视为单个实体。 有关详细信息，请参阅 创建应用程序组。

注意

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

示例

示例 1

$collection = Get-CMCollection -Name "co1"

Set-CMApplicationGroupDeployment -ApplicationGroupName "appGroupTest" -Collection $collection -Comment "modify comment"

参数

-ApplicationGroudId

指定要配置的应用组的 ID。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationGroupName

指定要配置的应用组的名称。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-AvailableDateTime

指定此部署可用的DateTime 对象。 若要获取此对象，请使用 Get-Date 内置 cmdlet。

使用 DeadlineDateTime 指定部署分配或 截止时间。

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

-Collection

指定集合对象作为此应用组部署的目标。 若要获取此对象，请使用 Get-CMCollection cmdlet。

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

-CollectionId

指定集合 ID 作为此应用组部署的目标。

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

-CollectionName

指定集合名称作为此应用组部署的目标。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-Comment

为应用组部署指定可选注释。

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

-Confirm

提示你在运行 cmdlet 之前进行确认。

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

-DeadlineDateTime

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

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

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

-DisableWildcardHandling

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

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

-EnableMomAlert

将此参数设置为 可 $true 为此部署启用 System Center Operations Manager 维护模式。

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

-ForceWildcardHandling

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

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

-InputObject

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

Type:	IResultObject
Aliases:	ApplicationGroup, DeploymentSummary, ApplicationGroupAssignment
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-OverrideServiceWindow

将此参数设置为 以 $true 在维护时段外安装应用组。

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

-PassThru

添加此参数可返回一个对象，该对象表示正在使用的项。 默认情况下，此 cmdlet 可能不会生成任何输出。

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

-PersistOnWriteFilterDevice

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

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

-RaiseMomAlertsOnFailure

将此参数设置为 以 $true 在部署失败时生成 System Center Operations Manager 警报。

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

-RebootOutsideServiceWindow

将此参数设置为 以 $true 允许设备在维护时段外重新启动。

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

-TimeBaseOn

指定要使用的时区：

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

Type:	TimeType
Accepted values:	LocalTime, Utc
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UserNotification

使用此参数指定此部署的用户体验：

• DisplayAll：在软件中心显示并显示所有通知
• DisplaySoftwareCenterOnly：在软件中心显示，并且仅显示计算机重启通知。
• HideAll：在软件中心和所有通知中隐藏

Type:	UserNotificationType
Accepted values:	DisplayAll, DisplaySoftwareCenterOnly, HideAll
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

IResultObject

IResultObject

备注

此 cmdlet 返回 SMS_ApplicationGroupAssignment WMI 类对象。

相关链接

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