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