New-CMTaskSequenceDeployment
SYNOPSIS
Vytvořte nasazení pořadí úloh.
SYNTAX
SearchByValueMandatory (výchozí)
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>]
SearchPackageByIdMandatory
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
Rutina New-CMTaskSequenceDeployment vytvoří nasazení pořadí úloh. Nasazení pořadí úkolů přiřadí pořadí úkolů do kolekce počítačů.
Poznámka
Použijte například rutiny Configuration Manager z Configuration Manager jednotky webu PS XYZ:\> . Další informace najdete v tématu Začínáme.
EXAMPLES
Příklad 1: nasazení pořadí úkolů s mnoha společnými parametry
Tento příklad provádí následující akce:
- Pomocí rutiny Get-CMTaskSequence získejte objekt pořadí úloh, který se má nasadit, a uloží ho do proměnné $DeployTS .
- Definujte kolekci jako cíl nasazení v proměnné $DeployCollection
- Zadejte čas dostupného nasazení v 8:00. listopadu 2025 v proměnné $DeployAvailableTime
- V proměnné $DeployExpireTime zadejte čas vypršení platnosti nasazení 8:00 na 25. ledna 2026.
- Zadejte konečný termín nasazení v 8:00. prosince 2025 v proměnné $ScheduleDateTime
- Pomocí rutiny New-CMSchedule vytvořte objekt Schedule pro konečný termín s denním plánem opakování.
- Nasazení pořadí úkolů
$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
Pokud povolíte výstrahu pro nasazení, použijte tento parametr k zadání času výstrahy.
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AllowFallback
Umožňuje klientům používat distribuční body z výchozí skupiny hranic lokality.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AllowSharedContent
Umožňuje klientům používat distribuční body ze sousední skupiny hranic.
Type: Boolean
Parameter Sets: (All)
Aliases: AllowUseRemoteDistributionPoint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
– Dostupnost
Určete, zda chcete toto pořadí úloh zpřístupnit Configuration Manager klientům a zda je k dispozici ke spuštění při nasazení operačního systému pomocí spouštěcího média, předzpracovaného média nebo technologie PXE.
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
Určete, kdy bude toto nasazení k dispozici.
Pomocí -DeadlineDateTime zadejte, kdy se má nasazení vypršet, a podle plánu určete přiřazení nasazení nebo konečný termín.
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
– Kolekce
Zadejte objekt kolekce jako cíl pro toto nasazení pořadí úloh. K získání tohoto objektu použijte rutinu Get-CMCollection .
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionId
Zadejte ID kolekce jako cíl pro toto nasazení pořadí úloh.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionName
Zadejte název kolekce jako cíl pro toto nasazení pořadí úloh.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
– Komentář
Zadejte volitelný komentář pro nasazení pořadí úloh.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeadlineDateTime
Tento parametr použijte k určení, kdy platnost nasazení vyprší.
Pomocí -AvailableDateTime určete, kdy je nasazení k dispozici, a podle plánu určete přiřazení nasazení nebo konečný termín.
Type: DateTime
Parameter Sets: (All)
Aliases: DeploymentExpireDateTime
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeployPurpose
Určete, zda je toto nasazení k dispozici pro uživatele k instalaci, nebo je nutné jej nainstalovat v konečném termínu.
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
Určete způsob interakce klientů s distribučními body za účelem získání obsahu pro pořadí úkolů. V konkrétních scénářích nejsou k dispozici všechny možnosti. Další informace najdete v tématu nasazení pořadí úkolů – možnosti nasazení.
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
-DisableWildcardHandling
Tento parametr považuje zástupné znaky jako literálové hodnoty znaků. Nejde kombinovat s ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributeCollectionName
Lokalita distribuuje obsah do skupin distribučních bodů, které jsou přidruženy k tomuto názvu kolekce.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributeContent
Přidejte tento parametr pro distribuci obsahu pořadí úloh při vytváření tohoto nasazení. Klienti nemohou pořadí úkolů instalovat, dokud nedistribuujete obsah do distribučních bodů, ke kterým mají klienti přístup.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributionPointGroupName
Lokalita distribuuje obsah do této skupiny distribučních bodů.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributionPointName
Lokalita distribuuje obsah do tohoto distribučního bodu.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Tento parametr zpracovává zástupné znaky a může vést k neočekávanému chování (nedoporučujeme). Nejde kombinovat s DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
– Položky InputObject
Určuje objekt pořadí úkolů, který se má nasadit. Chcete-li získat objekt pořadí úloh, použijte rutinu Get-CMTaskSequence .
Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases: TaskSequence
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-InternetOption
Povolí spuštění pořadí úloh pro klienty na internetu.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PercentFailure
Pokud vytvoříte výstrahu pro nezdařená nasazení, lokalita vygeneruje výstrahu, pokud je procento neúspěšných nasazení vyšší než toto číslo.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PercentSuccess
Pokud vytvoříte výstrahu pro úspěšná nasazení, lokalita vygeneruje výstrahu, pokud je procento úspěšných nasazení nižší než toto číslo.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PersistOnWriteFilterDevice
nakonfigurujte, jak klient zpracovává filtr zápisu na Windows integrovaných zařízeních.
$true: Potvrdit změny v konečném termínu nebo během okna údržby. Vyžaduje se restartování.$false: Použijte obsah na překrytí a potvrďte ho později.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RerunBehavior
Určete, zda bude pořadí úkolů znovu spuštěno v počítači, pokud předtím běželo před naplánovaným povinným časem. Ve výchozím nastavení se pořadí úkolů vždy znovu spustí.
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
Povolí uživatelům spustit program nezávisle na přiřazení.
Type: Boolean
Parameter Sets: (All)
Aliases: AllowUsersRunIndependently
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
– Plán
Pomocí tohoto parametru můžete zadat přiřazení nasazení nebo konečný termín.
Použijte -AvailableDateTime k určení, kdy je nasazení k dispozici, a -DeadlineDateTime k určení, kdy vyprší platnost nasazení.
Zadejte pole objektů plánu. Objekt plánu definuje povinný plán přiřazení pro nasazení. Chcete-li vytvořit objekt plánu, použijte rutinu New-CMSchedule .
Type: IResultObject[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ScheduleEvent
Určuje pole událostí, které určují, kdy se má nasazení pořadí úkolů spouštět.
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
Označuje, zda se má odeslat paket buzení ze spánku do počítačů před zahájením nasazení. Pokud je tato hodnota $True , Configuration Manager probudí počítač z režimu spánku. Pokud je tato hodnota $False , nebude probudit počítače z režimu spánku. Aby se počítače probudily, nejdřív nakonfigurujte Wake On LAN.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ShowTaskSequenceProgress
Označuje, zda se má zobrazit dialogové okno procesu pro pořadí úkolů.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SoftwareInstallation
Po dosažení konečného termínu instalace nastavte tento parametr na, $true aby bylo možné pořadí úkolů instalovat mimo časové období údržby.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SystemRestart
Po dosažení konečného termínu instalace nastavte tento parametr na, aby $true bylo možné v případě potřeby restartovat systém mimo okno údržby.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-TaskSequencePackageId
Zadejte ID pořadí úkolů, které chcete nasadit.
Type: String
Parameter Sets: SearchPackageByIdMandatory
Aliases: PackageId, TaskSequenceId
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UseMeteredNetwork
Určuje, jestli chcete klientům na měřeném připojení k internetu stahovat obsah po uplynutí konečného termínu instalace, což může nabývat dalších nákladů.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UseUtcForAvailableSchedule
Určuje, zda klientské počítače používají čas UTC k určení dostupnosti programu. Čas UTC zajistí, že pořadí úloh bude k dispozici ve stejnou dobu pro všechny počítače.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UseUtcForExpireSchedule
Určuje, zda klientské počítače používají čas UTC k určení vypršení platnosti programu. Čas UTC zajistí, že pořadí úloh bude k dispozici ve stejnou dobu pro všechny počítače.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina se nespustí.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Tato rutina podporuje společné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v tématu about_CommonParameters.
INPUTS
Microsoft.ConfigurationManagement. ManagementProvider. IResultObject
OUTPUTS
IResultObject # SMS_Advertisement
POZNÁMKY
Ujistěte se, že jste parametry plánu používali správně:
-AvailableDateTime: Určete, kdy bude toto nasazení k dispozici.
-DeadlineDateTime: Určete, kdy nasazení vyprší.
-Schedule: Určete přiřazení nasazení nebo konečný termín.
RELATED LINKS
Get-CMTaskSequenceDeployment Set-CMTaskSequenceDeployment Remove-CMTaskSequenceDeployment