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: укажите назначение развертывания или крайний срок.