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
Если вы включите оповещение о развертывании, используйте этот параметр, чтобы указать время для оповещения.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowFallback
Разрешить клиентам использовать точки распространения из группы границ сайта по умолчанию.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowSharedContent
Разрешить клиентам использовать точки распространения из соседней группы границ.
| Type: | Boolean |
| Aliases: | AllowUseRemoteDistributionPoint |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Availability
Укажите, следует ли сделать эту последовательность задач доступной для Configuration Manager клиентов и будет ли она доступна для запуска при развертывании ОС с помощью загрузочного носителя, предварительно подготовленного носителя или PXE.
| Type: | MakeAvailableToType |
| Aliases: | MakeAvailableTo |
| Accepted values: | Clients, ClientsMediaAndPxe, MediaAndPxe, MediaAndPxeHidden |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AvailableDateTime
Укажите, когда это развертывание будет доступно.
Используйте параметр -DeadlineDateTime , чтобы указать , когда истечет срок развертывания, и -Schedule , чтобы указать назначение развертывания или крайний срок.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Collection
Укажите объект коллекции в качестве целевого объекта для развертывания этой последовательности задач. Чтобы получить этот объект, используйте командлет Get-CMCollection .
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CollectionId
Укажите идентификатор коллекции в качестве целевого объекта для развертывания этой последовательности задач.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CollectionName
Укажите имя коллекции в качестве целевого объекта для развертывания этой последовательности задач.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Comment
Укажите необязательный комментарий для развертывания последовательности задач.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Перед запуском командлет запросит подтверждение.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeadlineDateTime
Используйте этот параметр, чтобы указать , когда истечет срок действия развертывания.
Используйте параметр -AvailableDateTime , чтобы указать , когда развертывание доступно, и -Schedule , чтобы указать назначение развертывания или крайний срок.
| Type: | DateTime |
| Aliases: | DeploymentExpireDateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeploymentOption
Укажите, как клиенты взаимодействуют с точками распространения для получения содержимого для последовательности задач. Не все параметры доступны в определенных сценариях. Дополнительные сведения см. в разделе Развертывание последовательности задач — параметры развертывания.
| Type: | DeploymentOptionType |
| Accepted values: | DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence, RunFromDistributionPoint |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeployPurpose
Укажите, доступно ли это развертывание для установки пользователями или оно должно быть установлено в крайнем сроке.
| Type: | DeployPurposeType |
| Accepted values: | Available, Required |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DistributeCollectionName
Сайт распространяет содержимое в группы точек распространения, связанные с этим именем коллекции.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DistributeContent
Добавьте этот параметр для распространения содержимого последовательности задач при создании этого развертывания. Клиенты не смогут установить последовательность задач до тех пор, пока вы не разопространите содержимое в точках распространения, к которым клиенты могут получить доступ.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DistributionPointGroupName
Сайт распространяет содержимое в эту группу точек распространения.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DistributionPointName
Сайт распространяет содержимое в эту точку распространения.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Указывает объект последовательности задач для развертывания. Чтобы получить объект последовательности задач, используйте командлет Get-CMTaskSequence .
| Type: | IResultObject |
| Aliases: | TaskSequence |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-InternetOption
Разрешите запуск последовательности задач для клиентов в Интернете.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PercentFailure
Если вы создаете оповещение о неудачных развертываниях, сайт создает оповещение, если процент неудачных развертываний превышает это число.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PercentSuccess
Если вы создаете оповещение об успешных развертываниях, сайт создает оповещение, если процент успешных развертываний меньше этого числа.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PersistOnWriteFilterDevice
Настройка того, как клиент обрабатывает фильтр записи на устройствах Windows Embedded.
$true: зафиксируйте изменения в крайний срок или во время периода обслуживания. Требуется перезагрузка.$false: примените содержимое к наложению и зафиксируйте позже.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RerunBehavior
Укажите, будет ли последовательность задач повторно выполняться на компьютере, если она выполнялась ранее до запланированного обязательного времени. По умолчанию последовательность задач всегда выполняется повторно.
| Type: | RerunBehaviorType |
| Accepted values: | NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunFromSoftwareCenter
Разрешить пользователям запускать программу независимо от назначений.
| Type: | Boolean |
| Aliases: | AllowUsersRunIndependently |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Schedule
Используйте этот параметр, чтобы указать назначение развертывания или крайний срок.
Используйте параметр -AvailableDateTime , чтобы указать , когда будет доступно развертывание, и -DeadlineDateTime , чтобы указать время истечения срока действия развертывания.
Укажите массив объектов расписания. Объект schedule определяет обязательное расписание назначения для развертывания. Чтобы создать объект расписания, используйте командлет New-CMSchedule .
| Type: | IResultObject[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ScheduleEvent
Задает массив событий, определяющих время выполнения развертывания последовательности задач.
| Type: | ScheduleEventType[] |
| Accepted values: | AsSoonAsPossible, LogOn, LogOff |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SendWakeupPacket
Указывает, следует ли отправлять пакет пробуждения компьютерам перед началом развертывания. Если это значение равно $True, Configuration Manager выводит компьютер из спящего режима. Если это значение равно $False, оно не выводит компьютеры из спящего режима. Для пробуждения компьютеров сначала настройте пробуждение по локальной сети.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ShowTaskSequenceProgress
Указывает, следует ли отображать диалоговое окно процесса для последовательности задач.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SoftwareInstallation
По достижении крайнего срока установки присвойте этому параметру значение $true , чтобы последовательность задач устанавливалась вне периода обслуживания.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SystemRestart
По достижении крайнего срока установки присвойте этому параметру $true значение , чтобы разрешить перезагрузку системы, если это необходимо за пределами периода обслуживания.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TaskSequencePackageId
Укажите идентификатор развертываемой последовательности задач.
| Type: | String |
| Aliases: | PackageId, TaskSequenceId |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseMeteredNetwork
Указывает, следует ли разрешать клиентам с лимитным подключением к Интернету загружать содержимое по истечении крайнего срока установки, что может повлечь дополнительные расходы.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseUtcForAvailableSchedule
Указывает, использует ли клиентские компьютеры время в формате UTC для определения доступности программы. Время в формате UTC делает последовательность задач доступной одновременно для всех компьютеров.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseUtcForExpireSchedule
Указывает, использует ли клиентские компьютеры время в формате UTC для определения срока действия программы. Время в формате UTC делает последовательность задач доступной одновременно для всех компьютеров.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Входные данные
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Выходные данные
IResultObject
Примечания
Используйте параметры расписания соответствующим образом:
-AvailableDateTime: укажите, когда это развертывание доступно.
-DeadlineDateTime: укажите, когда истечет срок действия развертывания.
-Schedule: укажите назначение развертывания или крайний срок.
Связанные ссылки
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по