New-CMTaskSequenceAutoPhasedDeployment
Verwenden Sie dieses Cmdlet, um eine stufenweise Bereitstellung für eine Tasksequenz zu erstellen, indem Sie zwei Phasen mit den gleichen Einstellungen generieren.
Syntax
New-CMTaskSequenceAutoPhasedDeployment
[-TaskSequence] <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-CMTaskSequenceAutoPhasedDeployment
[-TaskSequenceId] <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-CMTaskSequenceAutoPhasedDeployment
[-TaskSequenceName] <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>] Beschreibung
Verwenden Sie dieses Cmdlet, um eine stufenweise Bereitstellung für eine Tasksequenz zu erstellen, indem Sie zwei Phasen mit den gleichen Einstellungen generieren. Das Verhalten dieses Cmdlets entspricht dem Des Assistenten zum Erstellen einer phasenweisen Bereitstellung in einer Tasksequenz, wenn Sie die Option Automatisches Erstellen einer zweiphasige Standardbereitstellung auswählen.
Hinweis
Bevor Sie eine bereitstellung in Phasen erstellen, stellen Sie sicher, dass Sie den Inhalt der Tasksequenz an einen Verteilungspunkt verteilen.
Beispiele
Beispiel 1: Erstellen einer Bereitstellung nach Tasksequenzname
In diesem Beispiel wird eine neue stufenweise Tasksequenzbereitstellung namens myDPName für die Tasksequenz myTaskSequenceName erstellt.
New-CMTaskSequenceAutoPhasedDeployment -TaskSequenceName "myTaskSequenceName" -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 Eingabetasksequenzobjekt
In diesem Beispiel wird eine neue stufenweise Tasksequenzbereitstellung namens myPDName für ein übergebenes Tasksequenzobjekt erstellt.
$myTS | New-CMTaskSequenceAutoPhasedDeployment -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-CMTaskSequencePhase , 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 der Tasksequenz 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 stufenweise Bereitstellung der Tasksequenz 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 |
-TaskSequence
Geben Sie ein Tasksequenzobjekt an.
| Typ: | IResultObject |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-TaskSequenceId
Geben Sie eine Tasksequenz anhand der ID an.
| Typ: | String |
| Aliase: | TaskSequencePackageId |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-TaskSequenceName
Geben Sie eine Tasksequenz anhand des Namens an.
| Typ: | String |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| 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
Ausgaben
IResultObject