Set-CMTaskSequencePhase
Используйте этот комдлет для настройки фазы развертывания для последовательности задач.
Синтаксис
Set-CMTaskSequencePhase
[-AllowFallback <Boolean>]
[-AllowRemoteDP <Boolean>]
[-AllowSystemRestart <Boolean>]
[-Comments <String>]
[-DeploymentOption <DeploymentOptionType>]
[-PreDownload <Boolean>]
[-SoftwareInstallation <Boolean>]
[-UserNotification <UserNotificationType>]
[-WriteFilterCommit <Boolean>]
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-InstallationChoice <InstallationChoiceType>]
[-MovePhase <ReorderType>]
[-MoveToOrder <Int32>]
[-NewCollection <IResultObject>]
[-NewCollectionId <String>]
[-NewCollectionName <String>]
[-NewPhaseName <String>]
[-ThrottlingDays <Int32>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-Id <String>]
[-InputObject] <IResultObject>
[-Name <String>]
[-Order <Int32>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMTaskSequencePhase
[-AllowFallback <Boolean>]
[-AllowRemoteDP <Boolean>]
[-AllowSystemRestart <Boolean>]
[-Comments <String>]
[-DeploymentOption <DeploymentOptionType>]
[-PreDownload <Boolean>]
[-SoftwareInstallation <Boolean>]
[-UserNotification <UserNotificationType>]
[-WriteFilterCommit <Boolean>]
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-InstallationChoice <InstallationChoiceType>]
[-MovePhase <ReorderType>]
[-MoveToOrder <Int32>]
[-NewCollection <IResultObject>]
[-NewCollectionId <String>]
[-NewCollectionName <String>]
[-NewPhaseName <String>]
[-ThrottlingDays <Int32>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-Id <String>]
[-Name <String>]
[-Order <Int32>]
[-PhasedDeploymentId] <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMTaskSequencePhase
[-AllowFallback <Boolean>]
[-AllowRemoteDP <Boolean>]
[-AllowSystemRestart <Boolean>]
[-Comments <String>]
[-DeploymentOption <DeploymentOptionType>]
[-PreDownload <Boolean>]
[-SoftwareInstallation <Boolean>]
[-UserNotification <UserNotificationType>]
[-WriteFilterCommit <Boolean>]
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-InstallationChoice <InstallationChoiceType>]
[-MovePhase <ReorderType>]
[-MoveToOrder <Int32>]
[-NewCollection <IResultObject>]
[-NewCollectionId <String>]
[-NewCollectionName <String>]
[-NewPhaseName <String>]
[-ThrottlingDays <Int32>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-Id <String>]
[-Name <String>]
[-Order <Int32>]
[-PhasedDeploymentName] <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Применяется к версии 2006 и более поздней версии. Используйте этот комдлет для настройки фазы развертывания для последовательности задач. Дополнительные сведения см. в дополнительных сведениях о создании поэтапного развертывания.
Примеры
Пример 1. Изменение коллекции
В этом примере изменяется коллекция для второго этапа поэтапного развертывания последовательности задач, передаемой в командной строке.
$phasedDeployment = Get-CMTaskSequencePhasedDeployment -Name "myPhasedDeployment"
$phasedDeployment | Set-CMTaskSequencePhase -Order 2 -NewCollectionId "XYZ00227"
Пример 2. Перемещение этапа вверх
Этот пример перемещает этап вверх в порядке. Он выбирает поэтапное развертывание по своему ID и выбирает этап по связанному с ним ИД коллекции.
Set-CMTaskSequencePhase -PhasedDeploymentId "0bc464d9-e7dd-44c1-a157-3f8be6a79c03" -CollectionId "XYZ00227" -MovePhase MoveUp
Пример 3. Настройка параметров фазы
В этом примере меняются параметры конфигурации для выбранного этапа.
Set-CMTaskSequencePhase -PhasedDeploymentName "myPhasedDeployment" -Name "phase1" -UserNotification HideAll -SoftwareInstallation $true -AllowSystemRestart $true -WriteFilterCommit $false -PreDownload $true -Comments "phase 1 comment" -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -AllowRemoteDP $true -AllowFallback $false -CriteriaOption Compliance -CriteriaValue 90 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 3 -ThrottlingDays 5 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 12
Параметры
-AllowFallback
Этот параметр такой же, как **** и следующий параметр **** на странице Точки распространения мастера фазы добавления в консоли: разрешить клиентам использовать точки распространения из группы границ сайта по умолчанию.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowRemoteDP
Этот параметр является таким же, **** как и следующий **** параметр на странице Точки распространения мастера фазы добавления на консоли. Если нет локальной точки распространения, используйте удаленную точку распространения.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowSystemRestart
Этот параметр является таким же, **** как и следующий **** параметр на странице Пользовательский опыт мастера добавить фазы в консоли: перезапуск системы (если требуется для завершения установки). Этот параметр применяется, когда установлен крайний срок установки, чтобы разрешить выполнение этого действия за пределами окна обслуживания.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BeginCondition
Укажите параметр для начала этого этапа развертывания после успешного осуществления предыдущего этапа:
AfterPeriod
. Этот параметр является таким же, как и следующий параметр **** на странице Phase Параметры мастера фазы добавления в консоли. Автоматически приступить к этому этапу после отсрочки (в днях). Если укажите это значение, используйте DaysAfterPreviousPhaseSuccess для настройки периода времени.Manually
. Этот параметр является таким же, как и следующий параметр **** на странице Phase Параметры мастера фазы добавления в консоли: вручную приступить к этому этапу развертывания.
Type: | BeginConditionType |
Accepted values: | AfterPeriod, Manually |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Collection
Укажите объект для целевой коллекции
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionId
Укажите целевой набор по ID.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Укажите целевой набор по имени.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Comments
Укажите дополнительные комментарии для этого этапа. Максимальная длина — 512 символов.
Type: | String |
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
. Этот параметр такой же, как и следующий параметр на **** странице Phase Параметры мастера фазы добавления в консоли: процент успешности развертывания. Укажите процентное значение с параметром CriteriaValue.Number
. Этот параметр такой же, как и следующий параметр **** на странице Phase Параметры мастера фазы добавления в консоли: количество успешно развернутых устройств. Укажите количество устройств с параметром 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
Укажите количество дней после успешного начала предыдущего этапа для начала этого этапа. Этот параметр такой же, как и следующий параметр на **** странице Phase Параметры мастера фазы добавления в консоли: автоматически приступить к этому этапу после отсрочки (в днях).
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
. Этот параметр такой же, как и следующий параметр на **** странице Phase Параметры мастера фазы добавления в консоли. Установка требуется после этого периода времени.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentOption
Этот параметр такой же, как **** и следующий параметр **** на странице Точки распространения мастера фазы добавления в консоли. Выберите параметр развертывания, который можно использовать, когда клиент использует точку распространения из пограничной группы соседей или пограничной группы сайтов по умолчанию. Он принимает следующие значения:
DownloadContentLocallyWhenNeededByRunningTaskSequence
: Загрузка контента локально при необходимости по последовательности запущенных задачDownloadAllContentLocallyBeforeStartingTaskSequence
: Скачайте все содержимое локально перед началом последовательности задач
Type: | DeploymentOptionType |
Accepted values: | DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence |
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 |
-ForceWildcardHandling
Этот параметр обрабатывает символы под диктовки и может привести к неожиданному поведению. Это не рекомендуется. Вы не можете объединить его с DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Укажите ID фазы для настройки.
Type: | String |
Aliases: | PhaseId |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Укажите объект поэтапного развертывания, который включает этап настройки.
Type: | IResultObject |
Aliases: | PhasedDeployment |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InstallationChoice
Укажите параметр для поведения по отношению к выходу программного обеспечения:
AsSoonAsPossible
. Этот параметр такой же, как и следующий параметр на **** странице Phase Параметры мастера фазы добавления в консоли. Установка требуется как можно скорее.AfterPeriod
: Этот параметр является таким же, как и следующий параметр **** на странице Phase Параметры мастера фазы добавления в консоли. Установка требуется после этого периода времени. Если указать это значение, используйте DeadlineUnit и DeadlineValue для настройки периода времени.
Type: | InstallationChoiceType |
Accepted values: | AsSoonAsPossible, AfterPeriod |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MovePhase
Измените порядок выбранного этапа. Вы можете переместить его вверх по одному, переместить его вниз или перейти к определенному индексу. Если MoveToOrder
указать, используйте параметр -MoveToOrder, чтобы задать определенный индекс.
Type: | ReorderType |
Accepted values: | MoveUp, MoveDown, MoveToOrder |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MoveToOrder
При задании параметра -MovePhase используйте этот параметр для MoveToOrder
набора определенного индекса.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Укажите имя этапа для настройки.
Type: | String |
Aliases: | PhaseName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewCollection
Укажите объект коллекции, который будет использовать в качестве новой цели для выбранного этапа.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewCollectionId
Укажите коллекцию по ID для использования в качестве новой цели для выбранного этапа.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewCollectionName
Укажите коллекцию по имени для использования в качестве новой цели для выбранного этапа.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewPhaseName
Используйте этот параметр, чтобы переименовать выбранный этап.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Order
Укажите индекс фазы для настройки.
Type: | Int32 |
Aliases: | PhaseOrder |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PhasedDeploymentId
Выберите поэтапное развертывание по ID. Затем используйте другие параметры, чтобы выбрать определенный этап в этом развертывании.
Type: | String |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PhasedDeploymentName
Выберите поэтапное развертывание по имени. Затем используйте другие параметры, чтобы выбрать определенный этап в этом развертывании.
Type: | String |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PreDownload
Этот параметр такой же, как **** и следующий **** параметр на общей странице мастера фазы добавления в консоли: предварительно скачивание контента для этой последовательности задач.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareInstallation
Этот параметр является таким же, как и следующий **** параметр на странице Пользовательский опыт мастера добавить фазы в консоли: установка программного обеспечения. Этот параметр применяется, когда установлен крайний срок установки, чтобы разрешить выполнение этого действия за пределами окна обслуживания.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ThrottlingDays
Укажите значение в несколько дней, чтобы постепенно сделать это программное обеспечение доступным. Этот параметр является таким же, как и следующий параметр **** на странице Phase Параметры мастера фазы добавления в консоли: постепенно сделать это программное обеспечение доступным в течение этого периода времени (в днях).
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserNotification
Этот параметр является таким же, **** как и следующий **** параметр на странице Пользовательский опыт мастера добавить фазы в консоли: Укажите параметр пользовательского интерфейса для этого развертывания со следующими значениями:
DisplayAll
: Отображение в Центре программного обеспечения и отображение всех уведомленийHideAll
: Скрыть в Центре программного обеспечения и все уведомления
Type: | UserNotificationType |
Accepted values: | DisplayAll, HideAll |
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 |
-WriteFilterCommit
Этот параметр является таким же, **** как и следующий **** параметр на странице Пользовательский опыт мастера добавить фазы в консоли: Фиксация изменений в срок или во время окна обслуживания (требуется перезапустить). Этот параметр применяется для обработки фильтров для Windows встроенных устройств.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Входные данные
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Выходные данные
IResultObject
Связанные ссылки
- Get-CMPhase
- New-CMTaskSequencePhase
- Get-CMTaskSequencePhasedDeployment
- New-CMTaskSequenceAutoPhasedDeployment
- New-CMTaskSequenceManualPhasedDeployment
- Remove-CMTaskSequencePhasedDeployment
- Set-CMTaskSequencePhasedDeployment
- Get-CMPhasedDeploymentStatus
- Move-CMPhasedDeploymentToNext
- Resume-CMPhasedDeployment
- Suspend-CMPhasedDeployment
- Создание поэтапного развертывания