New-CMTaskSequenceDeployment
SYNOPSIS
Maak een takenreeksimplementatie.
SYNTAX
SearchByValueMandatory (standaard)
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
Met de cmdlet New-CMTaskSequenceDeployment wordt een takenreeksimplementatie gemaakt. Een takenreeksimplementatie wijst een takenreeks toe aan een verzameling computers.
Notitie
Voer Configuration Manager cmdlets uit vanaf Configuration Manager-sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.
EXAMPLES
Voorbeeld 1: Een takenreeks met veel algemene parameters implementeren
In dit voorbeeld worden de volgende acties ondernomen:
- Gebruik de cmdlet Get-CMTaskSequence om het takenreeksobject te implementeren en slaat het op in de $DeployTS variabele
- Definieer de verzameling als het doel van de implementatie in de variabele $DeployCollection
- Definieer de beschikbare implementatietijd op 25 november 2025 om 20:00 uur in de variabele $DeployAvailableTime
- Definieer de verlooptijd van de implementatie op 25 januari 2026 om 20:00 uur in de variabele $DeployExpireTime
- Definieer de implementatiedeadline op 25 december 2025 om 20:00 uur in de variabele $ScheduleDateTime
- Gebruik de cmdlet New-CMSchedule om een planningsobject voor de deadline te maken met een dagelijks terugkerend schema.
- De takenreeks implementeren
$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
Als u een implementatiewaarschuwing inschakelen, gebruikt u deze parameter om een tijd voor de waarschuwing op te geven.
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AllowFallback
Clients toestaan distributiepunten uit de standaardgrensgroep van de site te gebruiken.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AllowSharedContent
Toestaan dat clients distributiepunten van een grensgroep van de aangrenzende gebruiken.
Type: Boolean
Parameter Sets: (All)
Aliases: AllowUseRemoteDistributionPoint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Beschikbaarheid
Geef op of u deze takenreeks beschikbaar wilt maken voor Configuration Manager-clients en of deze beschikbaar is om te worden uitgevoerd wanneer u een besturingssysteem implementeert met behulp van opstartmedia, voorgefaseerd medium of 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
Geef op wanneer deze implementatie beschikbaar is.
Gebruik -DeadlineDateTime om op te geven wanneer de implementatie verloopt en -Schedule om de implementatietoewijzing of deadline op te geven.
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Collection
Geef een verzamelingsobject op als het doel voor deze takenreeksimplementatie. Gebruik de cmdlet Get-CMCollection om dit object op te halen.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionId
Geef een verzamelings-id op als het doel voor deze takenreeksimplementatie.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionName
Geef een verzamelingsnaam op als het doel voor deze takenreeksimplementatie.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-Opmerking
Geef een optionele opmerking op voor de takenreeksimplementatie.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeadlineDateTime
Gebruik deze parameter om op te geven wanneer de implementatie verloopt.
Gebruik -AvailableDateTime om op te geven wanneer de implementatie beschikbaar is en -Schedule om de implementatietoewijzing of deadline op te geven.
Type: DateTime
Parameter Sets: (All)
Aliases: DeploymentExpireDateTime
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeployPurpose
Geef op of deze implementatie beschikbaar is voor gebruikers om te installeren of dat deze moet worden geïnstalleerd op de deadline.
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
Geef op hoe clients communiceren met de distributiepunten om inhoud voor de takenreeks op te halen. Niet alle opties zijn beschikbaar in specifieke scenario's. Zie Deploy a task sequence - Deployment options (Een takenreeks implementeren - Implementatieopties) voor meer informatie.
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
Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributeCollectionName
De site distribueert inhoud naar de distributiepuntgroepen die zijn gekoppeld aan deze verzamelingsnaam.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributeContent
Voeg deze parameter toe om de takenreeksinhoud te distribueren wanneer u deze implementatie maakt. Clients kunnen de takenreeks pas installeren als u inhoud distribueert naar distributiepunten die de clients kunnen openen.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributionPointGroupName
De site distribueert inhoud naar deze distributiepuntgroep.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributionPointName
De site distribueert inhoud naar dit distributiepunt.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Hiermee geeft u een takenreeksobject te implementeren. Gebruik de cmdlet Get-CMTaskSequence om een takenreeksobject op te halen.
Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases: TaskSequence
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-InternetOption
Toestaan dat de takenreeks wordt uitgevoerd voor clients op internet.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PercentFailure
Als u een waarschuwing voor mislukte implementaties maakt, genereert de site een waarschuwing wanneer het percentage mislukte implementaties hoger is dan dit aantal.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PercentSuccess
Als u een waarschuwing voor geslaagde implementaties maakt, genereert de site een waarschuwing wanneer het percentage geslaagde implementaties lager is dan dit aantal.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PersistOnWriteFilterDevice
Configureer hoe de client omgaat met het schrijffilter op Windows Embedded-apparaten.
$true: Wijzigingen aanbrengen bij de deadline of tijdens een onderhoudsvenster. Opnieuw opstarten is vereist.$false: Pas inhoud toe op de overlay en pas deze later door.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RerunBehavior
Geef op of de takenreeks opnieuw wordt uitgevoerd op een computer als deze eerder werd uitgevoerd vóór de geplande verplichte tijd. Standaard wordt de takenreeks altijd opnieuw uitgevoerd.
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
Gebruikers toestaan het programma onafhankelijk van toewijzingen uit te voeren.
Type: Boolean
Parameter Sets: (All)
Aliases: AllowUsersRunIndependently
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Schedule
Gebruik deze parameter om de implementatietoewijzing of deadline op te geven.
Gebruik -AvailableDateTime om op te geven wanneer de implementatie beschikbaar is en -DeadlineDateTime om op te geven wanneer de implementatie verloopt.
Geef een matrix met planningsobjecten op. Een planningsobject definieert de verplichte toewijzingsplanning voor een implementatie. Als u een planningsobject wilt maken, gebruikt u de cmdlet New-CMSchedule.
Type: IResultObject[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ScheduleEvent
Hiermee geeft u een matrix van gebeurtenissen die bepalen wanneer de takenreeksimplementatie wordt uitgevoerd.
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
Geeft aan of een wake-up pakket naar computers moet worden verzenden voordat de implementatie begint. Als deze waarde $True is, Configuration Manager een computer uit de slaapstand. Als deze waarde $False is, worden computers niet uit de slaapstand lapt. Om computers te laten ontwaken, moet u eerst 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
Geeft aan of een procesdialoogvenster voor een takenreeks moet worden weergegeven.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SoftwareInstallation
Wanneer de installatiedeadline is bereikt, stelt u deze parameter in op zodat de takenreeks $true buiten het onderhoudsvenster kan worden geïnstalleerd.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SystemRestart
Wanneer de installatiedeadline is bereikt, stelt u deze parameter in op zodat het systeem zo nodig buiten het onderhoudsvenster opnieuw $true kan worden opgestart.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-TaskSequencePackageId
Geef de id op van de takenreeks die moet worden geïmplementeerd.
Type: String
Parameter Sets: SearchPackageByIdMandatory
Aliases: PackageId, TaskSequenceId
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UseMeteredNetwork
Geeft aan of clients met een internetverbinding naar gebruik inhoud mogen downloaden na de installatiedeadline, wat extra kosten met zich mee kan brengen.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UseUtcForAvailableSchedule
Geeft aan of clientcomputers UTC-tijd gebruiken om de beschikbaarheid van een programma te bepalen. UTC-tijd maakt de takenreeks op hetzelfde moment beschikbaar voor alle computers.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UseUtcForExpireSchedule
Geeft aan of clientcomputers UTC-tijd gebruiken om de vervaldatum van een programma te bepalen. UTC-tijd maakt de takenreeks op hetzelfde moment beschikbaar voor alle computers.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.
INPUTS
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
OUTPUTS
IResultObject#SMS_Advertisement
OPMERKINGEN
Zorg ervoor dat u de planningsparameters op de juiste manier gebruikt:
-AvailableDateTime: geef op wanneer deze implementatie beschikbaar is.
-DeadlineDateTime: geef op wanneer de implementatie verloopt.
-Schedule: geef de implementatietoewijzing of deadline op.
RELATED LINKS
Get-CMTaskSequenceDeployment Set-CMTaskSequenceDeployment Remove-CMTaskSequenceDeployment