New-CMSoftwareUpdateAutoPhasedDeployment

Verwenden Sie dieses Cmdlet, um eine stufenweise Bereitstellung für Softwareupdates zu erstellen, indem Sie zwei Phasen mit den gleichen Einstellungen generieren.

Syntax

New-CMSoftwareUpdateAutoPhasedDeployment
   [-SoftwareUpdateGroup] <IResultObject>
   [-AddPhases <Phase[]>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InsertAtOrder <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdateAutoPhasedDeployment
   [-SoftwareUpdateGroupId] <String>
   [-AddPhases <Phase[]>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InsertAtOrder <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdateAutoPhasedDeployment
   [-SoftwareUpdateGroupName] <String>
   [-AddPhases <Phase[]>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InsertAtOrder <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdateAutoPhasedDeployment
   [-SoftwareUpdateIds] <String[]>
   [-AddPhases <Phase[]>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InsertAtOrder <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdateAutoPhasedDeployment
   [-SoftwareUpdateNames] <String[]>
   [-AddPhases <Phase[]>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InsertAtOrder <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdateAutoPhasedDeployment
   [-SoftwareUpdates] <IResultObject[]>
   [-AddPhases <Phase[]>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InsertAtOrder <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Verwenden Sie dieses Cmdlet, um eine stufenweise Bereitstellung für Softwareupdates zu erstellen, indem Sie zwei Phasen mit den gleichen Einstellungen generieren. Das Verhalten dieses Cmdlets entspricht dem des Assistenten zum Erstellen einer phasenweisen Bereitstellung für ein Softwareupdate, wenn Sie die Option Automatisches Erstellen einer zweiphasige Standardbereitstellung auswählen.

Hinweis

Bevor Sie eine stufenweise Bereitstellung erstellen, stellen Sie sicher, dass Sie den Inhalt des Softwareupdates an einen Verteilungspunkt verteilen.

Beispiele

Beispiel 1: Erstellen einer Bereitstellung anhand des Updatenamens

In diesem Beispiel wird eine neue softwareupdate-phasenweise Bereitstellung namens myDPName für das Softwareupdate myUpdateName erstellt.

New-CMSoftwareUpdateAutoPhasedDeployment -SoftwareUpdateName "myUpdateName" -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"

Beispiel 2: Erstellen einer Bereitstellung durch Eingabeupdateobjekt

In diesem Beispiel wird eine neue Softwareupdate-Phasenbereitstellung namens myPDName für ein Softwareupdateobjekt mit Pipeline erstellt.

$myUpdate | New-CMSoftwareUpdateAutoPhasedDeployment -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"

Parameter

-AddPhases

Dieses Cmdlet erstellt automatisch zwei Phasen für die angegebenen beiden Auflistungen. Sie können mit diesem Parameter auch weitere Phasen hinzufügen. Geben Sie ein Array von Phasen an. Verwenden Sie New-CMSoftwareUpdatePhase , um die Phasen zu erstellen.

Typ:Phase[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-BeginCondition

Geben Sie eine Option zum Starten der zweiten Phase der Bereitstellung an, nachdem die erste Phase erfolgreich war:

  • AfterPeriod: Dieser Parameter ist identisch mit der folgenden Einstellung auf der Seite Einstellungen des Assistenten zum Erstellen von Bereitstellungsphasen 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 ist identisch mit der folgenden Einstellung auf der Seite Einstellungen des Assistenten zum Erstellen einer bereitstellung in Phasen in der Konsole: Manuelles Starten der zweiten Phase der Bereitstellung.

Typ:BeginConditionType
Zulässige Werte:AfterPeriod, Manually
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

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

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CriteriaOption

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

  • Compliance: Dieser Parameter entspricht der folgenden Einstellung auf der Seite Einstellungen des Assistenten zum Erstellen von bereitstellungsphasen 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 Einstellungen des Assistenten zum Erstellen einer phasenweisen Bereitstellung in der Konsole: Anzahl der erfolgreich bereitgestellten Geräte. Geben Sie die Anzahl der Geräte mit dem Parameter CriteriaValue an .

Typ:CriteriaType
Zulässige Werte:Compliance, Number
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DaysAfterPreviousPhaseSuccess

Geben Sie einen ganzzahligen Wert für die Anzahl der Tage nach dem Erfolg der ersten Phase an, um die zweite Phase zu beginnen. Dieser Parameter ist identisch mit der folgenden Einstellung auf der Seite Einstellungen des Assistenten zum Erstellen einer phasenweisen Bereitstellung in der Konsole: Diese Phase wird automatisch nach einer Verzögerungsphase (in Tagen) gestartet.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DeadlineUnit

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

Typ:TimeUnitType
Zulässige Werte:Hours, Days, Weeks, Months
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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 Einstellungen des Assistenten zum Erstellen von Bereitstellungen in Phasen in der Konsole: Installation ist nach diesem Zeitraum erforderlich.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Description

Geben Sie eine Beschreibung für die stufenweise Bereitstellung von Softwareupdates an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FirstCollection

Geben Sie ein Auflistungsobjekt für die erste Phase an.

Typ:IResultObject
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FirstCollectionId

Geben Sie eine Sammlungs-ID für die erste Phase an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FirstCollectionName

Geben Sie einen Sammlungsnamen für die erste Phase an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InsertAtOrder

Wenn Sie den AddPhases-Parameter verwenden, verwenden Sie diesen Parameter, um zu bestimmen, wo in der Reihenfolge der Phasen die zusätzlichen Phasen eingefügt werden sollen. Geben Sie eine ganze Zahl mit der Bestellnummer an.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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 Einstellungen des Assistenten zum Erstellen von Bereitstellungen in Phasen in der Konsole: Installation ist so schnell wie möglich erforderlich.

  • AfterPeriod: Dieser Parameter entspricht der folgenden Einstellung auf der Seite Einstellungen des Assistenten zum Erstellen von bereitstellungsphasen 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.

Typ:InstallationChoiceType
Zulässige Werte:AsSoonAsPossible, AfterPeriod
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Geben Sie einen Namen für die phasenweise Bereitstellung der Anwendung an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SecondCollection

Geben Sie ein Auflistungsobjekt für die zweite Phase an.

Typ:IResultObject
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SecondCollectionId

Geben Sie eine Sammlungs-ID für die zweite Phase an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SecondCollectionName

Geben Sie einen Sammlungsnamen für die zweite Phase an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SoftwareUpdateGroup

Geben Sie ein Objekt für die Softwareupdategruppe an.

Typ:IResultObject
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-SoftwareUpdateGroupId

Geben Sie die Softwareupdategruppe anhand der ID an.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SoftwareUpdateGroupName

Geben Sie die Softwareupdategruppe anhand des Namens an.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SoftwareUpdateIds

Geben Sie ein Array von Softwareupdate-IDs an.

Typ:String[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SoftwareUpdateNames

Geben Sie ein Array von Softwareupdatenamen an.

Typ:String[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SoftwareUpdates

Geben Sie ein Array von Softwareupdateobjekten an.

Typ:IResultObject[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ThrottlingDays

Geben Sie einen ganzzahligen Wert für die Anzahl der Tage an, um diese Software schrittweise verfügbar zu machen. Dieser Parameter ist identisch mit der folgenden Einstellung auf der Seite Einstellungen des Assistenten zum Erstellen von bereitstellungsphasen in der Konsole: Stufenweises Bereitstellen dieser Software über diesen Zeitraum (in Tagen).

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Ausgaben

IResultObject