New-CMTaskSequenceAutoPhasedDeployment
Используйте этот командлет для создания поэтапного развертывания для последовательности задач путем создания двух этапов с одинаковыми параметрами.
Синтаксис
New-CMTaskSequenceAutoPhasedDeployment
[-TaskSequence] <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-CMTaskSequenceAutoPhasedDeployment
[-TaskSequenceId] <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-CMTaskSequenceAutoPhasedDeployment
[-TaskSequenceName] <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>] Описание
Используйте этот командлет для создания поэтапного развертывания для последовательности задач путем создания двух этапов с одинаковыми параметрами. Поведение этого командлета совпадает с поведением мастера создания поэтапного развертывания в последовательности задач при выборе параметра Автоматическое создание двухэтапного развертывания по умолчанию.
Примечание.
Перед созданием поэтапного развертывания обязательно распределите содержимое последовательности задач в точку распространения.
Примеры
Пример 1. Создание развертывания по имени последовательности задач
В этом примере создается новое поэтапное развертывание последовательности задач с именем myDPName для последовательности задач myTaskSequenceName.
New-CMTaskSequenceAutoPhasedDeployment -TaskSequenceName "myTaskSequenceName" -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 для объекта последовательности задач с каналом.
$myTS | New-CMTaskSequenceAutoPhasedDeployment -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-CMTaskSequencePhase .
| Тип: | 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 |
-TaskSequence
Укажите объект последовательности задач.
| Тип: | IResultObject |
| Position: | 0 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-TaskSequenceId
Укажите последовательность задач по идентификатору.
| Тип: | String |
| Aliases: | TaskSequencePackageId |
| Position: | 0 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-TaskSequenceName
Укажите последовательность задач по имени.
| Тип: | String |
| Position: | 0 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | 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
Выходные данные
IResultObject