New-CMSoftwareUpdatePhase

Článek
08/12/2021

SYNOPSIS

Tuto rutinu použijte k vytvoření fáze nasazení pro aktualizaci softwaru.

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

Počínaje verzí 2002 použijte tuto rutinu k vytvoření fáze nasazení pro aktualizaci softwaru.

EXAMPLES

Příklad 1: vytvoření fáze aktualizace softwaru

Tento příklad vytvoří fázi aktualizace softwaru s názvem MySUPhase pro kolekci s názvem myCollection , která se zobrazí pouze v centru softwaru.

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

PARAMETERS

-AlertDelta

Tento parametr je stejný jako následující nastavení na stránce výstrahy v Průvodci přidáním fáze v konzole: posun od času konečného termínu. Zadejte celočíselnou hodnotu pro posun a pak zadejte typ periody s parametrem AlertUnit .

Chcete-li nastavit tuto hodnotu, je nutné použít parametr EnableAlert .

Type: Int32
Parameter Sets: (All)
Aliases:

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

-AlertThresholdPercentage

Tento parametr je stejný jako následující nastavení na stránce výstrahy v Průvodci přidáním fáze v konzole: Shoda klienta je nižší než následující hodnota (v procentech). Zadejte celočíselnou hodnotu pro procento. Chcete-li nastavit tuto hodnotu, je nutné použít parametr EnableAlert .

Type: Int32
Parameter Sets: (All)
Aliases:

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

-AlertUnit

Zadejte typ období. Použijte tento parametr s 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

tento parametr je stejný jako následující nastavení na stránce stáhnout Nastavení v průvodci přidáním fáze v konzole: umožňuje klientům na měřeném připojení k internetu stahovat obsah po uplynutí konečného termínu instalace, což může mít za následek další náklady.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AllowSystemRestart

Tento parametr je stejný jako následující nastavení na stránce činnost koncového uživatele v Průvodci přidáním fáze v konzole: restart systému (Pokud je to nutné pro dokončení instalace). Toto nastavení platí po dosažení konečného termínu instalace, aby bylo možné tuto aktivitu provést mimo časové období údržby.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AllowWumuFallback

tento parametr je stejný jako následující nastavení na stránce stáhnout Nastavení v průvodci přidáním fáze v konzole nástroje: pokud nejsou aktualizace softwaru dostupné v distribučním bodě v aktuálních, sousedních nebo hraničních skupinách lokality, stáhněte obsah z aktualizací microsoftu.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-BeginCondition

Zadejte možnost zahájení této fáze nasazení po úspěšném provedení předchozí fáze:

AfterPeriod: tento parametr je stejný jako následující nastavení na stránce fáze Nastavení průvodce přidáním fáze v konzole: automaticky zahájí tuto fázi po uplynutí období odložení (ve dnech). Pokud zadáte tuto hodnotu, nakonfigurujte časové období pomocí DaysAfterPreviousPhaseSuccess .
Manually: tento parametr je stejný jako následující nastavení na stránce Nastavení fáze průvodce přidáním fáze v konzole: ruční zahájení této fáze nasazení.

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

– Kolekce

Zadejte objekt pro cílovou kolekci.

Type: IResultObject
Parameter Sets: SearchByCollection
Aliases:

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

-CollectionId

Zadejte cílovou kolekci podle ID.

Type: String
Parameter Sets: SearchByCollectionId
Aliases:

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

-CollectionName

Zadejte cílovou kolekci podle názvu.

Type: String
Parameter Sets: SearchByCollectionName
Aliases:

Required: True
Position: 0
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 předchozí fáze:

Compliance: tento parametr je stejný jako následující nastavení na stránce fáze Nastavení průvodce přidáním fáze v konzole: procento úspěšnosti nasazení. Zadejte procentuální hodnotu parametru CriteriaValue .
Number: tento parametr je stejný jako následující nastavení na stránce fáze Nastavení průvodce přidáním fáze v konzole: počet úspěšně nasazených zařízení. Zadejte počet zařízení s parametrem 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 pro 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

Chcete-li zahájit tuto fázi, zadejte celočíselnou hodnotu pro počet dní po úspěchu předchozí fáze. tento parametr je stejný jako následující nastavení na stránce fáze Nastavení průvodce přidáním fáze v konzole: automaticky zahájí tuto fázi po uplynutí období 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í termínu. Použijte tento parametr s 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ě, že zadáte AfterPeriod parametr InstallationChoice .

Zadejte celočíselnou hodnotu pro časové období konečného termínu. Použijte parametr DeadlineUnit k určení typu období: Hours , Days , Weeks , Months . tento parametr je stejný jako následující nastavení na stránce Nastavení fáze průvodce přidáním fáze v konzole: instalace se vyžaduje po tomto časovém intervalu.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DisableScomAlert

Tento parametr je stejný jako následující nastavení na stránce výstrahy v Průvodci přidáním fáze v konzole: při spuštění aktualizací softwaru zakažte výstrahy Operations Manager.

Type: Boolean
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 jako literálové hodnoty znaků. Nejde kombinovat s ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-EnableAlert

Tento parametr je stejný jako následující nastavení na stránce výstrahy v Průvodci přidáním fáze v konzole: vygenerujte výstrahu, pokud jsou splněné následující podmínky. Když nastavíte tento parametr na $true , nastavte také následující parametry:

AlertThresholdPercentage
AlertDelta

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-EnableWakeOnLan

tento parametr je stejný jako následující nastavení na stránce Nastavení nasazení průvodce přidáním fáze v konzole: pomocí funkce wake-on-LAN probudit klienty pro požadovaná nasazení.

Type: Boolean
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. Nejde kombinovat s DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-GenerateScomAlertOnFailure

Tento parametr je stejný jako následující nastavení na stránce výstrahy v Průvodci přidáním fáze v konzole: vygenerovat Operations Manager výstrahu, když se instalace aktualizace softwaru nezdařila.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-InstallationChoice

Zadejte možnost pro chování relativně k době, kdy je software zpřístupněný:

AsSoonAsPossible: tento parametr je stejný jako následující nastavení na stránce fáze Nastavení průvodce přidáním fáze v konzole: instalace je vyžadována co nejdříve.
AfterPeriod: tento parametr je stejný jako následující nastavení na stránce Nastavení fáze průvodce přidáním fáze v konzole: instalace se vyžaduje po tomto časovém intervalu. Pokud zadáte tuto hodnotu, nakonfigurujte časové období pomocí 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

-PhaseDescription

Zadejte popis fáze.

Type: String
Parameter Sets: (All)
Aliases:

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

-3fázová

Zadejte název popisu.

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

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

-RequirePostRebootFullScan

Tento parametr je stejný jako následující nastavení na stránce činnost koncového uživatele v Průvodci přidáním fáze v konzole: Pokud nějaká aktualizace v tomto nasazení vyžaduje restart systému, spusťte po restartování cyklus vyhodnocení nasazení aktualizací.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-ServerRestartSuppression

Tento parametr je stejný jako následující nastavení na stránce činnost koncového uživatele v Průvodci přidáním fáze v konzole nástroje. Potlačí restartování systému na následujících zařízeních: servery.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-SoftwareInstallation

Tento parametr je stejný jako následující nastavení na stránce činnost koncového uživatele v Průvodci přidáním fáze v konzole: Instalace softwaru. Toto nastavení platí po dosažení konečného termínu instalace, aby bylo možné tuto aktivitu provést mimo časové období údržby.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-StateMessageVerbosity

tento parametr je stejný jako následující nastavení na stránce Nastavení nasazení průvodce přidáním fáze v konzole: úroveň podrobností stavové zprávy s následujícími hodnotami:

AllMessages: Všechny zprávy
OnlySuccessAndErrorMessages: Pouze úspěšné a chybové zprávy
OnlyErrorMessages: Jenom chybové zprávy

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

Zadejte celočíselnou hodnotu pro počet dní, po které má být tento software k dispozici. tento parametr je stejný jako následující nastavení na stránce fáze Nastavení průvodce přidáním fáze v konzole: postupně zpřístupněte tento software v tomto časovém intervalu (ve dnech).

Type: Int32
Parameter Sets: (All)
Aliases:

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

-UseNeighborDP

tento parametr je stejný jako následující nastavení na stránce stáhnout Nastavení v průvodci přidáním fáze v konzole: vyberte možnost nasazení, která se použije, když klient použije distribuční bod ze sousední skupiny hranic nebo výchozí skupiny hranic lokality. Zadejte následující hodnoty:

$true: Stáhnout aktualizace softwaru z distribučního bodu a nainstalovat
$false: Neinstalovat softwarové aktualizace

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-UseSiteDefaultDP

tento parametr je stejný jako následující nastavení na stránce stáhnout Nastavení v průvodci přidáním fáze v konzole: pokud nejsou aktualizace softwaru k dispozici na žádném distribučním bodu v aktuální nebo sousední skupině hranic, může klient stahovat a instalovat softwarové aktualizace z distribučních bodů ve výchozí skupině hranic lokality. Zadejte následující hodnoty:

$true: Stáhnout a nainstalovat softwarové aktualizace z distribučních bodů ve výchozí skupině hranic lokality
$false: Neinstalovat softwarové aktualizace

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-UserNotificationOption

Tento parametr je stejný jako následující nastavení na stránce činnost koncového uživatele v Průvodci přidáním fáze v konzole: Zadejte nastavení uživatelského rozhraní pro toto nasazení s následujícími hodnotami:

DisplayAll: Zobrazení v nástroji Software Center a zobrazení všech oznámení
DisplaySoftwareCenterOnly: Zobrazit v centru softwaru a zobrazovat pouze oznámení o restartování počítače
HideAll: Skrýt v nástroji Software Center a všech oznámeních

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

Zobrazuje, co by se stalo při spuštění rutiny. Rutina se nespustí.

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

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

-WorkstationRestartSuppression

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-WriteFilterCommit

Tento parametr je stejný jako následující nastavení na stránce činnost koncového uživatele v Průvodci přidáním fáze v konzole: Potvrdit změny v den konečného termínu nebo během okna údržby (vyžaduje restart). toto nastavení platí pro zpracování filtru zápisu pro Windows vložená zařízení.

Type: Boolean
Parameter Sets: (All)
Aliases:

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.

Sdílet prostřednictvím