New-CMApplicationAutoPhasedDeployment
使用此 cmdlet 通过生成两个设置相同的阶段来创建应用程序的分阶段部署。
语法
New-CMApplicationAutoPhasedDeployment
[-Application] <IResultObject>
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-FirstCollection <IResultObject>]
[-FirstCollectionId <String>]
[-FirstCollectionName <String>]
[-InstallationChoice <InstallationChoiceType>]
[-SecondCollection <IResultObject>]
[-SecondCollectionId <String>]
[-SecondCollectionName <String>]
[-ThrottlingDays <Int32>]
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMApplicationAutoPhasedDeployment
[-ApplicationId] <String>
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-FirstCollection <IResultObject>]
[-FirstCollectionId <String>]
[-FirstCollectionName <String>]
[-InstallationChoice <InstallationChoiceType>]
[-SecondCollection <IResultObject>]
[-SecondCollectionId <String>]
[-SecondCollectionName <String>]
[-ThrottlingDays <Int32>]
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMApplicationAutoPhasedDeployment
[-ApplicationName] <String>
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-FirstCollection <IResultObject>]
[-FirstCollectionId <String>]
[-FirstCollectionName <String>]
[-InstallationChoice <InstallationChoiceType>]
[-SecondCollection <IResultObject>]
[-SecondCollectionId <String>]
[-SecondCollectionName <String>]
[-ThrottlingDays <Int32>]
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 说明
使用此 cmdlet 通过生成两个设置相同的阶段来创建应用程序的分阶段部署。 当您选择"自动创建默认的两阶段部署"选项时****，此 cmdlet 的行为与在应用程序上创建分阶段部署向导相同。
备注
创建分阶段部署之前，请确保将应用程序的内容分发到分发点。
示例
示例 1：按应用名称创建部署
此示例为应用程序myApp创建名为myDPName的新应用程序分阶段部署。
New-CMApplicationAutoPhasedDeployment -ApplicationName "myApp" -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"示例 2：通过输入应用对象创建部署
此示例为通过管道的应用程序对象创建名为 myPDName 的新应用程序分阶段部署。
$myApp | New-CMApplicationAutoPhasedDeployment -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"参数
-Application
为分阶段部署指定应用程序对象。
| Type: | IResultObject |
| Position: | 1 |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ApplicationId
指定分阶段部署的应用程序 ID。
| Type: | String |
| Aliases: | CIId, CI_ID |
| Position: | 1 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationName
指定分阶段部署的应用程序名称。
| Type: | String |
| Aliases: | ApplicationLocalizedDisplayName |
| Position: | 1 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BeginCondition
指定在第一阶段成功后开始部署的第二阶段的选项：
AfterPeriod：此参数与控制台中"创建分阶段部署"向导的设置页上的以下**** 设置相同：在延迟期后自动开始此阶段 (以天 **) 。 ** 如果指定此值，请使用 DaysAfterPreviousPhaseSuccess 配置时间段。Manually：此参数与控制台中"创建分阶段部署"设置**** 的"部署"页上的以下**** 设置相同：手动开始第二阶段部署。
| Type: | BeginConditionType |
| Accepted values: | AfterPeriod, Manually |
| 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 |
-CriteriaOption
指定一个选项以选择第一阶段的成功条件：
Compliance：此参数与控制台中"创建分阶段部署"设置**** 的"部署成功百分比"**** 页上的以下设置相同。 使用 CriteriaValue 参数指定百分比值。Number：此参数与控制台中"创建分阶段部署"向导**** 的"设置"页上的以下**** 设置相同：已成功部署的设备数。 使用 CriteriaValue 参数指定设备数。
| Type: | CriteriaType |
| Accepted values: | Compliance, Number |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CriteriaValue
此整数值取决于为 CriteriaOption 指定的值：
Compliance：指定百分比Number：指定设备数
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DaysAfterPreviousPhaseSuccess
为开始第二阶段的第一阶段成功后的天数指定整数值。 此参数与控制台中"创建分阶段部署"向导的设置页上的以下**** 设置相同：在延迟期 (（以天) ）后自动开始此阶段。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeadlineUnit
指定截止时间的类型。 此参数与 DeadlineValue 一起使用。
| Type: | TimeUnitType |
| Accepted values: | Hours, Days, Weeks, Months |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeadlineValue
此参数仅在使用 AfterPeriod InstallationChoice 参数指定时使用。
指定截止时间时间段的整数值。 使用DeadlineUnit参数指定时间段的类型 Hours Days Weeks ：、、、。 Months 此参数与控制台中"创建分阶段部署"向导**** 的"设置"页上的以下**** 设置相同：在此时间段后需要安装。
| Type: | Int32 |
| 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 |
-FirstCollection
指定第一阶段的集合对象。
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FirstCollectionId
指定第一阶段的集合 ID。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FirstCollectionName
指定第一阶段的集合名称。
| Type: | String |
| 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 |
-InstallationChoice
指定与软件可用时间相关的行为选项：
AsSoonAsPossible：此参数与控制台中"创建分阶段部署"向导**** 的 设置 页上的**** 以下设置相同：尽快需要安装。AfterPeriod：此参数与控制台中"创建分阶段部署"向导**** 的"设置"页上的以下**** 设置相同：在此时间段后需要安装。 如果指定此值，请使用 DeadlineUnit 和 DeadlineValue 配置时间段。
| Type: | InstallationChoiceType |
| Accepted values: | AsSoonAsPossible, AfterPeriod |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SecondCollection
指定第二阶段的集合对象。
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SecondCollectionId
指定第二阶段的集合 ID。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SecondCollectionName
指定第二阶段的集合名称。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ThrottlingDays
指定一个整数值，用于逐步提供该软件的天数。 此参数与控制台中"创建分阶段部署"向导的设置页上的**** 以下设置相同：逐步使此软件在此时段内可用， (天数) 。
| Type: | Int32 |
| 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 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-描述
指定应用程序分阶段部署的说明。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
输入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
输出
IResultObject