New-CMSoftwareUpdatePhase
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 $true
festlegen, 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 NachrichtenOnlySuccessAndErrorMessages
: Nur Erfolgs- und FehlermeldungenOnlyErrorMessages
: 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 BenachrichtigungenDisplaySoftwareCenterOnly
: Anzeigen im Softwarecenter und nur Benachrichtigungen für ComputerneustartsHideAll
: 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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für