Share via

New-CMSoftwareUpdatePhase

  • Artikel

SYNOPSIS

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

SYNTAX

SearchByCollection

New-CMSoftwareUpdatePhase [-AlertDelta <Int32>] [-AlertThresholdPercentage <Int32>] [-AlertUnit <TimeUnitType>]
 [-AllowMeteredConnection <Boolean>] [-AllowSystemRestart <Boolean>] [-AllowWumuFallback <Boolean>]
 [-BeginCondition <BeginConditionType>] [-Collection] <IResultObject> [-CriteriaOption <CriteriaType>]
 [-CriteriaValue <Int32>] [-DaysAfterPreviousPhaseSuccess <Int32>] [-DeadlineUnit <TimeUnitType>]
 [-DeadlineValue <Int32>] [-DisableScomAlert <Boolean>] [-EnableAlert <Boolean>] [-EnableWakeOnLan <Boolean>]
 [-GenerateScomAlertOnFailure <Boolean>] [-InstallationChoice <InstallationChoiceType>]
 [-PhaseDescription <String>] -PhaseName <String> [-RequirePostRebootFullScan <Boolean>]
 [-ServerRestartSuppression <Boolean>] [-SoftwareInstallation <Boolean>]
 [-StateMessageVerbosity <VerbosityLevelType>] [-ThrottlingDays <Int32>] [-UseNeighborDP <Boolean>]
 [-UserNotificationOption <UserNotificationType>] [-UseSiteDefaultDP <Boolean>]
 [-WorkstationRestartSuppression <Boolean>] [-WriteFilterCommit <Boolean>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByCollectionId

New-CMSoftwareUpdatePhase [-AlertDelta <Int32>] [-AlertThresholdPercentage <Int32>] [-AlertUnit <TimeUnitType>]
 [-AllowMeteredConnection <Boolean>] [-AllowSystemRestart <Boolean>] [-AllowWumuFallback <Boolean>]
 [-BeginCondition <BeginConditionType>] [-CollectionId] <String> [-CriteriaOption <CriteriaType>]
 [-CriteriaValue <Int32>] [-DaysAfterPreviousPhaseSuccess <Int32>] [-DeadlineUnit <TimeUnitType>]
 [-DeadlineValue <Int32>] [-DisableScomAlert <Boolean>] [-EnableAlert <Boolean>] [-EnableWakeOnLan <Boolean>]
 [-GenerateScomAlertOnFailure <Boolean>] [-InstallationChoice <InstallationChoiceType>]
 [-PhaseDescription <String>] -PhaseName <String> [-RequirePostRebootFullScan <Boolean>]
 [-ServerRestartSuppression <Boolean>] [-SoftwareInstallation <Boolean>]
 [-StateMessageVerbosity <VerbosityLevelType>] [-ThrottlingDays <Int32>] [-UseNeighborDP <Boolean>]
 [-UserNotificationOption <UserNotificationType>] [-UseSiteDefaultDP <Boolean>]
 [-WorkstationRestartSuppression <Boolean>] [-WriteFilterCommit <Boolean>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByCollectionName

New-CMSoftwareUpdatePhase [-AlertDelta <Int32>] [-AlertThresholdPercentage <Int32>] [-AlertUnit <TimeUnitType>]
 [-AllowMeteredConnection <Boolean>] [-AllowSystemRestart <Boolean>] [-AllowWumuFallback <Boolean>]
 [-BeginCondition <BeginConditionType>] [-CollectionName] <String> [-CriteriaOption <CriteriaType>]
 [-CriteriaValue <Int32>] [-DaysAfterPreviousPhaseSuccess <Int32>] [-DeadlineUnit <TimeUnitType>]
 [-DeadlineValue <Int32>] [-DisableScomAlert <Boolean>] [-EnableAlert <Boolean>] [-EnableWakeOnLan <Boolean>]
 [-GenerateScomAlertOnFailure <Boolean>] [-InstallationChoice <InstallationChoiceType>]
 [-PhaseDescription <String>] -PhaseName <String> [-RequirePostRebootFullScan <Boolean>]
 [-ServerRestartSuppression <Boolean>] [-SoftwareInstallation <Boolean>]
 [-StateMessageVerbosity <VerbosityLevelType>] [-ThrottlingDays <Int32>] [-UseNeighborDP <Boolean>]
 [-UserNotificationOption <UserNotificationType>] [-UseSiteDefaultDP <Boolean>]
 [-WorkstationRestartSuppression <Boolean>] [-WriteFilterCommit <Boolean>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Från och med version 2002 använder du denna cmdlet för att skapa en distributionsfasen för programuppdatering.

EXAMPLES

Exempel 1: Skapa en programuppdateringsfas

Det här exemplet skapar en programuppdateringsfas med namnet MySUPhase för samlingen med namnet MyCollection som endast visas i Software Center.

New-CMSoftwareUpdatePhase `
 -CollectionName "MyCollection" `
 -PhaseName "MySUPhase" `
 -UserNotificationOption DisplaySoftwareCenterOnly

PARAMETERS

-AlertDelta

Den här parametern är samma som följande inställning på sidan Aviseringar i guiden Lägg till fas i konsolen: Förskjutning från tidsgränsen. Ange ett heltalsvärde för förskjutningen och ange sedan periodtypen med parametern AlertUnit.

Om du vill ange det här värdet måste du använda parametern EnableAlert.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-AlertThresholdPercentage

Den här parametern är samma som följande inställning på sidan Aviseringar i guiden Lägg till fas i -konsolen: Klientefterlevnad är lägre än följande (procent). Ange ett heltalsvärde för procentandelen. Om du vill ange det här värdet måste du använda parametern EnableAlert.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-AlertUnit

Ange typen av period. Använd den här parametern med AlertDelta.

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

-AllowMeteredConnection

Den här parametern är samma som följande inställning på sidan Nedladdningsinställningar i guiden Lägg till fas i -konsolen: Tillåt klienter på en avgiftsuppladdad Internetanslutning att ladda ned innehåll efter installationens tidsgräns, vilket kan medföra ytterligare kostnader.

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

-AllowWumuFallback

Den här parametern är samma som följande inställning på sidan Nedladdningsinställningar i guiden Lägg till fas i -konsolen: Om programuppdateringar inte är tillgängliga på distributionsplatsen i aktuella grupper, grann- eller platsgränsgrupper, laddar du ned innehåll från Microsoft Updates.

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 Fasinställningar i guiden Lägg till fas i -konsolen: Starta automatiskt den här fasen efter en upp skjuta upp -period (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 Fasinstä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

-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 i föregående fas:

  • Compliance: Den här parametern är samma som följande inställning på sidan Fasinstä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 Fasinstä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 lyckades för att påbörja den här fasen. Den här parametern är samma som följande inställning på sidan Fasinställningar i guiden Lägg till fas i -konsolen: Starta automatiskt den här fasen 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 Fasinstä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

-DisableScomAlert

Den här parametern är samma som följande inställning på sidan Aviseringar i guiden Lägg till fas i -konsolen: Inaktivera aviseringar Operations Manager medan programuppdateringar kör.

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

-EnableAlert

Den här parametern är samma som följande inställning på sidan Aviseringar i guiden Lägg till fas i konsolen: Generera en avisering när följande villkor är uppfyllda. När du ställer in den här $true parametern på anger du även följande parametrar:

  • AlertThresholdPercentage
  • AlertDelta
Type: Boolean
Parameter Sets: (All)
Aliases:

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

-EnableWakeOnLan

Den här parametern är samma som följande inställning på sidan Distributionsinställningar i guiden Lägg till fas i -konsolen: Använd Wake-on-LAN för att väcka klienter för nödvändiga distributioner.

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

-GenerateScomAlertOnFailure

Den här parametern är samma som följande inställning på sidan Aviseringar i guiden Lägg till fas i -konsolen: Generera en Operations Manager-avisering när en programuppdateringsinstallation misslyckas.

Type: Boolean
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 Fasinstä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 Fasinstä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

-PhaseDescription

Ange en beskrivning av fasen.

Type: String
Parameter Sets: (All)
Aliases:

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

-PhaseName

Ange ett namn för beskrivningen.

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

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

-RequirePostRebootFullScan

Den här parametern är samma som följande inställning på sidan Användarupplevelse i guiden Lägg till fas i -konsolen: Om någon uppdatering i den här distributionen kräver en systemstart kör du utvärderingscykeln för uppdateringsdistribution efter omstart.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-ServerRestartSuppression

Den här parametern är samma som följande inställning på sidan Användarupplevelse i guiden Lägg till fas i -konsolen. Ignorera systemstarten på följande enheter: Servrar.

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

-StateMessageVerbosity

Den här parametern är samma som följande inställning på sidan Distributionsinställningar i guiden Lägg till fas i konsolen: Detaljnivå för tillståndsmeddelande med följande värden:

  • AllMessages: Alla meddelanden
  • OnlySuccessAndErrorMessages: Endast lyckade meddelanden och felmeddelanden
  • OnlyErrorMessages: Endast felmeddelanden
Type: VerbosityLevelType
Parameter Sets: (All)
Aliases:
Accepted values: AllMessages, OnlySuccessAndErrorMessages, OnlyErrorMessages

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

-UseNedockborDP

Den här parametern är samma som följande inställning på sidan Hämta Inställningar 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 granne-gränsgrupp eller standardplatsgränsgruppen . Ange följande värden:

  • $true: Ladda ned programuppdateringar från distributionsplatsen och installera
  • $false: Installera inte programuppdateringar
Type: Boolean
Parameter Sets: (All)
Aliases:

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

-UseSiteDefaultDP

Den här parametern är samma som följande inställning på sidan Hämta Inställningar i guiden Lägg till fas i -konsolen: När programuppdateringar inte är tillgängliga på någon distributionsplats i den aktuella gränsgruppen eller granngränsgruppen kan klienten ladda ned och installera programuppdateringar från distributionsplatser i platsens standardgränsgrupp. Ange följande värden:

  • $true: Hämta och installera programuppdateringar från distributionsplatserna i platsens standardgränsgrupp
  • $false: Installera inte programuppdateringar
Type: Boolean
Parameter Sets: (All)
Aliases:

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

-UserNotificationOption

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
  • DisplaySoftwareCenterOnly: Visas i Software Center och visar endast meddelanden om omstarter av datorn
  • HideAll: Dölj i Software Center och alla meddelanden
Type: UserNotificationType
Parameter Sets: (All)
Aliases:
Accepted values: DisplayAll, DisplaySoftwareCenterOnly, 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

-WorkstationRestartSuppression

Den här parametern är samma som följande inställning på sidan Användarupplevelse i guiden Lägg till fas i -konsolen. Ignorera systemstarten på följande enheter: Arbetsstationer.

Type: Boolean
Parameter Sets: (All)
Aliases:

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.

INPUTS

Ingen

OUTPUTS

Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase

ANTECKNINGAR