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 .

Тип:	Phase[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-BeginCondition

Укажите параметр для начала второго этапа развертывания после успешного выполнения первого этапа:

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

Тип:	BeginConditionType
Допустимые значения:	AfterPeriod, Manually
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Confirm

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

Тип:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CriteriaOption

Укажите параметр для выбора критериев успешного выполнения первого этапа:

Compliance: этот параметр совпадает со следующим параметром на странице Параметры мастера создания поэтапного развертывания в консоли: процент успешного развертывания. Укажите процентное значение с помощью параметра CriteriaValue .
Number: этот параметр совпадает со следующим параметром на странице Параметры мастера создания поэтапного развертывания в консоли: Количество устройств, успешно развернутых. Укажите количество устройств с помощью параметра CriteriaValue .

Тип:	CriteriaType
Допустимые значения:	Compliance, Number
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CriteriaValue

Это целочисленное значение зависит от значения, указанного в параметре CriteriaOption:

Compliance: укажите процент.
Number: укажите количество устройств.

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DaysAfterPreviousPhaseSuccess

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

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DeadlineUnit

Укажите тип крайнего срока. Используйте этот параметр с DeadlineValue.

Тип:	TimeUnitType
Допустимые значения:	Hours, Days, Weeks, Months
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DeadlineValue

Этот параметр используется только при указании AfterPeriod с помощью параметра InstallationChoice .

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

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Description

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

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DisableWildcardHandling

Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-FirstCollection

Укажите объект коллекции для первого этапа.

Тип:	IResultObject
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-FirstCollectionId

Укажите идентификатор коллекции для первого этапа.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-FirstCollectionName

Укажите имя коллекции для первого этапа.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ForceWildcardHandling

Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению. Это не рекомендуется. Его нельзя объединить с DisableWildcardHandling.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-InsertAtOrder

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

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-InstallationChoice

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

AsSoonAsPossible: этот параметр совпадает со следующим параметром на странице Параметры мастера создания поэтапного развертывания в консоли: установка требуется как можно скорее.
AfterPeriod: этот параметр совпадает со следующим параметром на странице Параметры мастера создания поэтапного развертывания в консоли: установка требуется по истечении этого периода времени. Если указать это значение, используйте DeadlineUnit и DeadlineValue , чтобы настроить период времени.

Тип:	InstallationChoiceType
Допустимые значения:	AsSoonAsPossible, AfterPeriod
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Name

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

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SecondCollection

Укажите объект коллекции для второго этапа.

Тип:	IResultObject
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SecondCollectionId

Укажите идентификатор коллекции для второго этапа.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SecondCollectionName

Укажите имя коллекции для второго этапа.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SoftwareUpdateGroup

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

Тип:	IResultObject
Position:	0
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-SoftwareUpdateGroupId

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

Тип:	String
Position:	0
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SoftwareUpdateGroupName

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

Тип:	String
Position:	0
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SoftwareUpdateIds

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

Тип:	String[]
Position:	0
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SoftwareUpdateNames

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

Тип:	String[]
Position:	0
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SoftwareUpdates

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

Тип:	IResultObject[]
Position:	0
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-ThrottlingDays

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

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-WhatIf

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

Тип:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

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

IResultObject

Поделиться через