Share via

New-CMTaskSequencePhase

  • Artikel

SYNOPSIS

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

SYNTAX

SearchByCollection

New-CMTaskSequencePhase [-AllowFallback <Boolean>] [-AllowRemoteDP <Boolean>] [-AllowSystemRestart <Boolean>]
 [-BeginCondition <BeginConditionType>] [-Collection] <IResultObject> [-Comments <String>]
 [-CriteriaOption <CriteriaType>] [-CriteriaValue <Int32>] [-DaysAfterPreviousPhaseSuccess <Int32>]
 [-DeadlineUnit <TimeUnitType>] [-DeadlineValue <Int32>] [-DeploymentOption <DeploymentOptionType>]
 [-InstallationChoice <InstallationChoiceType>] -PhaseName <String> [-PreDownload <Boolean>]
 [-SoftwareInstallation <Boolean>] [-ThrottlingDays <Int32>] [-UserNotification <UserNotificationType>]
 [-WriteFilterCommit <Boolean>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

SearchByCollectionId

New-CMTaskSequencePhase [-AllowFallback <Boolean>] [-AllowRemoteDP <Boolean>] [-AllowSystemRestart <Boolean>]
 [-BeginCondition <BeginConditionType>] [-CollectionId] <String> [-Comments <String>]
 [-CriteriaOption <CriteriaType>] [-CriteriaValue <Int32>] [-DaysAfterPreviousPhaseSuccess <Int32>]
 [-DeadlineUnit <TimeUnitType>] [-DeadlineValue <Int32>] [-DeploymentOption <DeploymentOptionType>]
 [-InstallationChoice <InstallationChoiceType>] -PhaseName <String> [-PreDownload <Boolean>]
 [-SoftwareInstallation <Boolean>] [-ThrottlingDays <Int32>] [-UserNotification <UserNotificationType>]
 [-WriteFilterCommit <Boolean>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

SearchByCollectionName

New-CMTaskSequencePhase [-AllowFallback <Boolean>] [-AllowRemoteDP <Boolean>] [-AllowSystemRestart <Boolean>]
 [-BeginCondition <BeginConditionType>] [-CollectionName] <String> [-Comments <String>]
 [-CriteriaOption <CriteriaType>] [-CriteriaValue <Int32>] [-DaysAfterPreviousPhaseSuccess <Int32>]
 [-DeadlineUnit <TimeUnitType>] [-DeadlineValue <Int32>] [-DeploymentOption <DeploymentOptionType>]
 [-InstallationChoice <InstallationChoiceType>] -PhaseName <String> [-PreDownload <Boolean>]
 [-SoftwareInstallation <Boolean>] [-ThrottlingDays <Int32>] [-UserNotification <UserNotificationType>]
 [-WriteFilterCommit <Boolean>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

DESCRIPTION

Från och med version 2002 använder du den här cmdleten för att skapa en distributionsfasen för en aktivitetssekvens.

EXAMPLES

Exempel 1: Skapa en aktivitetssekvensfas

I det här exemplet skapas en aktivitetssekvensfas med namnet MyTSPhase för samlingen med namnet MyCollection.

New-CMTaskSequencePhase -CollectionName "MyCollection" -PhaseName "MyTSPhase" -UserNotification DisplayAll -AllowRemoteDP $true

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: SearchByCollection
Aliases:

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

-CollectionId

Ange målsamlingen efter ID.

Type: String
Parameter Sets: SearchByCollectionId
Aliases:

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

-CollectionName

Ange målsamlingen efter namn.

Type: String
Parameter Sets: SearchByCollectionName
Aliases:

Required: True
Position: 0
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

-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

-PhaseName

Ange ett namn för fasen.

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

Required: True
Position: Named
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 för att gradvis göra programvaran tillgänglig. 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: Visas i Software Center och visar 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 en underhållsfönstret (kräver omstart). 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.

INPUTS

Ingen

OUTPUTS

Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase

ANTECKNINGAR