New-CMTaskSequenceAutoPhasedDeployment

SYNOPSIS

Pomocí této rutiny můžete vytvořit postupné nasazení pro pořadí úkolů vygenerováním dvou fází se stejným nastavením.

SYNTAX

SearchByValueMandatory

New-CMTaskSequenceAutoPhasedDeployment [-TaskSequence] <IResultObject> [-AddPhases <Phase[]>]
 [-BeginCondition <BeginConditionType>] [-CriteriaOption <CriteriaType>] [-CriteriaValue <Int32>]
 [-DaysAfterPreviousPhaseSuccess <Int32>] [-DeadlineUnit <TimeUnitType>] [-DeadlineValue <Int32>]
 [-FirstCollection <IResultObject>] [-FirstCollectionId <String>] [-FirstCollectionName <String>]
 [-InsertAtOrder <Int32>] [-InstallationChoice <InstallationChoiceType>] [-SecondCollection <IResultObject>]
 [-SecondCollectionId <String>] [-SecondCollectionName <String>] [-ThrottlingDays <Int32>]
 [-Description <String>] -Name <String> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
 [-Confirm] [<CommonParameters>]

SearchByIdMandatory

New-CMTaskSequenceAutoPhasedDeployment [-TaskSequenceId] <String> [-AddPhases <Phase[]>]
 [-BeginCondition <BeginConditionType>] [-CriteriaOption <CriteriaType>] [-CriteriaValue <Int32>]
 [-DaysAfterPreviousPhaseSuccess <Int32>] [-DeadlineUnit <TimeUnitType>] [-DeadlineValue <Int32>]
 [-FirstCollection <IResultObject>] [-FirstCollectionId <String>] [-FirstCollectionName <String>]
 [-InsertAtOrder <Int32>] [-InstallationChoice <InstallationChoiceType>] [-SecondCollection <IResultObject>]
 [-SecondCollectionId <String>] [-SecondCollectionName <String>] [-ThrottlingDays <Int32>]
 [-Description <String>] -Name <String> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
 [-Confirm] [<CommonParameters>]

SearchByNameMandatory

New-CMTaskSequenceAutoPhasedDeployment [-TaskSequenceName] <String> [-AddPhases <Phase[]>]
 [-BeginCondition <BeginConditionType>] [-CriteriaOption <CriteriaType>] [-CriteriaValue <Int32>]
 [-DaysAfterPreviousPhaseSuccess <Int32>] [-DeadlineUnit <TimeUnitType>] [-DeadlineValue <Int32>]
 [-FirstCollection <IResultObject>] [-FirstCollectionId <String>] [-FirstCollectionName <String>]
 [-InsertAtOrder <Int32>] [-InstallationChoice <InstallationChoiceType>] [-SecondCollection <IResultObject>]
 [-SecondCollectionId <String>] [-SecondCollectionName <String>] [-ThrottlingDays <Int32>]
 [-Description <String>] -Name <String> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
 [-Confirm] [<CommonParameters>]

DESCRIPTION

Od verze 2002 použijte tuto rutinu k vytvoření postupného nasazení pro pořadí úkolů vygenerováním dvou fází se stejným nastavením. Chování této rutiny je stejné jako v průvodci vytvořením postupného nasazení v pořadí úkolů, když vyberete možnost Automaticky vytvořit výchozí dvoufázové nasazení.

Poznámka

Před vytvořením postupného nasazení nezapomeňte distribuovat obsah pořadí úkolů do distribučního bodu.

EXAMPLES

Příklad 1: Vytvoření nasazení podle názvu pořadí úkolů

Tento příklad vytvoří nové postupné nasazení pořadí úkolů s názvem myDPName pro pořadí úkolů myTaskSequenceName.

New-CMTaskSequenceAutoPhasedDeployment -TaskSequenceName "myTaskSequenceName" -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"

Příklad 2: Vytvoření nasazení podle vstupního objektu pořadí úkolů

Tento příklad vytvoří nové postupné nasazení pořadí úkolů s názvem myPDName pro objekt pořadí úkolů s kanálem.

$myTS | New-CMTaskSequenceAutoPhasedDeployment -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"

PARAMETERS

-AddPhases

Tato rutina automaticky vytvoří dvě fáze pro zadané dvě kolekce. S tímto parametrem můžete také přidat další fáze. Zadejte pole fází. K vytvoření fází použijte New-CMTaskSequencePhase.

Type: Phase[]
Parameter Sets: (All)
Aliases:

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

-BeginCondition

Zadejte možnost pro zahájení druhé fáze nasazení po úspěchu první fáze:

  • AfterPeriod: Tento parametr je stejný jako následující nastavení na stránce Nastavení Průvodce vytvořením postupného nasazení v konzole nástroje : Automaticky zahajte tuto fázi po období odkladu (ve dnech). Pokud zadáte tuto hodnotu, nakonfigurujte časové období pomocí funkce DaysAfterPreviousPhaseSuccess.

  • Manually: Tento parametr je stejný jako následující nastavení na stránce Nastavení Průvodce vytvořením postupného nasazení v konzole nástroje : Ručně zahajte nasazení druhé fáze.

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

-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 první fáze:

  • Compliance: Tento parametr je stejný jako následující nastavení na stránce Nastavení Průvodce vytvořením postupného nasazení v konzole nástroje : Procento úspěšnosti nasazení. Zadejte procentuální hodnotu pomocí parametru CriteriaValue.

  • Number: Tento parametr je stejný jako následující nastavení na stránce Nastavení v Průvodci vytvořením postupného nasazení v konzole nástroje : Počet zařízení úspěšně nasazených. Zadejte počet zařízení pomocí parametru 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 jako 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

Zadejte celočíselnou hodnotu pro počet dní po úspěchu první fáze, aby se zahájí druhá fáze. Tento parametr je stejný jako následující nastavení na stránce Nastavení v Průvodci vytvořením postupného nasazení v konzole nástroje : Automaticky zahajte tuto fázi po 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í konečného termínu. Tento parametr použijte s parametrem 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ě, AfterPeriod že zadáte parametr InstallationChoice.

Zadejte celočíselnou hodnotu pro časové období konečného termínu. K určení typu období použijte parametr DeadlineUnit: Hours , , , Days Weeks Months . Tento parametr je stejný jako následující nastavení na stránce Nastavení Průvodce vytvořením postupného nasazení v konzole nástroje : Instalace se vyžaduje po uplynutí tohoto časového období.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-Description (Popis)

Zadejte popis postupného nasazení pořadí úkolů.

Type: String
Parameter Sets: (All)
Aliases:

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

-DisableWildcardHandling

Tento parametr považuje zástupné znaky za hodnoty literálových znaků. Nemůžete ho kombinovat s forceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-FirstCollection

Určete objekt kolekce pro první fázi.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-FirstCollectionId

Zadejte ID kolekce pro první fázi.

Type: String
Parameter Sets: (All)
Aliases:

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

-FirstCollectionName

Zadejte název kolekce pro první fázi.

Type: String
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 to. Nemůžete ho kombinovat s příkazem DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-InsertAtOrder

Pokud použijete parametr AddPhases, použijte tento parametr k určení místa v pořadí fází pro vložení dalších fází. Zadejte celé číslo s číslem objednávky.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-InstallationChoice

Určete možnost chování vzhledem k tomu, kdy je software k dispozici:

  • AsSoonAsPossible: Tento parametr je stejný jako následující nastavení na stránce Nastavení Průvodce vytvořením postupného nasazení v konzole nástroje : Instalace se vyžaduje co nejdříve.

  • AfterPeriod: Tento parametr je stejný jako následující nastavení na stránce Nastavení Průvodce vytvořením postupného nasazení v konzole nástroje : Instalace se vyžaduje po uplynutí tohoto časového období. Pokud zadáte tuto hodnotu, nakonfigurujte časové období pomocí vlastností 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

-Name

Zadejte název postupného nasazení pořadí úkolů.

Type: String
Parameter Sets: (All)
Aliases:

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

-SecondCollection

Určete objekt kolekce pro druhou fázi.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-SecondCollectionId

Zadejte ID kolekce pro druhou fázi.

Type: String
Parameter Sets: (All)
Aliases:

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

-SecondCollectionName

Zadejte název kolekce pro druhou fázi.

Type: String
Parameter Sets: (All)
Aliases:

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

-TaskSequence

Zadejte objekt pořadí úkolů.

Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:

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

-TaskSequenceId

Zadejte pořadí úkolů podle ID.

Type: String
Parameter Sets: SearchByIdMandatory
Aliases: TaskSequencePackageId

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

-TaskSequenceName

Zadejte pořadí úkolů podle názvu.

Type: String
Parameter Sets: SearchByNameMandatory
Aliases:

Required: True
Position: 0
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 Nastavení Průvodce vytvořením postupného nasazení v konzole nástroje : Tento software postupně získejte 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

-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

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.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

IResultObject#SMS_PhasedDeployment

POZNÁMKY