Delen via


Start-CMTaskSequenceDeployment

SYNOPSIS

(Afgeschaft) Start een takenreeksimplementatie.

SYNTAX

SearchByValueMandatory (standaard)

Start-CMTaskSequenceDeployment [-AlertDateTime <DateTime>] [-AlertDay <DateTime>] [-AlertTime <DateTime>]
 [-AllowFallback <Boolean>] [-AllowSharedContent <Boolean>] [-Availability <MakeAvailableToType>]
 [-Collection <IResultObject>] [-CollectionId <String>] [-CollectionName <String>] [-Comment <String>]
 [-DeploymentAvailableDateTime <DateTime>] [-DeploymentAvailableDay <DateTime>]
 [-DeploymentAvailableTime <DateTime>] [-DeploymentExpireDateTime <DateTime>] [-DeploymentExpireDay <DateTime>]
 [-DeploymentExpireTime <DateTime>] [-DeploymentOption <DeploymentOptionType>]
 [-DeployPurpose <DeployPurposeType>] [-InputObject] <IResultObject> [-InternetOption <Boolean>] [-PassThru]
 [-PercentFailure <Int32>] [-PercentSuccess <Int32>] [-PersistOnWriteFilterDevice <Boolean>]
 [-RerunBehavior <RerunBehaviorType>] [-RunFromSoftwareCenter <Boolean>] [-Schedule <IResultObject[]>]
 [-ScheduleEvent <ScheduleEventType[]>] [-SendWakeupPacket <Boolean>] [-ShowTaskSequenceProgress <Boolean>]
 [-SoftwareInstallation <Boolean>] [-SystemRestart <Boolean>] [-UseMeteredNetwork <Boolean>]
 [-UseUtcForAvailableSchedule <Boolean>] [-UseUtcForExpireSchedule <Boolean>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchPackageByIdMandatory

Start-CMTaskSequenceDeployment [-AlertDateTime <DateTime>] [-AlertDay <DateTime>] [-AlertTime <DateTime>]
 [-AllowFallback <Boolean>] [-AllowSharedContent <Boolean>] [-Availability <MakeAvailableToType>]
 [-Collection <IResultObject>] [-CollectionId <String>] [-CollectionName <String>] [-Comment <String>]
 [-DeploymentAvailableDateTime <DateTime>] [-DeploymentAvailableDay <DateTime>]
 [-DeploymentAvailableTime <DateTime>] [-DeploymentExpireDateTime <DateTime>] [-DeploymentExpireDay <DateTime>]
 [-DeploymentExpireTime <DateTime>] [-DeploymentOption <DeploymentOptionType>]
 [-DeployPurpose <DeployPurposeType>] [-InternetOption <Boolean>] [-PassThru] [-PercentFailure <Int32>]
 [-PercentSuccess <Int32>] [-PersistOnWriteFilterDevice <Boolean>] [-RerunBehavior <RerunBehaviorType>]
 [-RunFromSoftwareCenter <Boolean>] [-Schedule <IResultObject[]>] [-ScheduleEvent <ScheduleEventType[]>]
 [-SendWakeupPacket <Boolean>] [-ShowTaskSequenceProgress <Boolean>] [-SoftwareInstallation <Boolean>]
 [-SystemRestart <Boolean>] [-TaskSequencePackageId] <String> [-UseMeteredNetwork <Boolean>]
 [-UseUtcForAvailableSchedule <Boolean>] [-UseUtcForExpireSchedule <Boolean>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Belangrijk

Deze cmdlet is afgeschaft. Gebruik in plaats daarvan New-CMTaskSequenceDeployment.

Gebruik deze cmdlet om een takenreeksimplementatie te starten. Een takenreeksimplementatie wijst een takenreeks toe aan een verzameling computers. Zie Deploy a task sequence in Configuration Manager (Een takenreeks implementeren in Configuration Manager.

Notitie

Voer Configuration Manager cmdlets uit vanaf Configuration Manager-sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.

EXAMPLES

Voorbeeld 1: Een takenreeksimplementatie starten met standaardopties

Met deze opdracht wordt een takenreeksimplementatie gestart met behulp van de naam van de takenreeksimplementatie en de naam van een verzameling.

Get-CMTaskSequence -Name "Upgrade Windows 10" | Start-CMTaskSequenceDeployment -CollectionName "Collection 01"

Voorbeeld 2: Een takenreeksimplementatie starten met geconfigureerde opties

Met deze opdracht wordt een takenreeksimplementatie gestart met verschillende geconfigureerde opties.

Start-CMTaskSequenceDeployment -TaskSequencePackageId "XYZ00003" -CollectionName "Collection 02" -Comment "Task sequence test" -DeployPurpose Required -SendWakeUpPacket $True -UseMeteredNetwork $True -ScheduleEvent AsSoonAsPossible -RerunBehavior NeverRerunDeployedProgram -RunFromSoftwareCenter $True -ShowTaskSequenceProgress $False -SoftwareInstallation $True -SystemRestart $True -PersistOnWriteFilterDevice $False -AllowFallback $True -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -AllowSharedContent $True -InternetOption $True

PARAMETERS

-AlertDateTime

Wanneer u de implementatie configureert om een waarschuwing te maken voor een geslaagde implementatie, gebruikt u deze parameter om een DateTime-object op te geven. Configuration Manager maakt een implementatiewaarschuwing wanneer de drempelwaarde lager is dan de PercentSuccess na deze datum.

Gebruik de ingebouwde cmdlet Get-Date om dit object op te halen.

Type: DateTime
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AlertDay

Deze parameter is afgeschaft. Gebruik AlertDateTime.

Type: DateTime
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AlertTime

Deze parameter is afgeschaft. Gebruik AlertDateTime.

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.

Als u Clients opgeeft, is de standaardwaarde voor de parameter DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence . Als u ClientsMediaAndPxe , MediaAndPxe of MediaAndPxeHidden opgeeft, is de standaardwaarde voor de parameter DeploymentOption DownloadContentLocallyWhenNeededByRunningTaskSequence .

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

-Collection

Geef een verzamelingsobject op waarop deze takenreeks is geïmplementeerd. 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 de id op van de verzameling waarop deze takenreeks is geïmplementeerd.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-CollectionName

Geef de naam op van de verzameling waarop deze takenreeks is geïmplementeerd.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-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: False
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

-DeploymentAvailableDateTime

Geef een DateTime-object op voor wanneer deze implementatie beschikbaar is. Gebruik de ingebouwde cmdlet Get-Date om dit object op te halen.

Gebruik DeploymentExpireDateTime om op te geven wanneer de implementatie verloopt en Schema 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

-DeploymentAvailableDay

Deze parameter is afgeschaft. Gebruik DeploymentAvailableDateTime.

Type: DateTime
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DeploymentAvailableTime

Deze parameter is afgeschaft. Gebruik DeploymentAvailableDateTime.

Type: DateTime
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DeploymentExpireDateTime

Geef een DateTime-object op voor wanneer deze implementatie verloopt. Gebruik de ingebouwde cmdlet Get-Date om dit object op te halen.

Gebruik DeploymentAvailableDateTime om op te geven wanneer de implementatie beschikbaar is en Schema 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

-DeploymentExpireDay

Deze parameter is afgeschaft. Gebruik DeploymentExpireDateTime.

Type: DateTime
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DeploymentExpireTime

Deze parameter is afgeschaft. Gebruik DeploymentExpireDateTime.

Type: DateTime
Parameter Sets: (All)
Aliases:

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.

Als u Clients opgeeft als beschikbaarheidsparameter, is de standaardwaarde voor deze parameter DownloadAllContentLocallyBeforeStartingTaskSequence . Als u ClientsMediaAndPxe , MediaAndPxe of opgeeft als MediaAndPxeHidden beschikbaarheidsparameter, is de standaardwaarde voor deze parameter DownloadContentLocallyWhenNeededByRunningTaskSequence .

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

-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

Geef een takenreeksimplementatieobject op. Gebruik de cmdlet Get-CMTaskSequenceDeployment om dit object op te halen.

Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-InternetOption

Geeft aan of de takenreeks wordt uitgevoerd op clients die verbinding maken via internet.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PassThru

Voeg deze parameter toe om een object te retourneren dat het item vertegenwoordigt waarmee u werkt. Standaard is het mogelijk dat deze cmdlet geen uitvoer genereert.

Type: SwitchParameter
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

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: False
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

New-CMTaskSequenceDeployment Get-CMTaskSequenceDeployment Set-CMTaskSequenceDeployment Remove-CMTaskSequenceDeployment

Een takenreeks implementeren in Configuration Manager