Set-CMTaskSequencePhase

Artikel
08/17/2021

SYNOPSIS

Använd den här cmdleten för att konfigurera en distributionsfasen för en aktivitetssekvens.

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

Gäller för version 2006 och senare. Använd den här cmdleten för att konfigurera en distributionsfasen för en aktivitetssekvens. Mer information finns i Skapa fasfasdistributioner.

EXAMPLES

Exempel 1: Ändra samlingen

Det här exemplet ändrar samlingen för den andra fasen i aktivitetssekvensfasdistributionen som skickas via kommandoraden.

$phasedDeployment = Get-CMTaskSequencePhasedDeployment -Name "myPhasedDeployment"

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

Exempel 2: Flytta upp en fas

I det här exemplet flyttas en fas uppåt i ordningen. Den väljer den fasindelade distributionen efter dess ID och väljer fasen efter det associerade samlings-ID:t.

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

Exempel 3: Konfigurera fasinställningar

I det här exemplet ändras konfigurationsinställningarna för den valda fasen.

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

Den här parametern är samma som följande inställning på sidan Distributionsplatser i guiden Lägg till fas i -konsolen: Tillåt att klienter använder distributionsplatser från standardplatsgränsgruppen.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AllowRemoteDP

Den här parametern är samma som följande inställning på sidan Distributionsplatser i guiden Lägg till fas i -konsolen: Använd en fjärrdistributionsplats när ingen lokal distributionsplats är tillgänglig.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AllowSystemRestart

Den här parametern är samma som följande inställning på sidan Användarupplevelse i guiden Lägg till fas i -konsolen: Systemstart (om det behövs för att slutföra installationen). Den här inställningen gäller när tidsgränsen för installationen nås för att tillåta att den här aktiviteten utförs utanför underhållsfönstret.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-BeginCondition

Ange ett alternativ för att börja den här fasen av distributionen efter att föregående fas har lyckats:

AfterPeriod: Den här parametern är samma som följande inställning på sidan Phase Inställningar i guiden Lägg till fas i -konsolen: Starta automatiskt den här fasen efter en uppsluppningsperiod (i dagar). Om du anger det här värdet använder du DaysAfterPreviousPhaseSuccess för att konfigurera tidsperioden.
Manually: Den här parametern är samma som följande inställning på sidan Phase Inställningar i guiden Lägg till fas i -konsolen: Starta den här fasen av distributionen manuellt.

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

-Samling

Ange ett objekt för målsamlingen

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-CollectionId

Ange målsamlingen efter ID.

Type: String
Parameter Sets: (All)
Aliases:

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

-CollectionName

Ange målsamlingen efter namn.

Type: String
Parameter Sets: (All)
Aliases:

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

-Kommentarer

Ange valfria kommentarer för den här fasen. Den maximala längden är 512 tecken.

Type: String
Parameter Sets: (All)
Aliases:

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

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-CriteriaOption

Ange ett alternativ för att välja kriterier för att lyckas med föregående fas:

Compliance: Den här parametern är samma som följande inställning på sidan Phase Inställningar i guiden Lägg till fas i -konsolen: Distributionen lyckades i procent. Ange procentvärdet med parametern CriteriaValue.
Number: Den här parametern är samma som följande inställning på sidan Phase Inställningar i guiden Lägg till fas i -konsolen: Antal enheter som har distribuerats. Ange antalet enheter med parametern 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

Det här heltalsvärdet beror på det värde som du anger för CriteriaOption:

Compliance: Ange procentandelen
Number: Ange antalet enheter

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DaysAfterPreviousPhaseSuccess

Ange ett heltalsvärde för antalet dagar efter att föregående fas har lyckats för att påbörja den här fasen. Den här parametern är samma som följande inställning på sidan Fas Inställningar i guiden Lägg till fas i -konsolen: Starta den här fasen automatiskt efter en uppsluppningsperiod (i dagar).

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DeadlineUnit

Ange typ av tidsgränsperiod. Använd den här parametern med 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

Den här parametern används bara om du anger AfterPeriod med parametern InstallationChoice.

Ange ett heltalsvärde för tidsperioden för tidsgränsen. Använd parametern DeadlineUnit för att ange typen av period: Hours , , , Days Weeks Months . Den här parametern är samma som följande inställning på sidan Phase Inställningar i guiden Lägg till fas i -konsolen: Installation krävs efter den här tidsperioden.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DeploymentOption

Den här parametern är samma som följande inställning på sidan Distributionsplatser i guiden Lägg till fas i -konsolen: Välj det distributionsalternativ som ska användas när en klient använder en distributionsplats från en granngränsgrupp eller standardplatsgränsgruppen. Den accepterar följande värden:

DownloadContentLocallyWhenNeededByRunningTaskSequence: Ladda ned innehåll lokalt när det behövs av aktivitetssekvensen som körs
DownloadAllContentLocallyBeforeStartingTaskSequence: Hämta allt innehåll lokalt innan du startar aktivitetssekvensen

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

Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Den här parametern bearbetar jokertecken och kan leda till oväntat beteende. Det rekommenderas inte. Du kan inte kombinera den med DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Id

Ange ID för fasen som ska konfigureras.

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

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

-InputObject

Ange ett fas fasat distributionsobjekt som innehåller fasen som ska konfigureras.

Type: IResultObject
Parameter Sets: SearchByPhasedDeployment
Aliases: PhasedDeployment

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

-InstallationChoice

Ange ett alternativ för beteendet i förhållande till när programvaran görs tillgänglig:

AsSoonAsPossible: Den här parametern är samma som följande inställning på sidan Phase Inställningar i guiden Lägg till fas i -konsolen: Installation krävs så snart som möjligt.
AfterPeriod: Den här parametern är samma som följande inställning på sidan Phase Inställningar i guiden Lägg till fas i -konsolen: Installation krävs efter den här tidsperioden. Om du anger det här värdet använder du DeadlineUnit och DeadlineValue för att konfigurera tidsperioden.

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

Ändra ordningen för den valda fasen. Du kan flytta upp en, flytta den nedåt ett eller flytta den till ett specifikt index. Om du anger MoveToOrder använder du parametern -MoveToOrder för att ange det specifika indexet.

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

När du anger parametern -MovePhase till MoveToOrder använder du den här parametern för att ange det specifika indexet.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-Name

Ange namnet på fasen som ska konfigureras.

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

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

-NewCollection

Ange ett samlingsobjekt som ska användas som det nya målet för den valda fasen.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-NewCollectionId

Ange en samling efter ID som ska användas som det nya målet för den valda fasen.

Type: String
Parameter Sets: (All)
Aliases:

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

-NewCollectionName

Ange en samling efter namn som ska användas som det nya målet för den valda fasen.

Type: String
Parameter Sets: (All)
Aliases:

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

-NewPhaseName

Använd den här parametern för att byta namn på den valda fasen.

Type: String
Parameter Sets: (All)
Aliases:

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

-Order

Ange indexet för fasen som ska konfigureras.

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

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

-PhasedDeploymentId

Välj den fasfasade distributionen efter ID. Använd sedan andra parametrar för att välja den specifika fasen i distributionen.

Type: String
Parameter Sets: SearchByPhasedDeploymentId
Aliases:

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

-PhasedDeploymentName

Välj den fasfasade distributionen efter namn. Använd sedan andra parametrar för att välja den specifika fasen i distributionen.

Type: String
Parameter Sets: SearchByPhasedDeploymentName
Aliases:

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

-PreDownload

Den här parametern är samma som följande inställning på sidan Allmänt i guiden Lägg till fas i -konsolen: Förnedladdning av innehåll för den här aktivitetssekvensen.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-SoftwareInstallation

Den här parametern är samma som följande inställning på sidan Användarupplevelse i guiden Lägg till fas i -konsolen: Programvaruinstallation. Den här inställningen gäller när tidsgränsen för installationen nås för att tillåta att den här aktiviteten utförs utanför underhållsfönstret.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-ThrottlingDays

Ange ett heltalsvärde för antalet dagar som programvaran ska vara tillgänglig gradvis. Den här parametern är samma som följande inställning på sidan Phase Inställningar i guiden Lägg till fas i -konsolen: Gör programvaran gradvis tillgänglig under den här tidsperioden (i dagar).

Type: Int32
Parameter Sets: (All)
Aliases:

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

-UserNotification

Den här parametern är samma som följande inställning på sidan Användarupplevelse i guiden Lägg till fas i konsolen: Ange användarupplevelseinställning för den här distributionen med följande värden:

DisplayAll: Visa i Software Center och visa alla meddelanden
HideAll: Dölj i Software Center och alla meddelanden

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

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

-WriteFilterCommit

Den här parametern är samma som följande inställning på sidan Användarupplevelse i guiden Lägg till fas i -konsolen: Genomför ändringar vid tidsgränsen eller under ett underhållsfönster (omstart krävs). Den här inställningen gäller för skrivfilterhantering för Windows Embedded-enheter.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

CommonParameters

Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.