Share via

New-CMSoftwareUpdatePhase

  • Artikel

SYNOPSIS

Gebruik deze cmdlet om een implementatiefase voor software-updates te maken.

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

Vanaf versie 2002 gebruikt u deze cmdlet om een implementatiefase voor software-updates te maken.

EXAMPLES

Voorbeeld 1: Een software-updatefase maken

In dit voorbeeld wordt een software-updatefase met de naam MySUPhase gemaakt voor de verzameling met de naam MyCollection die alleen wordt weergegeven in Software Center.

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

PARAMETERS

-AlertDelta

Deze parameter is hetzelfde als de volgende instelling op de pagina Waarschuwingen van de wizard Fase toevoegen in de console: Offset van de deadlinetijd. Geef een geheel getal op voor de offset en geef vervolgens het periodetype op met de parameter AlertUnit.

Als u deze waarde wilt instellen, moet u de parameter EnableAlert gebruiken.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-AlertThresholdPercentage

Deze parameter is hetzelfde als de volgende instelling op de pagina Waarschuwingen van de wizard Fase toevoegen in de -console: Client compliance is below the following (percent). Geef een geheel getal op voor het percentage. Als u deze waarde wilt instellen, moet u de parameter EnableAlert gebruiken.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-AlertUnit

Geef het type punt op. Gebruik deze parameter met 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

Deze parameter is hetzelfde als de volgende instelling op de pagina Download Instellingen van de wizard Fase toevoegen in de -console: Clients met een internetverbinding met een datameter toestaan inhoud te downloaden na de installatiedeadline, wat extra kosten met zich mee kan brengen.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AllowSystemRestart

Deze parameter is hetzelfde als de volgende instelling op de pagina Gebruikerservaring van de wizard Fase toevoegen in de -console: Systeem opnieuw opstarten (indien nodig om de installatie te voltooien). Deze instelling is van toepassing wanneer de installatiedeadline is bereikt, zodat deze activiteit buiten het onderhoudsvenster kan worden uitgevoerd.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AllowWumuFallback

Deze parameter is hetzelfde als de volgende instelling op de pagina Download Instellingen van de wizard Fase toevoegen in de -console: Als er geen software-updates beschikbaar zijn op het distributiepunt in huidige, aangrenzende of sitegrensgroepen, downloadt u inhoud van Microsoft Updates .

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-BeginCondition

Geef een optie op voor het begin van deze fase van de implementatie na het slagen van de vorige fase:

  • AfterPeriod: Deze parameter is hetzelfde als de volgende instelling op de pagina Fase Instellingen van de wizard Fase toevoegen in de console: deze fase automatisch starten na een uitstelperiode (in dagen). Als u deze waarde opgeeft, gebruikt u DaysAfterPreviousPhaseSuccess om de periode te configureren.

  • Manually: Deze parameter is hetzelfde als de volgende instelling op de pagina Fase Instellingen van de wizard Fase toevoegen in de -console: Deze fase van de implementatie handmatig starten.

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

-Collection

Geef een -object op voor de doelverzameling.

Type: IResultObject
Parameter Sets: SearchByCollection
Aliases:

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

-CollectionId

Geef de doelverzameling op id op.

Type: String
Parameter Sets: SearchByCollectionId
Aliases:

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

-CollectionName

Geef de doelverzameling op naam op.

Type: String
Parameter Sets: SearchByCollectionName
Aliases:

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

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

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

-CriteriaOption

Geef een optie op om de criteria voor het slagen van de vorige fase te kiezen:

  • Compliance: Deze parameter is hetzelfde als de volgende instelling op de pagina Fase Instellingen van de wizard Fase toevoegen in de console: Percentage implementatie geslaagd. Geef de percentagewaarde op met de parameter CriteriaValue.

  • Number: Deze parameter is hetzelfde als de volgende instelling op de pagina Fase Instellingen van de wizard Fase toevoegen in de -console: Aantal apparaten is geïmplementeerd. Geef het aantal apparaten op met de parameter 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

Deze gehele waarde is afhankelijk van de waarde die u opgeeft voor CriteriaOption:

  • Compliance: Geef het percentage op

  • Number: Geef het aantal apparaten op

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DaysAfterPreviousPhaseSuccess

Geef een geheel getal op voor het aantal dagen na het slagen van de vorige fase om met deze fase te beginnen. Deze parameter is dezelfde als de volgende instelling op de pagina Fase Instellingen van de wizard Fase toevoegen in de console: deze fase automatisch starten na een uitstelperiode (in dagen).

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DeadlineUnit

Geef het type deadlineperiode op. Gebruik deze parameter met 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

Deze parameter wordt alleen gebruikt als u AfterPeriod opgeeft met de InstallationChoice parameter.

Geef een geheel getal op voor de periode voor de deadline. Gebruik de parameter DeadlineUnit om het type periode op te geven: Hours , , , Days Weeks Months . Deze parameter is dezelfde als de volgende instelling op de pagina Fase Instellingen van de wizard Fase toevoegen in de -console: Installatie is vereist na deze periode.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DisableScomAlert

Deze parameter is hetzelfde als de volgende instelling op de pagina Waarschuwingen van de wizard Fase toevoegen in de -console: Schakel Operations Manager waarschuwingen uit terwijl software-updates worden uitgevoerd.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-DisableWildcardHandling

Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-EnableAlert

Deze parameter is hetzelfde als de volgende instelling op de pagina Waarschuwingen van de wizard Fase toevoegen in de -console: Genereer een waarschuwing wanneer aan de volgende voorwaarden wordt voldaan. Wanneer u deze parameter in stelt op $true , stelt u ook de volgende parameters in:

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

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

-EnableWakeOnLan

Deze parameter is hetzelfde als de volgende instelling op de pagina Implementatie Instellingen van de wizard Fase toevoegen in de -console: Wake-on-LAN gebruiken om clients te laten ontwaken voor vereiste implementaties.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag. Dit wordt niet aanbevolen. U kunt deze niet combineren met DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-GeneratescomAlertOnFailure

Deze parameter is hetzelfde als de volgende instelling op de pagina Waarschuwingen van de wizard Fase toevoegen in de -console: Genereer Operations Manager waarschuwing wanneer de installatie van een software-update mislukt.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-InstallationChoice

Geef een optie op voor het gedrag ten opzichte van wanneer de software beschikbaar wordt gesteld:

  • AsSoonAsPossible: Deze parameter is hetzelfde als de volgende instelling op de pagina Fase Instellingen van de wizard Fase toevoegen in de -console: Installatie is zo snel mogelijk vereist.

  • AfterPeriod: Deze parameter is hetzelfde als de volgende instelling op de pagina Fase Instellingen van de wizard Fase toevoegen in de -console: Installatie is vereist na deze periode. Als u deze waarde opgeeft, gebruikt u DeadlineUnit en DeadlineValue om de periode te configureren.

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

Geef een beschrijving op voor de fase.

Type: String
Parameter Sets: (All)
Aliases:

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

-PhaseName

Geef een naam op voor de beschrijving.

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

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

-RequirePostRebootFullScan

Deze parameter is hetzelfde als de volgende instelling op de pagina Gebruikerservaring van de wizard Fase toevoegen in de -console: als voor een update in deze implementatie een herstart van het systeem is vereist, moet u de evaluatiecyclus voor de implementatie van updates uitvoeren na het opnieuw opstarten.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-ServerRestartSuppression

Deze parameter is hetzelfde als de volgende instelling op de pagina Gebruikerservaring van de wizard Fase toevoegen in de -console. Onderdruk het opnieuw opstarten van het systeem op de volgende apparaten: Servers.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-SoftwareInstallation

Deze parameter is hetzelfde als de volgende instelling op de pagina Gebruikerservaring van de wizard Fase toevoegen in de -console: Software-installatie. Deze instelling is van toepassing wanneer de installatiedeadline is bereikt, zodat deze activiteit buiten het onderhoudsvenster kan worden uitgevoerd.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-StateMessageVerbosity

Deze parameter is hetzelfde als de volgende instelling op de pagina Implementatie Instellingen van de wizard Fase toevoegen in de console: Detailniveau statusbericht met de volgende waarden:

  • AllMessages: Alle berichten
  • OnlySuccessAndErrorMessages: Alleen succes- en foutberichten
  • OnlyErrorMessages: Alleen foutberichten
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

Geef een geheel getal op voor het aantal dagen dat deze software geleidelijk beschikbaar moet worden gemaakt. Deze parameter is dezelfde als de volgende instelling op de pagina Fase Instellingen van de wizard Fase toevoegen in de -console: maak deze software geleidelijk beschikbaar gedurende deze periode (in dagen).

Type: Int32
Parameter Sets: (All)
Aliases:

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

-UseNeighborDP

Deze parameter is hetzelfde als de volgende instelling op de pagina Download Instellingen van de wizard Fase toevoegen in de -console: Selecteer de implementatieoptie die u wilt gebruiken wanneer een client een distributiepunt van een grensgroep van de buren of de standaardgrensgroep van de site gebruikt. Geef de volgende waarden op:

  • $true: Software-updates downloaden vanaf het distributiepunt en installeren
  • $false: Installeer geen software-updates
Type: Boolean
Parameter Sets: (All)
Aliases:

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

-UseSiteDefaultDP

Deze parameter is dezelfde als de volgende instelling op de pagina Download Instellingen van de wizard Fase toevoegen in de -console: Wanneer software-updates niet beschikbaar zijn op distributiepunten in de grensgroep voor huidige of aangrenzende omgevingen, kan de client software-updates downloaden en installeren vanaf distributiepunten in de standaardgrensgroep van de site. Geef de volgende waarden op:

  • $true: Software-updates downloaden en installeren vanaf de distributiepunten in de standaardgrensgroep van de site
  • $false: Installeer geen software-updates
Type: Boolean
Parameter Sets: (All)
Aliases:

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

-UserNotificationOption

Deze parameter is hetzelfde als de volgende instelling op de pagina Gebruikerservaring van de wizard Fase toevoegen in de -console: Geef de gebruikerservaringinstelling voor deze implementatie op met de volgende waarden:

  • DisplayAll: Weergeven in Software Center en alle meldingen weergeven
  • DisplaySoftwareCenterOnly: weergeven in Software Center en alleen meldingen weergeven voor het opnieuw opstarten van computers
  • HideAll: Verbergen in Software Center en alle meldingen
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

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

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

-WorkstationRestartSuppression

Deze parameter is hetzelfde als de volgende instelling op de pagina Gebruikerservaring van de wizard Fase toevoegen in de -console. Onderdruk het opnieuw opstarten van het systeem op de volgende apparaten: Werkstations.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-WriteFilterCommit

Deze parameter is hetzelfde als de volgende instelling op de pagina Gebruikerservaring van de wizard Fase toevoegen in de -console: Wijzigingen aanbrengen bij deadline of tijdens een onderhoudsvenster (opnieuw opstarten vereist). Deze instelling is van toepassing op de verwerking van schrijffilters Windows Embedded-apparaten.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

CommonParameters

Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.

INPUTS

Geen

OUTPUTS

Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase

OPMERKINGEN