New-CMTaskSequenceDeployment

모듈:

ConfigurationManager

작업 순서 배포를 만듭니다.

구문

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>]

Description

New-CMTaskSequenceDeployment cmdlet은 작업 순서 배포를 만듭니다. 작업 순서 배포는 컴퓨터 컬렉션에 작업 순서를 할당합니다.

참고

Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.

예제

예제 1: 많은 일반적인 매개 변수를 사용하여 작업 순서 배포

이 예제에서는 다음 작업을 수행합니다.

• Get-CMTaskSequence cmdlet을 사용하여 배포할 작업 순서 개체를 가져와서 $DeployTS 변수에 저장합니다.
• 변수 $DeployCollection 배포의 대상으로 컬렉션을 정의합니다.
• 변수 $DeployAvailableTime 2025년 11월 25일 오후 8:00에 배포 사용 가능한 시간을 정의합니다.
• 변수 $DeployExpireTime 2026년 1월 25일 오후 8:00에 배포 만료 시간을 정의합니다.
• 변수 $ScheduleDateTime 2025년 12월 25일 오후 8:00에 배포 마감일을 정의합니다.
• New-CMSchedule cmdlet을 사용하여 매일 되풀이 일정으로 최종 기한에 대한 일정 개체를 만듭니다.
• 작업 순서 배포

$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
별칭:	AllowUseRemoteDistributionPoint
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Availability

Configuration Manager 클라이언트에서 이 작업 순서를 사용할 수 있도록 할지 여부와 부팅 미디어, 사전 준비된 미디어 또는 PXE를 사용하여 OS를 배포할 때 실행할 수 있는지 여부를 지정합니다.

형식:	MakeAvailableToType
별칭:	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 cmdlet을 사용합니다.

형식:	IResultObject
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-CollectionId

컬렉션 ID를 이 작업 순서 배포의 대상으로 지정합니다.

형식:	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

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

형식:	SwitchParameter
별칭:	cf
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DeadlineDateTime

배포가 만료되는 시기를 지정하려면 이 매개 변수 를 사용합니다.

-AvailableDateTime을 사용하여 배포를 사용할 수 있는 시기를 지정하고 -Schedule을 사용하여 배포 할당 또는 최종 기한을 지정합니다.

형식:	DateTime
별칭:	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 cmdlet을 사용합니다.

형식:	IResultObject
별칭:	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
별칭:	AllowUsersRunIndependently
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Schedule

이 매개 변수를 사용하여 배포 할당 또는 최종 기한을 지정합니다.

-AvailableDateTime을 사용하여 배포를 사용할 수 있는 시기를 지정하고 -DeadlineDateTime을 사용하여 배포가 만료되는 시기를 지정합니다.

일정 개체의 배열을 지정합니다. schedule 개체는 배포에 대한 필수 할당 일정을 정의합니다. 일정 개체를 만들려면 New-CMSchedule cmdlet을 사용합니다.

형식:	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면 컴퓨터를 절전 모드에서 해제하지 않습니다. 컴퓨터가 절 해제하려면 먼저 Wake On LAN을 구성합니다.

형식:	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

배포할 작업 순서의 ID를 지정합니다.

형식:	String
별칭:	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

cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.

형식:	SwitchParameter
별칭:	wi
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

입력

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

출력

IResultObject

참고

일정 매개 변수를 적절하게 사용해야 합니다.

• -AvailableDateTime: 이 배포를 사용할 수 있는 시기를 지정합니다.

• -DeadlineDateTime: 배포가 만료되는 시기를 지정합니다.

• -일정: 배포 할당 또는 마감일을 지정 합니다.

관련 링크

• Get-CMTaskSequenceDeployment
• Set-CMTaskSequenceDeployment
• Remove-CMTaskSequenceDeployment
• Get-CMTaskSequence
• 작업 순서 배포