New-CMTaskSequenceDeployment

Создайте развертывание последовательности задач.

Синтаксис

New-CMTaskSequenceDeployment
   [-AlertDateTime <DateTime>]
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-Availability <MakeAvailableToType>]
   [-DeadlineDateTime <DateTime>]
   [-DeploymentOption <DeploymentOptionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-InputObject] <IResultObject>
   [-InternetOption <Boolean>]
   [-PercentFailure <Int32>]
   [-PercentSuccess <Int32>]
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-ShowTaskSequenceProgress <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-SystemRestart <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTaskSequenceDeployment
   [-AlertDateTime <DateTime>]
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-Availability <MakeAvailableToType>]
   [-DeadlineDateTime <DateTime>]
   [-DeploymentOption <DeploymentOptionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-InternetOption <Boolean>]
   [-PercentFailure <Int32>]
   [-PercentSuccess <Int32>]
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-ShowTaskSequenceProgress <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-SystemRestart <Boolean>]
   [-TaskSequencePackageId] <String>
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Командлет New-CMTaskSequenceDeployment создает развертывание последовательности задач. Развертывание последовательности задач назначает последовательность задач коллекции компьютеров.

Примечание.

Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.

Примеры

Пример 1. Развертывание последовательности задач с множеством общих параметров

В этом примере выполняются следующие действия:

  • Используйте командлет Get-CMTaskSequence , чтобы получить объект последовательности задач для развертывания и сохранить его в переменной $DeployTS .
  • Определите коллекцию в качестве целевого объекта развертывания в переменной $DeployCollection
  • Определите доступное время развертывания в 20:00 25 ноября 2025 г. в переменной $DeployAvailableTime
  • Определите время окончания срока действия развертывания в 20:00 25 января 2026 г. в переменной $DeployExpireTime
  • Определите крайний срок развертывания в 20:00 25 декабря 2025 г. в переменной $ScheduleDateTime
  • Используйте командлет New-CMSchedule , чтобы создать объект расписания для крайнего срока с ежедневным повторяющимся расписанием.
  • Развертывание последовательности задач
$DeployTS = Get-CMTaskSequence -TaskSequencePackageId 'PS104823'
$DeployCollection = 'PS11B7C4'
$DeployAvailableTime = [datetime]::ParseExact("20251125-200000", "yyyyMMdd-HHmmss", $null)
$DeployExpireTime = [datetime]::ParseExact("20260125-200000", "yyyyMMdd-HHmmss", $null)
$ScheduleDateTime = [datetime]::ParseExact("20251225-200000", "yyyyMMdd-HHmmss", $null)
$DeploySchedule = New-CMSchedule -DurationInterval Days -RecurInterval Days -RecurCount 1 -DurationCount 0 -Start $ScheduleDateTime
New-CMTaskSequenceDeployment -InputObject $DeployTS -DeployPurpose Required -AvailableDateTime $DeployAvailableTime -Availability Clients -RerunBehavior AlwaysRerunProgram -Schedule $DeploySchedule -CollectionId $DeployCollection -ShowTaskSequenceProgress $true -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -RunFromSoftwareCenter $true -DeadlineDateTime $DeployExpireTime

Параметры

-AlertDateTime

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

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

-AllowFallback

Разрешить клиентам использовать точки распространения из группы границ сайта по умолчанию.

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

-AllowSharedContent

Разрешить клиентам использовать точки распространения из соседней группы границ.

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

-Availability

Укажите, следует ли сделать эту последовательность задач доступной для клиентов Configuration Manager и будет ли она доступна для запуска при развертывании ОС с помощью загрузочного носителя, предварительно подготовленного носителя или PXE.

Тип:MakeAvailableToType
Aliases:MakeAvailableTo
Допустимые значения:Clients, ClientsMediaAndPxe, MediaAndPxe, MediaAndPxeHidden
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AvailableDateTime

Укажите, когда это развертывание будет доступно.

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

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

-Collection

Укажите объект коллекции в качестве целевого объекта для развертывания этой последовательности задач. Чтобы получить этот объект, используйте командлет Get-CMCollection .

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

-CollectionId

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

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

-CollectionName

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

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

-Comment

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

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

-Confirm

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

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

-DeadlineDateTime

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

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

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

-DeploymentOption

Укажите, как клиенты взаимодействуют с точками распространения для получения содержимого для последовательности задач. Не все параметры доступны в определенных сценариях. Дополнительные сведения см. в разделе Развертывание последовательности задач — параметры развертывания.

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

-DeployPurpose

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

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

-DisableWildcardHandling

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

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

-DistributeCollectionName

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

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

-DistributeContent

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

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

-DistributionPointGroupName

Сайт распространяет содержимое в эту группу точек распространения.

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

-DistributionPointName

Сайт распространяет содержимое в эту точку распространения.

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

-ForceWildcardHandling

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

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

-InputObject

Указывает объект последовательности задач для развертывания. Чтобы получить объект последовательности задач, используйте командлет Get-CMTaskSequence .

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

-InternetOption

Разрешите запуск последовательности задач для клиентов в Интернете.

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

-PercentFailure

Если вы создаете оповещение о неудачных развертываниях, сайт создает оповещение, если процент неудачных развертываний превышает это число.

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

-PercentSuccess

Если вы создаете оповещение об успешных развертываниях, сайт создает оповещение, если процент успешных развертываний меньше этого числа.

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

-PersistOnWriteFilterDevice

Настройка того, как клиент обрабатывает фильтр записи на устройствах Windows Embedded.

  • $true: зафиксируйте изменения в крайний срок или во время периода обслуживания. Требуется перезагрузка.
  • $false: примените содержимое к наложению и зафиксируйте позже.
Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RerunBehavior

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

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

-RunFromSoftwareCenter

Разрешить пользователям запускать программу независимо от назначений.

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

-Schedule

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

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

Укажите массив объектов расписания. Объект schedule определяет обязательное расписание назначения для развертывания. Чтобы создать объект расписания, используйте командлет New-CMSchedule .

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

-ScheduleEvent

Задает массив событий, определяющих время выполнения развертывания последовательности задач.

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

-SendWakeupPacket

Указывает, следует ли отправлять пакет пробуждения компьютерам перед началом развертывания. Если это значение равно $True, Configuration Manager выводит компьютер из спящего режима. Если это значение равно $False, оно не выводит компьютеры из спящего режима. Для пробуждения компьютеров сначала настройте пробуждение по локальной сети.

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

-ShowTaskSequenceProgress

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

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

-SoftwareInstallation

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

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

-SystemRestart

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

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

-TaskSequencePackageId

Укажите идентификатор развертываемой последовательности задач.

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

-UseMeteredNetwork

Указывает, следует ли разрешать клиентам с лимитным подключением к Интернету загружать содержимое по истечении крайнего срока установки, что может повлечь дополнительные расходы.

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

-UseUtcForAvailableSchedule

Указывает, использует ли клиентские компьютеры время в формате UTC для определения доступности программы. Время в формате UTC делает последовательность задач доступной одновременно для всех компьютеров.

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

-UseUtcForExpireSchedule

Указывает, использует ли клиентские компьютеры время в формате UTC для определения срока действия программы. Время в формате UTC делает последовательность задач доступной одновременно для всех компьютеров.

Тип:Boolean
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

Примечания

Используйте параметры расписания соответствующим образом:

  • -AvailableDateTime: укажите, когда это развертывание доступно.

  • -DeadlineDateTime: укажите, когда истечет срок действия развертывания.

  • -Schedule: укажите назначение развертывания или крайний срок.