Delen via


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.

Get-CMTaskSequenceDeployment Set-CMTaskSequenceDeployment Remove-CMTaskSequenceDeployment

Get-CMTaskSequence

Een takenreeks implementeren