New-CMTaskSequenceDeployment
SYNOPSIS
Bir görev dizisi dağıtımı oluşturun.
SYNTAX
Searchbyvaluezorunlu (varsayılan)
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>]
Searchpackagebyıdzorunlu
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 'i bir görev sırası dağıtımı oluşturur. Bir görev dizisi dağıtımı, bir bilgisayar koleksiyonuna bir görev sırası atar.
Not
Örneğin, Configuration Manager site sürücüsünden Configuration Manager cmdlet 'lerini çalıştırın PS XYZ:\>
. Daha fazla bilgi için başlarken bölümüne bakın.
EXAMPLES
Örnek 1: çok sayıda ortak parametre içeren bir görev dizisi dağıtın
Bu örnek aşağıdaki eylemleri yapar:
- Dağıtılacak görev dizisi nesnesini almak için Get-CMTaskSequence cmdlet 'ini kullanın ve $DeployTS değişkenine kaydedin
- Koleksiyonu, değişkende dağıtımın hedefi olarak tanımlayın $DeployCollection
- $DeployAvailableTime , değişkende 25 Kasım 2025 ' de 8:00 PM 'de dağıtım kullanılabilir süresini tanımlayın.
- $DeployExpireTime değişkende 25 Ocak 2026 ' de, dağıtım sona erme süresini 8:00 saat olarak tanımlayın
- $ScheduleDateTime değişkende 25 Aralık 2025 ' de dağıtım son tarihini 8:00 saat içinde tanımlayın
- Günlük yinelenen zamanlama ile son tarih için bir zamanlama nesnesi oluşturmak üzere New-CMSchedule cmdlet 'ini kullanın.
- Görev dizisini dağıtma
$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
PARAMETERS
-AlertDateTime
Bir dağıtım uyarısını etkinleştirirseniz, uyarı için bir saat belirtmek üzere bu parametreyi kullanın.
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AllowFallback
İstemcilerin varsayılan site sınırı grubundan dağıtım noktaları kullanmasına izin verin.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AllowSharedContent
İstemcilerin bir komşu sınır grubundan dağıtım noktaları kullanmasına izin verin.
Type: Boolean
Parameter Sets: (All)
Aliases: AllowUseRemoteDistributionPoint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Kullanılabilirlik
Bu görev dizisinin Configuration Manager istemcileri için kullanılabilir hale getirme ve Önyükleme medyası, önceden hazırlanan medya veya PXE kullanarak bir işletim sistemi dağıtırken çalıştırılıp çalıştırılmayacağı.
Type: MakeAvailableToType
Parameter Sets: (All)
Aliases: MakeAvailableTo
Accepted values: Clients, ClientsMediaAndPxe, MediaAndPxe, MediaAndPxeHidden
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AvailableDateTime
Bu dağıtımın ne zaman kullanılabilir olduğunu belirtin.
Dağıtımın ne zaman sona ereceğini belirtmek için -deadlinedatetime kullanın ve dağıtım atamasını veya son tarihi belirtmek için zamanlamayı zamanlayın .
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Koleksiyon
Bu görev dizisi dağıtımı için hedef olarak bir koleksiyon nesnesi belirtin. Bu nesneyi almak için Get-CMCollection cmdlet 'ini kullanın.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionId
Bu görev dizisi dağıtımı için hedef olarak bir koleksiyon KIMLIĞI belirtin.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionName
Bu görev sırası dağıtımının hedefi olarak bir koleksiyon adı belirtin.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-Açıklama
Görev sırası dağıtımı için isteğe bağlı bir açıklama belirtin.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeadlineDateTime
Dağıtımın ne zaman sona ereceğini belirtmek için bu parametreyi kullanın.
Dağıtımın ne zaman kullanılabilir olduğunu belirtmek için -availabledatetime kullanın ve dağıtım atamasını veya son tarihi belirtmeyi zamanlayın .
Type: DateTime
Parameter Sets: (All)
Aliases: DeploymentExpireDateTime
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeployPurpose
Bu dağıtımın kullanıcıların yüklemesi için kullanılabilir olup olmadığını veya son tarihte yüklenmesi gerektiğini belirtin.
Type: DeployPurposeType
Parameter Sets: (All)
Aliases:
Accepted values: Available, Required
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeploymentOption
İstemcilerin görev dizisine yönelik içerik almak için dağıtım noktalarıyla nasıl etkileşim kuracağını belirtin. Tüm seçenekler belirli senaryolarda kullanılamaz. Daha fazla bilgi için bkz. görev dizisi dağıtım seçeneklerini dağıtma.
Type: DeploymentOptionType
Parameter Sets: (All)
Aliases:
Accepted values: DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence, RunFromDistributionPoint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Disableyavaya Cardhandling
Bu parametre, joker karakterleri değişmez değer karakter değerleri olarak değerlendirir. Bunu Forceyavaya Cardhandling ile birleştiremezsiniz.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributeCollectionName
Site, bu koleksiyon adıyla ilişkili olan dağıtım noktası gruplarına içerik dağıtır.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributeContent
Bu dağıtımı oluştururken görev sırası içeriğini dağıtmak için bu parametreyi ekleyin. İstemciler, istemcilerin erişebileceği dağıtım noktalarına içerik dağıtana kadar görev sırasını yükleyemez.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributionPointGroupName
Site, içeriği bu dağıtım noktası grubuna dağıtır.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributionPointName
Site içeriği bu dağıtım noktasına dağıtır.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Forcebir Cardhandling
Bu parametre joker karakterleri işler ve beklenmeyen davranışlara neden olabilir (önerilmez). Bunu Disableyavaya Cardhandling ile birleştiremezsiniz.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Dağıtılacak bir görev dizisi nesnesini belirtir. Bir görev dizisi nesnesi almak için Get-CMTaskSequence cmdlet 'ini kullanın.
Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases: TaskSequence
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Internetoption
Görev dizisinin İnternet üzerindeki istemciler için çalışmasına izin verin.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PercentFailure
Başarısız dağıtımlar için bir uyarı oluşturursanız, başarısız olan dağıtımlar yüzdesi bu sayıdan yüksek olduğunda site bir uyarı oluşturur.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PercentSuccess
Başarılı dağıtımlar için bir uyarı oluşturursanız, başarılı dağıtımlar yüzdesi bu sayıdan düşükse site bir uyarı oluşturur.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PersistOnWriteFilterDevice
istemcinin Windows katıştırılmış cihazlarda yazma filtresini nasıl işleyeceğini yapılandırın.
$true
: Değişiklikleri son tarihte veya bakım penceresi sırasında yürütün. Yeniden başlatma gerekiyor.$false
: Kaplama üzerinde içerik uygulayın ve daha sonra işleyin.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Yeniden yönlendirme davranışı
Görevin, daha önce zamanlanan zorunlu süreden önce daha önce çalıştırıldıysa, görev dizisinin bir bilgisayarda tekrar tekrar çalışıp çalışmadığını belirtin. Varsayılan olarak, görev dizisi her zaman yeniden çalıştırır.
Type: RerunBehaviorType
Parameter Sets: (All)
Aliases:
Accepted values: NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RunFromSoftwareCenter
Kullanıcıların programı atamalardan bağımsız olarak çalıştırmasına izin ver.
Type: Boolean
Parameter Sets: (All)
Aliases: AllowUsersRunIndependently
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Zamanlama
Dağıtım atamasını veya son tarihi belirtmek için bu parametreyi kullanın.
Dağıtımın ne zaman kullanılabilir olduğunu belirtmek için -availabledatetime , dağıtımın süresinin ne zaman dolacağını belirtmek için -deadlinedatetime kullanın.
Bir zamanlama nesneleri dizisi belirtin. Zamanlama nesnesi bir dağıtım için zorunlu atama zamanlamasını tanımlar. Bir zamanlama nesnesi oluşturmak için New-CMSchedule cmdlet 'ini kullanın.
Type: IResultObject[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ScheduleEvent
Görev sırası dağıtımının ne zaman çalışacağını belirleyen bir olay dizisi belirtir.
Type: ScheduleEventType[]
Parameter Sets: (All)
Aliases:
Accepted values: AsSoonAsPossible, LogOn, LogOff
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SendWakeupPacket
Dağıtım başlamadan önce bilgisayarlara bir uyandırma paketi gönderileceğini belirtir. Bu değer ise $True
, Configuration Manager bilgisayarı uykudan uyandırır. Bu değer ise $False
bilgisayarları uykudan uyanmaz. Bilgisayarların uyanma için önce LAN'da Uyandırma yapılandırın.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ShowTaskSequenceProgress
Bir görev dizisi için işlem iletişim kutusunun gösterilip gösterilmeyeceğini gösterir.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Softwareınstallation
Yükleme son tarihine ulaşıldığında, $true
görev dizisinin bakım penceresi dışında yüklenmesine izin vermek için bu parametreyi olarak ayarlayın.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SystemRestart
Yükleme son tarihine ulaşıldığında, $true
bakım penceresi dışında gerekliyse, sistem yeniden başlatmaya izin vermek için bu parametreyi olarak ayarlayın.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Tasksequencepackageıd
Dağıtılacak görev dizisinin KIMLIĞINI belirtin.
Type: String
Parameter Sets: SearchPackageByIdMandatory
Aliases: PackageId, TaskSequenceId
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UseMeteredNetwork
Tarifeli bir internet bağlantısı kullanan istemcilerin, yükleme son tarihinden sonra içerik indirmelerine izin verip vermeyeceğinizi gösterir ve bu da ek ücret ödemeniz gerekebilir.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UseUtcForAvailableSchedule
İstemci bilgisayarlarının bir programın kullanılabilirliğini belirlemede UTC zamanı kullanıp kullanmadığını belirtir. UTC saati, görev dizisinin tüm bilgisayarlar için aynı anda kullanılabilir olmasını sağlar.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Useutcbir piplan
İstemci bilgisayarların, bir programın süresinin dolmasını belirlemede UTC saati kullanıp kullanmadığını belirtir. UTC saati, görev dizisinin tüm bilgisayarlar için aynı anda kullanılabilir olmasını sağlar.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Bu cmdlet şu genel parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
INPUTS
Microsoft.ConfigurationManagement. ManagementProvider. ıresultobject
OUTPUTS
Iresultobject # SMS_Advertisement
NOTLAR
Schedule parametrelerini uygun şekilde kullandığınızdan emin olun:
-Availabledatetime: Bu dağıtımın ne zaman kullanılabilir olduğunu belirtin.
-Deadlinedatetime: dağıtımın süresinin ne zaman dolacağını belirtin.
-Schedule: dağıtım atamasını veya son tarihi belirtin.
RELATED LINKS
Get-CMTaskSequenceDeployment Set-CMTaskSequenceDeployment Remove-CMTaskSequenceDeployment