Set-CMTaskSequencePhase

Artikel
08/12/2021

SYNOPSIS

Gebruik deze cmdlet om een implementatiefase voor een takenreeks te configureren.

SYNTAX

SearchByPhasedDeployment

Set-CMTaskSequencePhase [-AllowFallback <Boolean>] [-AllowRemoteDP <Boolean>] [-AllowSystemRestart <Boolean>]
 [-Comments <String>] [-DeploymentOption <DeploymentOptionType>] [-PreDownload <Boolean>]
 [-SoftwareInstallation <Boolean>] [-UserNotification <UserNotificationType>] [-WriteFilterCommit <Boolean>]
 [-BeginCondition <BeginConditionType>] [-CriteriaOption <CriteriaType>] [-CriteriaValue <Int32>]
 [-DaysAfterPreviousPhaseSuccess <Int32>] [-DeadlineUnit <TimeUnitType>] [-DeadlineValue <Int32>]
 [-InstallationChoice <InstallationChoiceType>] [-MovePhase <ReorderType>] [-MoveToOrder <Int32>]
 [-NewCollection <IResultObject>] [-NewCollectionId <String>] [-NewCollectionName <String>]
 [-NewPhaseName <String>] [-ThrottlingDays <Int32>] [-Collection <IResultObject>] [-CollectionId <String>]
 [-CollectionName <String>] [-Id <String>] [-InputObject] <IResultObject> [-Name <String>] [-Order <Int32>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByPhasedDeploymentId

Set-CMTaskSequencePhase [-AllowFallback <Boolean>] [-AllowRemoteDP <Boolean>] [-AllowSystemRestart <Boolean>]
 [-Comments <String>] [-DeploymentOption <DeploymentOptionType>] [-PreDownload <Boolean>]
 [-SoftwareInstallation <Boolean>] [-UserNotification <UserNotificationType>] [-WriteFilterCommit <Boolean>]
 [-BeginCondition <BeginConditionType>] [-CriteriaOption <CriteriaType>] [-CriteriaValue <Int32>]
 [-DaysAfterPreviousPhaseSuccess <Int32>] [-DeadlineUnit <TimeUnitType>] [-DeadlineValue <Int32>]
 [-InstallationChoice <InstallationChoiceType>] [-MovePhase <ReorderType>] [-MoveToOrder <Int32>]
 [-NewCollection <IResultObject>] [-NewCollectionId <String>] [-NewCollectionName <String>]
 [-NewPhaseName <String>] [-ThrottlingDays <Int32>] [-Collection <IResultObject>] [-CollectionId <String>]
 [-CollectionName <String>] [-Id <String>] [-Name <String>] [-Order <Int32>] [-PhasedDeploymentId] <String>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByPhasedDeploymentName

Set-CMTaskSequencePhase [-AllowFallback <Boolean>] [-AllowRemoteDP <Boolean>] [-AllowSystemRestart <Boolean>]
 [-Comments <String>] [-DeploymentOption <DeploymentOptionType>] [-PreDownload <Boolean>]
 [-SoftwareInstallation <Boolean>] [-UserNotification <UserNotificationType>] [-WriteFilterCommit <Boolean>]
 [-BeginCondition <BeginConditionType>] [-CriteriaOption <CriteriaType>] [-CriteriaValue <Int32>]
 [-DaysAfterPreviousPhaseSuccess <Int32>] [-DeadlineUnit <TimeUnitType>] [-DeadlineValue <Int32>]
 [-InstallationChoice <InstallationChoiceType>] [-MovePhase <ReorderType>] [-MoveToOrder <Int32>]
 [-NewCollection <IResultObject>] [-NewCollectionId <String>] [-NewCollectionName <String>]
 [-NewPhaseName <String>] [-ThrottlingDays <Int32>] [-Collection <IResultObject>] [-CollectionId <String>]
 [-CollectionName <String>] [-Id <String>] [-Name <String>] [-Order <Int32>] [-PhasedDeploymentName] <String>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Is van toepassing op versie 2006 en hoger. Gebruik deze cmdlet om een implementatiefase voor een takenreeks te configureren. Zie Gefaseerd implementeren maken voor meer informatie.

EXAMPLES

Voorbeeld 1: De verzameling wijzigen

In dit voorbeeld wordt de verzameling gewijzigd voor de tweede fase in de gefaseerd implementeren van de takenreeks die is doorgegeven op de opdrachtregel.

$phasedDeployment = Get-CMTaskSequencePhasedDeployment -Name "myPhasedDeployment"

$phasedDeployment | Set-CMTaskSequencePhase -Order 2 -NewCollectionId "XYZ00227"

Voorbeeld 2: Een fase omhoog verplaatsen

In dit voorbeeld wordt een fase in de volgorde omhoog verplaatst. De gefaseerd implementatie wordt geselecteerd op id en de fase wordt geselecteerd op de bijbehorende verzamelings-id.

Set-CMTaskSequencePhase -PhasedDeploymentId "0bc464d9-e7dd-44c1-a157-3f8be6a79c03" -CollectionId "XYZ00227" -MovePhase MoveUp

Voorbeeld 3: Fase-instellingen configureren

In dit voorbeeld worden de configuratie-instellingen voor de geselecteerde fase gewijzigd.

Set-CMTaskSequencePhase -PhasedDeploymentName "myPhasedDeployment" -Name "phase1" -UserNotification HideAll -SoftwareInstallation $true -AllowSystemRestart $true -WriteFilterCommit $false -PreDownload $true -Comments "phase 1 comment" -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -AllowRemoteDP $true -AllowFallback $false -CriteriaOption Compliance -CriteriaValue 90 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 3 -ThrottlingDays 5 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 12

PARAMETERS

-AllowFallback

Deze parameter is hetzelfde als de volgende instelling op de pagina Distributiepunten van de wizard Fase toevoegen in de -console: Clients toestaan distributiepunten van de standaardsitegrensgroep te gebruiken.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AllowRemoteDP

Deze parameter is hetzelfde als de volgende instelling op de pagina Distributiepunten van de wizard Fase toevoegen in de -console: Als er geen lokaal distributiepunt beschikbaar is, gebruikt u een extern distributiepunt.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AllowSystemRestart

Deze parameter is hetzelfde als de volgende instelling op de pagina Gebruikerservaring van de wizard Fase toevoegen in de -console: Systeem opnieuw opstarten (indien nodig om de installatie te voltooien). Deze instelling is van toepassing wanneer de installatiedeadline is bereikt, zodat deze activiteit buiten het onderhoudsvenster kan worden uitgevoerd.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-BeginCondition

Geef een optie op voor het begin van deze fase van de implementatie na het slagen van de vorige fase:

AfterPeriod: Deze parameter is hetzelfde als de volgende instelling op de pagina Fase Instellingen van de wizard Fase toevoegen in de console: deze fase automatisch starten na een uitstelperiode (in dagen). Als u deze waarde opgeeft, gebruikt u DaysAfterPreviousPhaseSuccess om de periode te configureren.
Manually: Deze parameter is hetzelfde als de volgende instelling op de pagina Fase Instellingen van de wizard Fase toevoegen in de -console: Deze fase van de implementatie handmatig starten.

Type: BeginConditionType
Parameter Sets: (All)
Aliases:
Accepted values: AfterPeriod, Manually

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

-Collection

Geef een object op voor de doelverzameling

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-CollectionId

Geef de doelverzameling op id op.

Type: String
Parameter Sets: (All)
Aliases:

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

-CollectionName

Geef de doelverzameling op naam op.

Type: String
Parameter Sets: (All)
Aliases:

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

-Opmerkingen

Geef optionele opmerkingen op voor deze fase. De maximale lengte is 512 tekens.

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

-CriteriaOption

Geef een optie op om de criteria voor het slagen van de vorige fase te kiezen:

Compliance: Deze parameter is hetzelfde als de volgende instelling op de pagina Fase Instellingen van de wizard Fase toevoegen in de console: Percentage implementatie geslaagd. Geef de percentagewaarde op met de parameter CriteriaValue.
Number: Deze parameter is hetzelfde als de volgende instelling op de pagina Fase Instellingen van de wizard Fase toevoegen in de -console: Aantal apparaten is geïmplementeerd. Geef het aantal apparaten op met de parameter CriteriaValue.

Type: CriteriaType
Parameter Sets: (All)
Aliases:
Accepted values: Compliance, Number

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

-CriteriaValue

Deze gehele waarde is afhankelijk van de waarde die u opgeeft voor CriteriaOption:

Compliance: Geef het percentage op
Number: Geef het aantal apparaten op

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DaysAfterPreviousPhaseSuccess

Geef een geheel getal op voor het aantal dagen na het slagen van de vorige fase om met deze fase te beginnen. Deze parameter is dezelfde als de volgende instelling op de pagina Fase Instellingen van de wizard Fase toevoegen in de console: deze fase automatisch starten na een uitstelperiode (in dagen).

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DeadlineUnit

Geef het type deadlineperiode op. Gebruik deze parameter met DeadlineValue.

Type: TimeUnitType
Parameter Sets: (All)
Aliases:
Accepted values: Hours, Days, Weeks, Months

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

-DeadlineValue

Deze parameter wordt alleen gebruikt als u AfterPeriod opgeeft met de InstallationChoice parameter.

Geef een geheel getal op voor de periode voor de deadline. Gebruik de parameter DeadlineUnit om het type periode op te geven: Hours , , , Days Weeks Months . Deze parameter is dezelfde als de volgende instelling op de pagina Fase Instellingen van de wizard Fase toevoegen in de -console: Installatie is vereist na deze periode.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DeploymentOption

Deze parameter is hetzelfde als de volgende instelling op de pagina Distributiepunten van de wizard Fase toevoegen in de -console: selecteer de implementatieoptie die u wilt gebruiken wanneer een client een distributiepunt van een grensgroep in de buurt of de standaardsitegrensgroep gebruikt. De volgende waarden worden geaccepteerd:

DownloadContentLocallyWhenNeededByRunningTaskSequence: Download inhoud lokaal wanneer dit nodig is voor de takenreeks die wordt uitgevoerd
DownloadAllContentLocallyBeforeStartingTaskSequence: Download alle inhoud lokaal voordat u de takenreeks start

Type: DeploymentOptionType
Parameter Sets: (All)
Aliases:
Accepted values: DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence

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. Dit wordt 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

-Id

Geef de id op van de fase die moet worden geconfigureerd.

Type: String
Parameter Sets: (All)
Aliases: PhaseId

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

-InputObject

Geef een gefaseerd implementatieobject op dat de te configureren fase bevat.

Type: IResultObject
Parameter Sets: SearchByPhasedDeployment
Aliases: PhasedDeployment

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

-InstallationChoice

Geef een optie op voor het gedrag ten opzichte van wanneer de software beschikbaar wordt gesteld:

AsSoonAsPossible: Deze parameter is hetzelfde als de volgende instelling op de pagina Fase Instellingen van de wizard Fase toevoegen in de -console: Installatie is zo snel mogelijk vereist.
AfterPeriod: Deze parameter is hetzelfde als de volgende instelling op de pagina Fase Instellingen van de wizard Fase toevoegen in de -console: Installatie is vereist na deze periode. Als u deze waarde opgeeft, gebruikt u DeadlineUnit en DeadlineValue om de periode te configureren.

Type: InstallationChoiceType
Parameter Sets: (All)
Aliases:
Accepted values: AsSoonAsPossible, AfterPeriod

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

-MovePhase

Wijzig de volgorde voor de geselecteerde fase. U kunt de index omhoog verplaatsen, één omlaag verplaatsen of naar een specifieke index gaan. Als u MoveToOrder opgeeft, gebruikt u de parameter -MoveToOrder om de specifieke index in te stellen.

Type: ReorderType
Parameter Sets: (All)
Aliases:
Accepted values: MoveUp, MoveDown, MoveToOrder

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

-MoveToOrder

Wanneer u de parameter -MovePhase in stelt op MoveToOrder , gebruikt u deze parameter om de specifieke index in te stellen.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-Name

Geef de naam op van de fase die u wilt configureren.

Type: String
Parameter Sets: (All)
Aliases: PhaseName

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

-NewCollection

Geef een verzamelingsobject op dat moet worden gebruikt als het nieuwe doel voor de geselecteerde fase.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-NewCollectionId

Geef een verzameling op id op die moet worden gebruikt als het nieuwe doel voor de geselecteerde fase.

Type: String
Parameter Sets: (All)
Aliases:

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

-NewCollectionName

Geef een verzameling op naam op die moet worden gebruikt als het nieuwe doel voor de geselecteerde fase.

Type: String
Parameter Sets: (All)
Aliases:

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

-NewPhaseName

Gebruik deze parameter om de naam van de geselecteerde fase te wijzigen.

Type: String
Parameter Sets: (All)
Aliases:

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

-Order

Geef de index op van de fase die moet worden geconfigureerd.

Type: Int32
Parameter Sets: (All)
Aliases: PhaseOrder

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

-PhasedDeploymentId

Selecteer de gefaseerd implementatie op id. Gebruik vervolgens andere parameters om de specifieke fase in die implementatie te selecteren.

Type: String
Parameter Sets: SearchByPhasedDeploymentId
Aliases:

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

-PhasedDeploymentName

Selecteer de gefaseerd implementatie op naam. Gebruik vervolgens andere parameters om de specifieke fase in die implementatie te selecteren.

Type: String
Parameter Sets: SearchByPhasedDeploymentName
Aliases:

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

-PreDownload

Deze parameter is hetzelfde als de volgende instelling op de pagina Algemeen van de wizard Fase toevoegen in de -console: Inhoud vooraf downloaden voor deze takenreeks.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-SoftwareInstallation

Deze parameter is hetzelfde als de volgende instelling op de pagina Gebruikerservaring van de wizard Fase toevoegen in de -console: Software-installatie. Deze instelling is van toepassing wanneer de installatiedeadline is bereikt, zodat deze activiteit buiten het onderhoudsvenster kan worden uitgevoerd.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-ThrottlingDays

Geef een geheel getal op voor het aantal dagen om deze software geleidelijk beschikbaar te maken. Deze parameter is dezelfde als de volgende instelling op de pagina Fase Instellingen van de wizard Fase toevoegen in de -console: Maak deze software geleidelijk beschikbaar gedurende deze periode (in dagen).

Type: Int32
Parameter Sets: (All)
Aliases:

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

-UserNotification

Deze parameter is hetzelfde als de volgende instelling op de pagina Gebruikerservaring van de wizard Fase toevoegen in de -console: Geef de gebruikerservaringinstelling voor deze implementatie op met de volgende waarden:

DisplayAll: Weergeven in Software Center en alle meldingen weergeven
HideAll: Verbergen in Software Center en alle meldingen

Type: UserNotificationType
Parameter Sets: (All)
Aliases:
Accepted values: DisplayAll, HideAll

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

-WriteFilterCommit

Deze parameter is hetzelfde als de volgende instelling op de pagina Gebruikerservaring van de wizard Fase toevoegen in de -console: Wijzigingen aanbrengen bij deadline of tijdens een onderhoudsvenster (opnieuw opstarten vereist). Deze instelling is van toepassing op de verwerking van schrijffilters Windows Embedded-apparaten.

Type: Boolean
Parameter Sets: (All)
Aliases:

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.