New-CMSoftwareUpdatePhase

Artykuł
08/12/2021

SYNOPSIS

To polecenie cmdlet umożliwia utworzenie fazy wdrażania aktualizacji oprogramowania.

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

Począwszy od wersji 2002, użyj tego polecenia cmdlet, aby utworzyć fazę wdrażania aktualizacji oprogramowania.

EXAMPLES

Przykład 1: tworzenie fazy aktualizacji oprogramowania

Ten przykład tworzy fazę aktualizacji oprogramowania o nazwie MySUPhase dla kolekcji o nazwie MyCollection, która będzie wyświetlana tylko w Centrum oprogramowania.

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

PARAMETERS

-AlertDelta

Ten parametr jest taki sam jak następujące ustawienie na stronie Alerty Kreatora dodawania fazy w konsoli programu : Przesunięcie od terminu ostatecznego . Określ wartość całkowitą przesunięcia, a następnie określ typ okresu za pomocą parametru AlertUnit.

Aby ustawić tę wartość, należy użyć parametru EnableAlert.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-AlertThresholdPercentage

Ten parametr jest taki sam jak następujące ustawienie na stronie Alerty Kreatora dodawania fazy w konsoli programu : Zgodność klienta jest poniżej następującego (procent). Określ wartość całkowitą dla wartości procentowej. Aby ustawić tę wartość, należy użyć parametru EnableAlert.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-AlertUnit

Określ typ okresu. Użyj tego parametru z parametrem 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

Ten parametr jest taki sam jak następujące ustawienie na stronie Pobieranie Ustawienia Kreatora dodawania fazy w konsoli programu : Zezwalaj klientom mierzonego połączenia internetowego na pobieranie zawartości po upływie ostatecznego terminu instalacji, co może pociągnąć za sobą dodatkowe koszty.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AllowSystemRestart

Ten parametr jest taki sam jak następujące ustawienie na stronie Środowisko użytkownika Kreatora dodawania fazy w konsoli programu : Ponowne uruchomienie systemu (jeśli jest to wymagane do ukończenia instalacji). To ustawienie ma zastosowanie po osiągnięciu ostatecznego terminu instalacji, aby umożliwić to działanie poza oknem obsługi.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AllowWumuFallback

Ten parametr jest taki sam jak następujące ustawienie na stronie Pobieranie Ustawienia Kreatora dodawania fazy w konsoli programu : Jeśli aktualizacje oprogramowania nie są dostępne w punkcie dystrybucji w grupach bieżących, sąsiednich lub granic lokacji, pobierz zawartość z usługi Microsoft Updates.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-BeginCondition

Określ opcję rozpoczęcia tej fazy wdrażania po sukcesie poprzedniej fazy:

AfterPeriod: Ten parametr jest taki sam jak następujące ustawienie na stronie Faza Ustawienia Kreatora dodawania fazy w konsoli programu : Automatycznie rozpocznij tę fazę po okresie odroczenia (w dniach). Jeśli określisz tę wartość, skonfiguruj okres czasu za pomocą właściwości DaysAfterPreviousPhaseSuccess.
Manually: ten parametr jest taki sam jak następujące ustawienie na stronie Ustawienia w Kreatorze dodawania fazy w konsoli programu : Ręcznie rozpocznij tę fazę wdrażania.

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 (Kolekcja)

Określ obiekt dla kolekcji docelowej.

Type: IResultObject
Parameter Sets: SearchByCollection
Aliases:

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

-CollectionId

Określ kolekcję docelową według identyfikatora.

Type: String
Parameter Sets: SearchByCollectionId
Aliases:

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

-CollectionName

Określ kolekcję docelową według nazwy.

Type: String
Parameter Sets: SearchByCollectionName
Aliases:

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

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

-CriteriaOption

Określ opcję wyboru kryteriów powodzenia poprzedniej fazy:

Compliance: Ten parametr jest taki sam jak następujące ustawienie na stronie Ustawienia fazy w Kreatorze dodawania fazy w konsoli programu : Procent powodzenia wdrożenia. Określ wartość procentową za pomocą parametru CriteriaValue.
Number: ten parametr jest taki sam jak następujące ustawienie na stronie Ustawienia fazy w Kreatorze dodawania fazy w konsoli programu : Liczba pomyślnie wdrożonych urządzeń. Określ liczbę urządzeń za pomocą parametru 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

Ta wartość całkowita zależy od wartości owej, która jest określana dla ustawienia CriteriaOption:

Compliance: określ wartość procentową
Number: określ liczbę urządzeń

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DaysAfterPreviousPhaseSuccess

Określ wartość całkowitą dla liczby dni po sukcesie poprzedniej fazy, aby rozpocząć tę fazę. Ten parametr jest taki sam jak następujące ustawienie na stronie Faza Ustawienia Kreatora dodawania fazy w konsoli programu : Automatycznie rozpocznij tę fazę po okresie odroczenia (w dniach).

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DeadlineUnit

Określ typ terminu ostatecznego. Użyj tego parametru z wartością 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

Ten parametr jest używany tylko w przypadku określenia AfterPeriod parametru InstallationChoice.

Określ wartość całkowitą dla okresu ostatecznego. Użyj parametru DeadlineUnit, aby określić typ okresu: Hours , , , Days Weeks Months . Ten parametr jest taki sam jak następujące ustawienie na stronie faza Ustawienia Kreatora dodawania fazy w konsoli programu : Instalacja jest wymagana po upływie tego czasu.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DisableScomAlert

Ten parametr jest taki sam jak następujące ustawienie na stronie Alerty Kreatora dodawania fazy w konsoli programu : Wyłącz alerty Operations Manager podczas uruchamiania aktualizacji oprogramowania.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-DisableWildcardHandling

Ten parametr traktuje symbole wieloznaczne jako wartości znaków literału. Nie można połączyć go z forceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-EnableAlert

Ten parametr jest taki sam jak następujące ustawienie na stronie Alerty Kreatora dodawania fazy w konsoli programu : Wygeneruj alert, gdy zostaną spełnione następujące warunki. Po ustawisz ten parametr na $true wartość , ustaw również następujące 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

Ten parametr jest taki sam jak następujące ustawienie na stronie Wdrażanie Ustawienia Kreatora dodawania fazy w konsoli programu : Użyj funkcji Wake-on-LAN do wznawiania klientów dla wymaganych wdrożeń.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Ten parametr przetwarza symbole wieloznaczne i może prowadzić do nieoczekiwanego zachowania. Nie jest to zalecane. Nie można połączyć go z disableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-GenerateScomAlertOnFailure

Ten parametr jest taki sam jak następujące ustawienie na stronie Alerty Kreatora dodawania fazy w konsoli programu : Generuj alert Operations Manager, gdy instalacja aktualizacji oprogramowania zakończy się niepowodzeniem.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-InstallationChoice

Określ opcję zachowania w odniesieniu do tego, kiedy oprogramowanie zostanie udostępnione:

AsSoonAsPossible: ten parametr jest taki sam jak następujące ustawienie na stronie Ustawienia w Kreatorze dodawania fazy w konsoli programu : Instalacja jest wymagana tak szybko, jak to możliwe.
AfterPeriod: Ten parametr jest taki sam jak następujące ustawienie na stronie Ustawienia fazy w Kreatorze dodawania fazy w konsoli programu : Instalacja jest wymagana po upływie tego czasu. Jeśli określisz tę wartość, skonfiguruj okres czasu za pomocą funkcji DeadlineUnit i 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

Określ opis fazy.

Type: String
Parameter Sets: (All)
Aliases:

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

-PhaseName

Podaj nazwę opisu.

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

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

-RequirePostRebootFullScan

Ten parametr jest taki sam jak następujące ustawienie na stronie Środowisko użytkownika Kreatora dodawania fazy w konsoli programu : Jeśli jakakolwiek aktualizacja w tym wdrożeniu wymaga ponownego uruchomienia systemu, uruchom cykl oceny wdrożenia aktualizacji po ponownym uruchomieniu.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-ServerRestartSuppression

Ten parametr jest taki sam jak następujące ustawienie na stronie Środowisko użytkownika Kreatora dodawania fazy w konsoli programu . Pomiń ponowne uruchomienie systemu na następujących urządzeniach: Serwery.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-SoftwareInstallation

Ten parametr jest taki sam jak następujące ustawienie na stronie Środowisko użytkownika Kreatora dodawania fazy w konsoli programu : Instalacja oprogramowania. To ustawienie ma zastosowanie po osiągnięciu ostatecznego terminu instalacji, aby umożliwić to działanie poza oknem obsługi.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-StateMessageVerbosity

Ten parametr jest taki sam jak następujące ustawienie na stronie Ustawienia w Kreatorze dodawania fazy w konsoli: Poziom szczegółowości komunikatu o stanie z następującymi wartościami:

AllMessages: wszystkie komunikaty
OnlySuccessAndErrorMessages: tylko komunikaty o błędach i sukcesach
OnlyErrorMessages: tylko komunikaty o błędach

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

Określ liczbę całkowitą dla liczby dni, przez które będzie stopniowo udostępniane to oprogramowanie. Ten parametr jest taki sam jak następujące ustawienie na stronie Faza Ustawienia Kreatora dodawania fazy w konsoli programu : Stopniowo udostępnij to oprogramowanie w tym okresie (w dniach).

Type: Int32
Parameter Sets: (All)
Aliases:

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

-UseNeighborDP

Ten parametr jest taki sam jak następujące ustawienie na stronie Pobieranie Ustawienia Kreatora dodawania fazy w konsoli programu : Wybierz opcję wdrożenia, która ma być używana, gdy klient używa punktu dystrybucji z grupy granic sąsiada lub domyślnej grupy granic lokacji. Określ następujące wartości:

$true: pobieranie aktualizacji oprogramowania z punktu dystrybucji i instalowanie
$false: nie instaluj aktualizacji oprogramowania

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-UseSiteDefaultDP

Ten parametr jest taki sam jak następujące ustawienie na stronie Pobieranie Ustawienia Kreatora dodawania fazy w konsoli programu : Jeśli aktualizacje oprogramowania nie są dostępne w żadnym punkcie dystrybucji w bieżącej lub sąsiadowej grupie granic, klient może pobierać i instalować aktualizacje oprogramowania z punktów dystrybucji w domyślnej grupie granic lokacji. Określ następujące wartości:

$true: pobieranie i instalowanie aktualizacji oprogramowania z punktów dystrybucji w domyślnej grupie granic lokacji
$false: nie instaluj aktualizacji oprogramowania

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-UserNotificationOption

Ten parametr jest taki sam jak następujące ustawienie na stronie Środowisko użytkownika Kreatora dodawania fazy w konsoli programu : Określ ustawienie obsługi użytkownika dla tego wdrożenia z następującymi wartościami:

DisplayAll: wyświetlanie w Centrum oprogramowania i wyświetlanie wszystkich powiadomień
DisplaySoftwareCenterOnly: wyświetlanie w Centrum oprogramowania i wyświetlanie tylko powiadomień dotyczących ponownego uruchomienia komputera
HideAll: ukryj w Centrum oprogramowania i wszystkie powiadomienia

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

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.

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

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

-WorkstationRestartSuppression

Ten parametr jest taki sam jak następujące ustawienie na stronie Środowisko użytkownika Kreatora dodawania fazy w konsoli programu . Pomiń ponowne uruchomienie systemu na następujących urządzeniach: Stacje robocze.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-WriteFilterCommit

Ten parametr jest taki sam jak następujące ustawienie na stronie Środowisko użytkownika Kreatora dodawania fazy w konsoli programu : Zatwierdzanie zmian po upływie terminu lub w oknie obsługi (wymaga ponownego uruchomienia). To ustawienie dotyczy obsługi filtru zapisu dla Windows Embedded.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

Typowe parametry

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.