New-CMSoftwareUpdatePhase

Modul:

ConfigurationManager

Verwenden Sie dieses Cmdlet, um eine Bereitstellungsphase für Softwareupdates zu erstellen.

Syntax

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>]

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>]

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>]

Beschreibung

Verwenden Sie dieses Cmdlet, um eine Bereitstellungsphase für Softwareupdates zu erstellen.

Beispiele

Beispiel 1: Erstellen einer Softwareupdatephase

In diesem Beispiel wird eine Softwareupdatephase mit dem Namen MySUPhase für die Sammlung mit dem Namen MyCollection erstellt, die nur im Softwarecenter angezeigt wird.

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

Parameter

-AlertDelta

Dieser Parameter ist identisch mit der folgenden Einstellung auf der Seite Warnungen des Assistenten zum Hinzufügen von Phasen in der Konsole: Offset from the deadline time. Geben Sie einen ganzzahligen Wert für den Offset an, und geben Sie dann den Periodentyp mit dem AlertUnit-Parameter an.

Um diesen Wert festzulegen, müssen Sie den Parameter EnableAlert verwenden.

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

-AlertThresholdPercentage

Dieser Parameter ist identisch mit der folgenden Einstellung auf der Seite Warnungen des Assistenten zum Hinzufügen von Phasen in der Konsole: Clientkonformität ist unter dem folgenden Wert (Prozent). Geben Sie einen ganzzahligen Wert für den Prozentsatz an. Um diesen Wert festzulegen, müssen Sie den Parameter EnableAlert verwenden.

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

-AlertUnit

Geben Sie den Typ des Zeitraums an. Verwenden Sie diesen Parameter mit AlertDelta.

Type:	TimeUnitType
Accepted values:	Hours, Days, Weeks, Months
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowMeteredConnection

Dieser Parameter entspricht der folgenden Einstellung auf der Seite Downloadeinstellungen des Assistenten zum Hinzufügen von Phasen in der Konsole: Clients mit einer getakteten Internetverbindung erlauben, Inhalte nach dem Installationsstichtag herunterzuladen, was zusätzliche Kosten verursachen kann.

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

-AllowSystemRestart

Dieser Parameter entspricht der folgenden Einstellung auf der Seite Benutzerfreundlichkeit des Assistenten zum Hinzufügen von Phasen in der Konsole: Systemneustart (falls erforderlich, um die Installation abzuschließen). Diese Einstellung gilt, wenn der Installationsstichtag erreicht ist, damit diese Aktivität außerhalb des Wartungsfensters ausgeführt werden kann.

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

-AllowWumuFallback

Dieser Parameter ist identisch mit der folgenden Einstellung auf der Seite Downloadeinstellungen des Assistenten zum Hinzufügen von Phasen in der Konsole: Wenn Softwareupdates auf dem Verteilungspunkt in aktuellen, benachbarten oder Standortbegrenzungsgruppen nicht verfügbar sind, laden Sie Inhalte von Microsoft Aktualisierungen herunter.

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

-BeginCondition

Geben Sie eine Option für den Beginn dieser Bereitstellungsphase an, nachdem die vorherige Phase erfolgreich war:

• AfterPeriod: Dieser Parameter entspricht der folgenden Einstellung auf der Seite Phaseneinstellungen des Assistenten zum Hinzufügen von Phasen in der Konsole: Diese Phase wird nach einer Verzögerungsphase (in Tagen) automatisch gestartet. Wenn Sie diesen Wert angeben, verwenden Sie DaysAfterPreviousPhaseSuccess , um den Zeitraum zu konfigurieren.

• Manually: Dieser Parameter entspricht der folgenden Einstellung auf der Seite Phaseneinstellungen des Assistenten zum Hinzufügen von Phasen in der Konsole: Diese Bereitstellungsphase wird manuell gestartet.

Type:	BeginConditionType
Accepted values:	AfterPeriod, Manually
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Collection

Geben Sie ein Objekt für die Zielauflistung an.

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

-CollectionId

Geben Sie die Zielsammlung anhand der ID an.

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

-CollectionName

Geben Sie die Zielsammlung anhand des Namens an.

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

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CriteriaOption

Geben Sie eine Option an, um die Kriterien für den Erfolg der vorherigen Phase auszuwählen:

• Compliance: Dieser Parameter entspricht der folgenden Einstellung auf der Seite Phaseneinstellungen des Assistenten zum Hinzufügen von Phasen in der Konsole: Prozentsatz des Bereitstellungserfolgs. Geben Sie den Prozentwert mit dem CriteriaValue-Parameter an.

• Number: Dieser Parameter entspricht der folgenden Einstellung auf der Seite Phaseneinstellungen des Assistenten zum Hinzufügen von Phasen in der Konsole: Anzahl der erfolgreich bereitgestellten Geräte. Geben Sie die Anzahl der Geräte mit dem CriteriaValue-Parameter an.

Type:	CriteriaType
Accepted values:	Compliance, Number
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CriteriaValue

Dieser ganzzahlige Wert hängt von dem Wert ab, den Sie für CriteriaOption angeben:

• Compliance: Geben Sie den Prozentsatz an.

• Number: Geben Sie die Anzahl der Geräte an.

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

-DaysAfterPreviousPhaseSuccess

Geben Sie einen ganzzahligen Wert für die Anzahl der Tage nach dem Erfolg der vorherigen Phase an, um diese Phase zu beginnen. Dieser Parameter ist identisch mit der folgenden Einstellung auf der Seite Phaseneinstellungen des Assistenten zum Hinzufügen von Phasen in der Konsole: Diese Phase wird nach einem Verzögerungszeitraum (in Tagen) automatisch gestartet.

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

-DeadlineUnit

Geben Sie den Typ des Stichtags an. Verwenden Sie diesen Parameter mit DeadlineValue.

Type:	TimeUnitType
Accepted values:	Hours, Days, Weeks, Months
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DeadlineValue

Dieser Parameter wird nur verwendet, wenn Sie mit dem Parameter InstallationChoice angebenAfterPeriod.

Geben Sie einen ganzzahligen Wert für den Zeitraum für den Stichtag an. Verwenden Sie den Parameter DeadlineUnit , um den Typ des Zeitraums anzugeben: Hours, Days, Weeks, Months. Dieser Parameter entspricht der folgenden Einstellung auf der Seite Phaseneinstellungen des Assistenten zum Hinzufügen von Phasen in der Konsole: Die Installation ist nach diesem Zeitraum erforderlich.

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

-DisableScomAlert

Dieser Parameter entspricht der folgenden Einstellung auf der Seite Warnungen des Assistenten zum Hinzufügen von Phasen in der Konsole: Deaktivieren von Operations Manager-Warnungen während der Ausführung von Softwareupdates.

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

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

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

-EnableAlert

Dieser Parameter ist identisch mit der folgenden Einstellung auf der Seite Warnungen des Assistenten zum Hinzufügen von Phasen in der Konsole: Warnung generieren, wenn die folgenden Bedingungen erfüllt sind. Wenn Sie diesen Parameter auf $truefestlegen, legen Sie auch die folgenden Parameter fest:

• AlertThresholdPercentage
• AlertDelta

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

-EnableWakeOnLan

Dieser Parameter entspricht der folgenden Einstellung auf der Seite Bereitstellungseinstellungen des Assistenten zum Hinzufügen von Phasen in der Konsole: Verwenden Sie Wake-on-LAN, um Clients für erforderliche Bereitstellungen zu reaktivieren.

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

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen. Dies wird nicht empfohlen. Sie können es nicht mit DisableWildcardHandling kombinieren.

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

-GenerateScomAlertOnFailure

Dieser Parameter entspricht der folgenden Einstellung auf der Seite Warnungen des Assistenten zum Hinzufügen von Phasen in der Konsole: Generieren einer Operations Manager-Warnung, wenn eine Softwareupdateinstallation fehlschlägt.

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

-InstallationChoice

Geben Sie eine Option für das Verhalten relativ zum Zeitpunkt der Bereitstellung der Software an:

• AsSoonAsPossible: Dieser Parameter entspricht der folgenden Einstellung auf der Seite Phaseneinstellungen des Assistenten zum Hinzufügen von Phasen in der Konsole: Die Installation ist so schnell wie möglich erforderlich.

• AfterPeriod: Dieser Parameter entspricht der folgenden Einstellung auf der Seite Phaseneinstellungen des Assistenten zum Hinzufügen von Phasen in der Konsole: Die Installation ist nach diesem Zeitraum erforderlich. Wenn Sie diesen Wert angeben, verwenden Sie DeadlineUnit und DeadlineValue , um den Zeitraum zu konfigurieren.

Type:	InstallationChoiceType
Accepted values:	AsSoonAsPossible, AfterPeriod
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PhaseDescription

Geben Sie eine Beschreibung für die Phase an.

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

-PhaseName

Geben Sie einen Namen für die Beschreibung an.

Type:	String
Aliases:	Name
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-RequirePostRebootFullScan

Dieser Parameter entspricht der folgenden Einstellung auf der Seite "Benutzerfreundlichkeit " des Assistenten zum Hinzufügen von Phasen in der Konsole: Wenn ein Update in dieser Bereitstellung einen Systemneustart erfordert, führen Sie nach dem Neustart den Auswertungszyklus für die Bereitstellung von Updates aus.

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

-ServerRestartSuppression

Dieser Parameter ist identisch mit der folgenden Einstellung auf der Seite Benutzerfreundlichkeit des Assistenten zum Hinzufügen von Phasen in der Konsole. Unterdrücken Sie den Systemneustart auf den folgenden Geräten: Server.

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

-SoftwareInstallation

Dieser Parameter entspricht der folgenden Einstellung auf der Seite Benutzerfreundlichkeit des Assistenten zum Hinzufügen von Phasen in der Konsole: Softwareinstallation. Diese Einstellung gilt, wenn der Installationsstichtag erreicht ist, damit diese Aktivität außerhalb des Wartungsfensters ausgeführt werden kann.

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

-StateMessageVerbosity

Dieser Parameter entspricht der folgenden Einstellung auf der Seite Bereitstellungseinstellungen des Assistenten zum Hinzufügen von Phasen in der Konsole: Detailebene für Zustandsmeldungen mit den folgenden Werten:

• AllMessages: Alle Nachrichten
• OnlySuccessAndErrorMessages: Nur Erfolgs- und Fehlermeldungen
• OnlyErrorMessages: Nur Fehlermeldungen

Type:	VerbosityLevelType
Accepted values:	AllMessages, OnlySuccessAndErrorMessages, OnlyErrorMessages
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ThrottlingDays

Geben Sie einen ganzzahligen Wert für die Anzahl der Tage an, um diese Software schrittweise verfügbar zu machen. Dieser Parameter entspricht der folgenden Einstellung auf der Seite Phaseneinstellungen des Assistenten zum Hinzufügen von Phasen in der Konsole: Schrittweises Bereitstellen dieser Software über diesen Zeitraum (in Tagen).

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

-UseNeighborDP

Dieser Parameter entspricht der folgenden Einstellung auf der Seite Downloadeinstellungen des Assistenten zum Hinzufügen von Phasen in der Konsole: Wählen Sie die Bereitstellungsoption aus, die verwendet werden soll, wenn ein Client einen Verteilungspunkt aus einer benachbarten Begrenzungsgruppe oder der Standardmäßigen Standortbegrenzungsgruppe verwendet. Geben Sie die folgenden Werte an:

• $true: Softwareupdates vom Verteilungspunkt herunterladen und installieren
• $false: Keine Softwareupdates installieren

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

-UserNotificationOption

Dieser Parameter ist identisch mit der folgenden Einstellung auf der Seite Benutzerfreundlichkeit des Assistenten zum Hinzufügen von Phasen in der Konsole: Geben Sie die Benutzerfreundlichkeitseinstellung für diese Bereitstellung mit den folgenden Werten an:

• DisplayAll: Anzeigen im Softwarecenter und Anzeigen aller Benachrichtigungen
• DisplaySoftwareCenterOnly: Anzeigen im Softwarecenter und nur Benachrichtigungen für Computerneustarts
• HideAll: Im Softwarecenter und alle Benachrichtigungen ausblenden

Type:	UserNotificationType
Accepted values:	DisplayAll, DisplaySoftwareCenterOnly, HideAll
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UseSiteDefaultDP

Dieser Parameter entspricht der folgenden Einstellung auf der Seite Downloadeinstellungen des Assistenten zum Hinzufügen von Phasen in der Konsole: Wenn Softwareupdates auf keinen Verteilungspunkten in der aktuellen oder benachbarten Begrenzungsgruppe verfügbar sind, kann der Client Softwareupdates von Verteilungspunkten in der Standardbegrenzungsgruppe des Standorts herunterladen und installieren. Geben Sie die folgenden Werte an:

• $true: Herunterladen und Installieren von Softwareupdates von den Verteilungspunkten in der Standardbegrenzungsgruppe des Standorts
• $false: Keine Softwareupdates installieren

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

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WorkstationRestartSuppression

Dieser Parameter ist identisch mit der folgenden Einstellung auf der Seite Benutzerfreundlichkeit des Assistenten zum Hinzufügen von Phasen in der Konsole. Unterdrücken Sie den Systemneustart auf den folgenden Geräten: Arbeitsstationen.

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

-WriteFilterCommit

Dieser Parameter entspricht der folgenden Einstellung auf der Seite "Benutzerfreundlichkeit" des Assistenten zum Hinzufügen von Phasen in der Konsole: Commit für Änderungen am Stichtag oder während eines Wartungsfensters (Neustart erforderlich). Diese Einstellung gilt für die Behandlung von Schreibfiltern für Windows Embedded-Geräte.

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

Eingaben

None

Ausgaben

Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase