New-CMTaskSequencePhase
Используйте этот командлет для создания этапа развертывания для последовательности задач.
Синтаксис
New-CMTaskSequencePhase
[-AllowFallback <Boolean>]
[-AllowRemoteDP <Boolean>]
[-AllowSystemRestart <Boolean>]
[-BeginCondition <BeginConditionType>]
[-Collection] <IResultObject>
[-Comments <String>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-DeploymentOption <DeploymentOptionType>]
[-InstallationChoice <InstallationChoiceType>]
-PhaseName <String>
[-PreDownload <Boolean>]
[-SoftwareInstallation <Boolean>]
[-ThrottlingDays <Int32>]
[-UserNotification <UserNotificationType>]
[-WriteFilterCommit <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMTaskSequencePhase
[-AllowFallback <Boolean>]
[-AllowRemoteDP <Boolean>]
[-AllowSystemRestart <Boolean>]
[-BeginCondition <BeginConditionType>]
[-CollectionId] <String>
[-Comments <String>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-DeploymentOption <DeploymentOptionType>]
[-InstallationChoice <InstallationChoiceType>]
-PhaseName <String>
[-PreDownload <Boolean>]
[-SoftwareInstallation <Boolean>]
[-ThrottlingDays <Int32>]
[-UserNotification <UserNotificationType>]
[-WriteFilterCommit <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMTaskSequencePhase
[-AllowFallback <Boolean>]
[-AllowRemoteDP <Boolean>]
[-AllowSystemRestart <Boolean>]
[-BeginCondition <BeginConditionType>]
[-CollectionName] <String>
[-Comments <String>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-DeploymentOption <DeploymentOptionType>]
[-InstallationChoice <InstallationChoiceType>]
-PhaseName <String>
[-PreDownload <Boolean>]
[-SoftwareInstallation <Boolean>]
[-ThrottlingDays <Int32>]
[-UserNotification <UserNotificationType>]
[-WriteFilterCommit <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Используйте этот командлет для создания этапа развертывания для последовательности задач.
Примеры
Пример 1. Создание этапа последовательности задач
В этом примере создается этап последовательности задач с именем MyTSPhase для коллекции MyCollection.
New-CMTaskSequencePhase -CollectionName "MyCollection" -PhaseName "MyTSPhase" -UserNotification DisplayAll -AllowRemoteDP $true
Параметры
-AllowFallback
Этот параметр совпадает со следующим параметром на странице Точки распространениямастера добавления этапа в консоли: Разрешить клиентам использовать точки распространения из группы границ сайта по умолчанию.
| Тип: | Boolean |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-AllowRemoteDP
Этот параметр совпадает со следующим параметром на странице Точки распространениямастера добавления этапа в консоли: если локальная точка распространения недоступна, используйте удаленную точку распространения.
| Тип: | Boolean |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-AllowSystemRestart
Этот параметр совпадает со следующим параметром на странице Взаимодействие с пользователеммастера добавления этапа в консоли: перезагрузка системы (если требуется для завершения установки). Этот параметр применяется по достижении крайнего срока установки, чтобы разрешить выполнение этого действия за пределами периода обслуживания.
| Тип: | Boolean |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-BeginCondition
Укажите параметр для начала этого этапа развертывания после успешного выполнения предыдущего этапа:
AfterPeriod: этот параметр совпадает со следующим параметром на странице Параметры фазымастера добавления этапов в консоли: автоматически начинается этот этап после периода отсрочки (в днях). Если указать это значение, используйте DaysAfterPreviousPhaseSuccess , чтобы настроить период времени.Manually: этот параметр совпадает со следующим параметром на странице Параметры фазымастера добавления этапов в консоли: вручную начните этот этап развертывания.
| Тип: | BeginConditionType |
| Допустимые значения: | AfterPeriod, Manually |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Collection
Указание объекта для целевой коллекции
| Тип: | IResultObject |
| Position: | 0 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-CollectionId
Укажите целевую коллекцию по идентификатору.
| Тип: | String |
| Position: | 0 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-CollectionName
Укажите целевую коллекцию по имени.
| Тип: | String |
| Position: | 0 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Comments
Укажите необязательные примечания для этого этапа. Максимальная длина — 512 символов.
| Тип: | String |
| 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 |
-DeploymentOption
Этот параметр совпадает со следующим параметром на странице Точки распространениямастера добавления этапа в консоли: выберите параметр развертывания, используемый, когда клиент использует точку распространения из соседней группы границ или группы границ сайта по умолчанию. Он принимает следующие значения:
-
DownloadContentLocallyWhenNeededByRunningTaskSequence: скачивание содержимого локально, если это необходимо для выполнения последовательности задач. -
DownloadAllContentLocallyBeforeStartingTaskSequence: скачивание всего содержимого локально перед запуском последовательности задач
| Тип: | DeploymentOptionType |
| Допустимые значения: | DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DisableWildcardHandling
Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ForceWildcardHandling
Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению. Это не рекомендуется. Его нельзя объединить с DisableWildcardHandling.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-InstallationChoice
Укажите параметр для поведения относительно того, когда программное обеспечение становится доступным:
AsSoonAsPossible: этот параметр совпадает со следующим параметром на странице Параметры фазымастера добавления этапов в консоли: установка требуется как можно скорее.AfterPeriod: этот параметр совпадает со следующим параметром на странице Параметры фазымастера добавления этапов в консоли: установка требуется по истечении этого периода времени. Если указать это значение, используйте DeadlineUnit и DeadlineValue , чтобы настроить период времени.
| Тип: | InstallationChoiceType |
| Допустимые значения: | AsSoonAsPossible, AfterPeriod |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-PhaseName
Укажите имя этапа.
| Тип: | String |
| Aliases: | Name |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-PreDownload
Этот параметр совпадает со следующим параметром на странице Общиемастера добавления этапа в консоли: Предварительное скачивание содержимого для этой последовательности задач.
| Тип: | Boolean |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-SoftwareInstallation
Этот параметр совпадает со следующим параметром на странице Взаимодействие с пользователеммастера добавления этапа в консоли: Установка программного обеспечения. Этот параметр применяется по достижении крайнего срока установки, чтобы разрешить выполнение этого действия за пределами периода обслуживания.
| Тип: | Boolean |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ThrottlingDays
Укажите целочисленное значение для количества дней, чтобы постепенно сделать это программное обеспечение доступным. Этот параметр совпадает со следующим параметром на странице Параметры фазыв мастере добавления этапов в консоли: постепенно делайте это программное обеспечение доступным в течение этого периода времени (в днях).
| Тип: | Int32 |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-UserNotification
Этот параметр совпадает со следующим параметром на странице Взаимодействие с пользователеммастера добавления этапа в консоли: укажите параметр взаимодействия с пользователем для этого развертывания со следующими значениями:
-
DisplayAll: отображается в Центре программного обеспечения и отображаются все уведомления. -
HideAll: скрытие в центре программного обеспечения и всех уведомлений
| Тип: | UserNotificationType |
| Допустимые значения: | DisplayAll, HideAll |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.
| Тип: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-WriteFilterCommit
Этот параметр совпадает со следующим параметром на странице Взаимодействие с пользователеммастера добавления этапа в консоли: Фиксация изменений в крайнем сроке или во время периода обслуживания (требуется перезагрузка). Этот параметр применяется к обработке фильтра записи для устройств Windows Embedded.
| Тип: | Boolean |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
Входные данные
None
Выходные данные
Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase