New-CMSoftwareUpdateAutoPhasedDeployment

Ссылка

Модуль:: ConfigurationManager

Используйте этот комлет для создания поэтапного развертывания обновлений программного обеспечения, создав два этапа с одинаковыми настройками.

Синтаксис

New-CMSoftwareUpdateAutoPhasedDeployment
   [-SoftwareUpdateGroup] <IResultObject>
   [-AddPhases <Phase[]>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InsertAtOrder <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMSoftwareUpdateAutoPhasedDeployment
   [-SoftwareUpdateGroupId] <String>
   [-AddPhases <Phase[]>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InsertAtOrder <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMSoftwareUpdateAutoPhasedDeployment
   [-SoftwareUpdateGroupName] <String>
   [-AddPhases <Phase[]>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InsertAtOrder <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMSoftwareUpdateAutoPhasedDeployment
   [-SoftwareUpdateIds] <String[]>
   [-AddPhases <Phase[]>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InsertAtOrder <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMSoftwareUpdateAutoPhasedDeployment
   [-SoftwareUpdateNames] <String[]>
   [-AddPhases <Phase[]>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InsertAtOrder <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMSoftwareUpdateAutoPhasedDeployment
   [-SoftwareUpdates] <IResultObject[]>
   [-AddPhases <Phase[]>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InsertAtOrder <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Используйте этот комлет для создания поэтапного развертывания обновлений программного обеспечения, создав два этапа с одинаковыми настройками. Поведение этого комлета такое же, **** как и у мастера создания поэтапного развертывания в обновлении программного обеспечения, при выборе параметра автоматического создания развертывания двух этапов по умолчанию.

Примечание

Перед созданием поэтапного развертывания обязательно раздайте содержимое обновления программного обеспечения в точку распространения.

Примеры

Пример 1. Создание развертывания по имени обновления

В этом примере создается поэтапное развертывание нового обновления программного обеспечения с именем myDPName для обновления программного обеспечения myUpdateName.

New-CMSoftwareUpdateAutoPhasedDeployment -SoftwareUpdateName "myUpdateName" -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 для объекта обновления программного обеспечения по трубам.

$myUpdate | New-CMSoftwareUpdateAutoPhasedDeployment -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"

Параметры

-AddPhases

Этот комлет автоматически создает два этапа для указанных двух коллекций. С помощью этого параметра можно также добавить дополнительные этапы. Укажите массив этапов. Для создания этапов используйте new-CMSoftwareUpdatePhase.

Type:	Phase[]
Position:	Named
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

Перед запуском командлет запросит подтверждение.

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.

Укажите значение integer на период времени для крайнего срока. Используйте параметр DeadlineUnit, чтобы указать тип периода: Hours , , , Days Weeks Months . Этот параметр такой же, как и следующий параметр **** на странице Параметры мастера поэтапного развертывания на консоли. Установка требуется после этого периода времени.

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

-Description

Укажите описание поэтапного развертывания обновления программного обеспечения.

Type:	String
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

-InsertAtOrder

Если используется параметр AddPhases, используйте этот параметр, чтобы определить, где в порядке фаз вставить дополнительные фазы. Укажите целый ряд с номером заказа.

Type:	Int32
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

-Name

Укажите имя поэтапного развертывания приложения.

Type:	String
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

-SoftwareUpdateGroup

Укажите объект для группы обновления программного обеспечения.

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

-SoftwareUpdateGroupId

Укажите группу обновления программного обеспечения по ID.

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

-SoftwareUpdateGroupName

Укажите группу обновления программного обеспечения по имени.

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

-SoftwareUpdateIds

Укажите массив ИД обновления программного обеспечения.

Type:	String[]
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SoftwareUpdateNames

Укажите массив имен обновлений программного обеспечения.

Type:	String[]
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SoftwareUpdates

Укажите массив объектов обновления программного обеспечения.

Type:	IResultObject[]
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-ThrottlingDays

Укажите значение в несколько дней, чтобы постепенно сделать это программное обеспечение доступным. Этот параметр такой же, как и следующий параметр на **** странице Параметры мастера создания поэтапного развертывания на консоли: постепенно сделать это программное обеспечение доступным в течение этого периода времени (в днях).

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

-WhatIf

Показывает, что произойдет при запуске этого командлета. Этот комдлет не работает.

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

Входные данные

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Выходные данные

IResultObject