Set-CMTaskSequencePhase

Článek
08/12/2021

SYNOPSIS

Pomocí této rutiny můžete nakonfigurovat fázi nasazení pro pořadí úkolů.

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

Platí pro verzi 2006 a novější. Pomocí této rutiny můžete nakonfigurovat fázi nasazení pro pořadí úkolů. Další informace najdete v tématu Vytvoření dvoufázové nasazení.

EXAMPLES

Příklad 1: Změna kolekce

V tomto příkladu se změní kolekce druhé fáze ve fázi nasazení pořadí úkolů předané v příkazovém řádku.

$phasedDeployment = Get-CMTaskSequencePhasedDeployment -Name "myPhasedDeployment"

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

Příklad 2: přesunutí fáze nahoru

Tento příklad přesune fázi nahoru v pořadí. Vybere postupné nasazení podle jeho ID a vybere fázi pomocí přidruženého ID kolekce.

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

Příklad 3: Konfigurace nastavení fáze

Tento příklad změní nastavení konfigurace pro vybranou fázi.

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

Tento parametr je stejný jako následující nastavení na stránce distribuční body v Průvodci přidáním fáze v konzole: umožňuje klientům používat distribuční body z výchozí skupiny hranic lokality.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AllowRemoteDP

Tento parametr je stejný jako následující nastavení na stránce distribuční body v Průvodci přidáním fáze v konzole: není- li místní distribuční bod k dispozici, použijte vzdálený distribuční bod.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AllowSystemRestart

Tento parametr je stejný jako následující nastavení na stránce činnost koncového uživatele v Průvodci přidáním fáze v konzole: restart systému (Pokud je to nutné pro dokončení instalace). Toto nastavení platí po dosažení konečného termínu instalace, aby bylo možné tuto aktivitu provést mimo časové období údržby.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-BeginCondition

Zadejte možnost zahájení této fáze nasazení po úspěšném provedení předchozí fáze:

AfterPeriod: tento parametr je stejný jako následující nastavení na stránce fáze Nastavení průvodce přidáním fáze v konzole: automaticky zahájí tuto fázi po uplynutí období odložení (ve dnech). Pokud zadáte tuto hodnotu, nakonfigurujte časové období pomocí DaysAfterPreviousPhaseSuccess .
Manually: tento parametr je stejný jako následující nastavení na stránce Nastavení fáze průvodce přidáním fáze v konzole: ruční zahájení této fáze nasazení.

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

– Kolekce

Zadejte objekt pro cílovou kolekci

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-CollectionId

Zadejte cílovou kolekci podle ID.

Type: String
Parameter Sets: (All)
Aliases:

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

-CollectionName

Zadejte cílovou kolekci podle názvu.

Type: String
Parameter Sets: (All)
Aliases:

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

– Komentáře

Zadejte volitelné komentáře pro tuto fázi. Maximální délka je 512 znaků.

Type: String
Parameter Sets: (All)
Aliases:

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

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

-CriteriaOption

Zadejte možnost výběru kritérií pro úspěch předchozí fáze:

Compliance: tento parametr je stejný jako následující nastavení na stránce fáze Nastavení průvodce přidáním fáze v konzole: procento úspěšnosti nasazení. Zadejte procentuální hodnotu parametru CriteriaValue .
Number: tento parametr je stejný jako následující nastavení na stránce fáze Nastavení průvodce přidáním fáze v konzole: počet úspěšně nasazených zařízení. Zadejte počet zařízení s parametrem 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

Tato celočíselná hodnota závisí na hodnotě, kterou zadáte pro CriteriaOption:

Compliance: Zadejte procento
Number: Zadejte počet zařízení

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DaysAfterPreviousPhaseSuccess

Chcete-li zahájit tuto fázi, zadejte celočíselnou hodnotu pro počet dní po úspěchu předchozí fáze. tento parametr je stejný jako následující nastavení na stránce fáze Nastavení průvodce přidáním fáze v konzole: automaticky zahájí tuto fázi po uplynutí období odložení (ve dnech).

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DeadlineUnit

Zadejte typ období termínu. Použijte tento parametr s 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

Tento parametr se používá pouze v případě, že zadáte AfterPeriod parametr InstallationChoice .

Zadejte celočíselnou hodnotu pro časové období konečného termínu. Použijte parametr DeadlineUnit k určení typu období: Hours , Days , Weeks , Months . tento parametr je stejný jako následující nastavení na stránce Nastavení fáze průvodce přidáním fáze v konzole: instalace se vyžaduje po tomto časovém intervalu.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DeploymentOption

Tento parametr je stejný jako následující nastavení na stránce distribuční body v Průvodci přidáním fáze v konzole: Vyberte možnost nasazení, která se použije, když klient použije distribuční bod ze sousední skupiny hranic nebo výchozí skupiny hranic lokality. Přijímá následující hodnoty:

DownloadContentLocallyWhenNeededByRunningTaskSequence: Stáhnout obsah místně, pokud to vyžaduje běžící pořadí úloh
DownloadAllContentLocallyBeforeStartingTaskSequence: Před spuštěním pořadí úloh stáhnout veškerý obsah místně

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

Tento parametr považuje zástupné znaky jako literálové hodnoty znaků. Nejde kombinovat s ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Tento parametr zpracovává zástupné znaky a může vést k neočekávanému chování. Nedoporučuje se. Nejde kombinovat s DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

– ID

Zadejte ID fáze, která se má nakonfigurovat.

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

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

– Položky InputObject

Zadejte objekt postupného nasazení, který obsahuje fázi, která se má nakonfigurovat.

Type: IResultObject
Parameter Sets: SearchByPhasedDeployment
Aliases: PhasedDeployment

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

-InstallationChoice

Zadejte možnost pro chování relativně k době, kdy je software zpřístupněný:

AsSoonAsPossible: tento parametr je stejný jako následující nastavení na stránce fáze Nastavení průvodce přidáním fáze v konzole: instalace je vyžadována co nejdříve.
AfterPeriod: tento parametr je stejný jako následující nastavení na stránce Nastavení fáze průvodce přidáním fáze v konzole: instalace se vyžaduje po tomto časovém intervalu. Pokud zadáte tuto hodnotu, nakonfigurujte časové období pomocí DeadlineUnit a DeadlineValue .

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

Změna pořadí vybrané fáze. Můžete ho přesunout nahoru, přesunout ho dolů nebo přesunout do konkrétního indexu. Pokud zadáte MoveToOrder , použijte k nastavení konkrétního indexu parametr -MoveToOrder .

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

Když nastavíte parametr -MovePhase na MoveToOrder , použijte tento parametr k nastavení konkrétního indexu.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-Name

Zadejte název fáze, která se má nakonfigurovat.

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

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

-NewCollection

Zadejte objekt kolekce, který má být použit jako nový cíl pro vybranou fázi.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-NewCollectionId

Zadejte kolekci podle ID, která se má použít jako nový cíl pro vybranou fázi.

Type: String
Parameter Sets: (All)
Aliases:

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

-NewCollectionName

Zadejte kolekci podle názvu, který se použije jako nový cíl pro vybranou fázi.

Type: String
Parameter Sets: (All)
Aliases:

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

-NewPhaseName

Tento parametr slouží k přejmenování vybrané fáze.

Type: String
Parameter Sets: (All)
Aliases:

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

– Pořadí

Zadejte index fáze, která se má nakonfigurovat.

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

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

– PhasedDeploymentId

Vyberte dvoufázové nasazení podle ID. Pak pomocí dalších parametrů vyberte konkrétní fázi v tomto nasazení.

Type: String
Parameter Sets: SearchByPhasedDeploymentId
Aliases:

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

-PhasedDeploymentName

Vyberte postupné nasazení podle názvu. Pak pomocí dalších parametrů vyberte konkrétní fázi v tomto nasazení.

Type: String
Parameter Sets: SearchByPhasedDeploymentName
Aliases:

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

-PreDownload

Tento parametr je stejný jako následující nastavení na stránce Obecné v Průvodci přidáním fáze v konzole nástroje : Předběžné stažení obsahu pro toto pořadí úkolů.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-SoftwareInstallation

Tento parametr je stejný jako následující nastavení na stránce Uživatelské prostředí v Průvodci přidáním fáze v konzole nástroje : Instalace softwaru. Toto nastavení platí při dosažení konečného termínu instalace, aby bylo možné tuto aktivitu provést mimo okno údržby.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-ThrottlingDays

Zadejte celočíselnou hodnotu pro počet dní, po které bude software postupně dostupný. Tento parametr je stejný jako následující nastavení na stránce Fáze Nastavení v Průvodci přidáním fáze v konzole nástroje : Postupně získejte tento software dostupný v tomto časovém období (ve dnech).

Type: Int32
Parameter Sets: (All)
Aliases:

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

-UserNotification

Tento parametr je stejný jako následující nastavení na stránce Uživatelské prostředí Průvodce přidáním fáze v konzole nástroje : Zadejte nastavení uživatelského prostředí pro toto nasazení s následujícími hodnotami:

DisplayAll: Zobrazení v Centru softwaru a zobrazení všech oznámení
HideAll: Skrýt v Centru softwaru a všechna oznámení

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

Zobrazuje, co by se stalo při spuštění rutiny. Rutina se nespouštěl.

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

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

-WriteFilterCommit

Tento parametr je stejný jako následující nastavení na stránce Uživatelské prostředí v Průvodci přidáním fáze v konzole nástroje : Potvrzení změn v termínu nebo během okna údržby (vyžaduje restart). Toto nastavení platí pro zpracování filtru zápisu pro Windows Embedded.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

CommonParameters

Tato rutina podporuje společné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v tématu about_CommonParameters.