New-CMTaskSequenceAutoPhasedDeployment

  • Artikel

SYNOPSIS

Använd den här cmdleten för att skapa en stegvis distribution för en aktivitetssekvens genom att generera två faser med samma inställningar.

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

Från och med version 2002 använder du denna cmdlet för att skapa en stegvis distribution för en aktivitetssekvens genom att generera två faser med samma inställningar. Den här cmdletens beteende är detsamma som guiden Skapa fasindelade distribution i en aktivitetssekvens, när du väljer alternativet för att automatiskt skapa en distribution med två standardfaser.

Anteckning

Innan du skapar en fasad distribution ska du se till att distribuera aktivitetssekvensinnehållet till en distributionsplats.

EXAMPLES

Exempel 1: Skapa en distribution efter aktivitetssekvensnamn

I det här exemplet skapas en ny aktivitetssekvensfasdistribution med namnet myDPName för aktivitetssekvensen 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"

Exempel 2: Skapa en distribution med indataaktivitetssekvensobjekt

I det här exemplet skapas en ny aktivitetssekvensfasad distribution med namnet myPDName för ett piped-aktivitetssekvensobjekt.

$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

Denna cmdlet skapar automatiskt två faser för de angivna två samlingarna. Du kan också lägga till fler faser med den här parametern. Ange en matris med faser. Använd New-CMTaskSequencePhase för att skapa faserna.

Type: Phase[]
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 andra fasen av distributionen efter att den första fasen har lyckats:

  • AfterPeriod: Den här parametern är samma som följande inställning på sidan Inställningar i guiden Skapa fasindelade distribution i -konsolen: Starta automatiskt den här fasen efter en uppsenningsperiod (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 Inställningar i guiden Skapa fasindelade distribution i -konsolen: Starta distributionen av den andra fasen 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

-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 den första fasen:

  • Compliance: Den här parametern är samma som följande inställning på sidan Inställningar i guiden Skapa fasindelade distribution i -konsolen: Distributionen lyckades i procent. Ange procentvärdet med parametern CriteriaValue.

  • Number: Den här parametern är samma som följande inställning Inställningar i guiden Skapa fasindelade distribution 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 den första fasen har lyckats för att påbörja den andra fasen. Den här parametern är samma som följande inställning på sidan Inställningar i guiden Skapa fasindelade distribution i -konsolen: Starta automatiskt den här fasen efter en uppsenningsperiod (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 Inställningar i guiden Skapa fasindelade distribution 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

-Beskrivning

Ange en beskrivning för den fasfasade distributionen av aktivitetssekvensen.

Type: String
Parameter Sets: (All)
Aliases:

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

-FirstCollection

Ange ett samlingsobjekt för den första fasen.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-FirstCollectionId

Ange ett samlings-ID för den första fasen.

Type: String
Parameter Sets: (All)
Aliases:

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

-FirstCollectionName

Ange ett samlingsnamn för den första fasen.

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

-InsertAtOrder

Om du använder parametern AddPhases använder du den här parametern för att avgöra i vilken ordning faser ska infoga de ytterligare faserna. Ange ett heltal med ordernumret.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
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 Inställningar i guiden Skapa fasindelade distribution i -konsolen: Installation krävs så snart som möjligt.

  • AfterPeriod: Den här parametern är samma som följande inställning på sidan Inställningar i guiden Skapa fasindelade distribution 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

-Name

Ange ett namn för den aktivitetssekvensfasade distributionen.

Type: String
Parameter Sets: (All)
Aliases:

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

-SecondCollection

Ange ett samlingsobjekt för den andra fasen.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-SecondCollectionId

Ange ett samlings-ID för den andra fasen.

Type: String
Parameter Sets: (All)
Aliases:

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

-SecondCollectionName

Ange ett samlingsnamn för den andra fasen.

Type: String
Parameter Sets: (All)
Aliases:

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

-TaskSequence

Ange ett aktivitetssekvensobjekt.

Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:

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

-TaskSequenceId

Ange en aktivitetssekvens efter ID.

Type: String
Parameter Sets: SearchByIdMandatory
Aliases: TaskSequencePackageId

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

-TaskSequenceName

Ange en aktivitetssekvens efter namn.

Type: String
Parameter Sets: SearchByNameMandatory
Aliases:

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

-ThrottlingDays

Ange ett heltalsvärde för antalet dagar för att gradvis göra programvaran tillgänglig. Den här parametern är samma som följande inställning på sidan Inställningar i guiden Skapa stegvis distribution i -konsolen: Gör programvaran tillgänglig gradvis 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

-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

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.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

IResultObject#SMS_PhasedDeployment

ANTECKNINGAR