New-CMSoftwareUpdateAutoPhasedDeployment
Verwenden Sie dieses Cmdlet, um eine phasenweise Bereitstellung für Softwareupdates zu erstellen, indem Sie zwei Phasen mit denselben 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 phasenweise Bereitstellung für Softwareupdates zu erstellen, indem Sie zwei Phasen mit denselben Einstellungen generieren. Das Verhalten dieses Cmdlets entspricht dem Assistenten zum Erstellen einer phasenweisen Bereitstellung bei einem Softwareupdate, wenn Sie die Option zum automatischen Erstellen einer standardmäßigen Bereitstellungin zwei Phasen auswählen.
Hinweis
Bevor Sie eine phasenweise Bereitstellung erstellen, stellen Sie sicher, dass Sie den Softwareupdateinhalt an einen Verteilungspunkt verteilen.
Beispiele
Beispiel 1: Erstellen einer Bereitstellung anhand des Updatenamens
In diesem Beispiel wird eine neue phasenweise Softwareupdatebereitstellung 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 nach Eingabeupdateobjekt
In diesem Beispiel wird eine neue phasenweise Softwareupdatebereitstellung namens "myPDName" für ein weitergeleitetes Softwareupdateobjekt 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
Mit diesem Cmdlet werden automatisch zwei Phasen für die angegebenen beiden Auflistungen erstellt. Mit diesem Parameter können Sie auch weitere Phasen hinzufügen. Geben Sie ein Array von Phasen an. Verwenden Sie New-CMSoftwareUpdatePhase, um die Phasen zu erstellen.
Type: | Phase[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BeginCondition
Geben Sie eine Option für den Beginn der zweiten Bereitstellungsphase nach erfolg der ersten Phase an:
AfterPeriod
: Dieser Parameter entspricht der folgenden Einstellung auf der Einstellungen Seite des Assistenten zum Erstellen einer phasenweisen Bereitstellung in der Konsole: Beginnt diese Phase automatisch nach einem Verzögerungszeitraum (in Tagen). Wenn Sie diesen Wert angeben, verwenden Sie DaysAfterPreviousPhaseSuccess, um den Zeitraum zu konfigurieren.Manually
: Dieser Parameter entspricht der folgenden Einstellung auf der Einstellungen Seite des Assistenten zum Erstellen einer phasenweisen Bereitstellung in der Konsole: Beginnen Sie manuell mit der Bereitstellung der zweiten Phase.
Type: | BeginConditionType |
Accepted values: | AfterPeriod, Manually |
Position: | Named |
Default value: | None |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CriteriaOption
Geben Sie eine Option zum Auswählen der Kriterien für den Erfolg der ersten Phase an:
Compliance
: Dieser Parameter entspricht der folgenden Einstellung auf der Einstellungen Seite des Assistenten zum Erstellen einer phasenweisen Bereitstellung in der Konsole: Prozentsatz des Bereitstellungserfolgs. Geben Sie den Prozentwert mit dem Parameter CriteriaValue an.Number
: Dieser Parameter entspricht der folgenden Einstellung auf der Einstellungen Seite 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.
Type: | CriteriaType |
Accepted values: | Compliance, Number |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CriteriaValue
Dieser ganzzahlige Wert hängt vom Wert ab, den Sie für CriteriaOptionangeben:
Compliance
: Angeben des ProzentsatzesNumber
: Angeben der Anzahl von Geräten
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DaysAfterPreviousPhaseSuccess
Geben Sie einen ganzzahligen Wert für die Anzahl der Tage nach dem Erfolg der ersten Phase an, um mit der zweiten Phase zu beginnen. Dieser Parameter entspricht der folgenden Einstellung auf der Einstellungen Seite des Assistenten zum Erstellen einer phasenweisen Bereitstellung in der Konsole: Beginnt diese Phase automatisch nach einem Verzögerungszeitraum (in Tagen).
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineUnit
Geben Sie den Typ des Stichtagszeitraums an. Verwenden Sie diesen Parameter mit DeadlineValue.
Type: | TimeUnitType |
Accepted values: | Hours, Days, Weeks, Months |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineValue
Dieser Parameter wird nur verwendet, wenn Sie AfterPeriod
dies mit dem Parameter "InstallationChoice" angeben.
Geben Sie einen ganzzahligen Wert für den Zeitraum für den Stichtag an. Verwenden Sie den DeadlineUnit -Parameter, um den Typ des Zeitraums anzugeben: Hours
, , , Days
Weeks
Months
. Dieser Parameter entspricht der folgenden Einstellung auf der Einstellungen Seite des Assistenten zum Erstellen einer phasenweisen Bereitstellung in der Konsole: Die Installation ist nach diesem Zeitraum erforderlich.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Geben Sie eine Beschreibung für die Phasenbereitstellung des Softwareupdates an.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FirstCollection
Geben Sie ein Auflistungsobjekt für die erste Phase an.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FirstCollectionId
Geben Sie eine Sammlungs-ID für die erste Phase an.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FirstCollectionName
Geben Sie einen Sammlungsnamen für die erste Phase an.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Platzhalterzeichen und kann zu unerwartetem Verhalten führen. Dies wird nicht empfohlen. Sie können es nicht mit DisableWildcardHandlingkombinieren.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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 Auftragsnummer an.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstallationChoice
Geben Sie eine Option für das Verhalten relativ zu dem Zeitpunkt an, zu dem die Software verfügbar gemacht wird:
AsSoonAsPossible
: Dieser Parameter entspricht der folgenden Einstellung auf der Einstellungen Seite des Assistenten zum Erstellen einer phasenweisen Bereitstellung in der Konsole: Die Installation ist so schnell wie möglich erforderlich.AfterPeriod
: Dieser Parameter entspricht der folgenden Einstellung auf der Einstellungen Seite des Assistenten zum Erstellen einer phasenweisen Bereitstellung 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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Geben Sie einen Namen für die phasenweise Bereitstellung der Anwendung an.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SecondCollection
Geben Sie ein Auflistungsobjekt für die zweite Phase an.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SecondCollectionId
Geben Sie eine Sammlungs-ID für die zweite Phase an.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SecondCollectionName
Geben Sie einen Sammlungsnamen für die zweite Phase an.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareUpdateGroup
Geben Sie ein Objekt für die Softwareupdategruppe an.
Type: | IResultObject |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SoftwareUpdateGroupId
Geben Sie die Softwareupdategruppe nach ID an.
Type: | String |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareUpdateGroupName
Geben Sie die Softwareupdategruppe nach Namen an.
Type: | String |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareUpdateIds
Geben Sie ein Array von Softwareupdate-IDs an.
Type: | String[] |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareUpdateNames
Geben Sie ein Array von Softwareupdatenamen an.
Type: | String[] |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareUpdates
Geben Sie ein Array von Softwareupdateobjekten an.
Type: | IResultObject[] |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
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 Einstellungen Seite des Assistenten zum Erstellen einer phasenweisen Bereitstellung in der Konsole: Stellen Sie diese Software schrittweise über diesen Zeitraum (in Tagen) zur Verfügung.
Type: | Int32 |
Position: | Named |
Default value: | None |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]
Ausgaben
IResultObject