Set-CMTaskSequencePhase

Verwenden Sie dieses Cmdlet, um eine Bereitstellungsphase für eine Tasksequenz zu konfigurieren.

Syntax

Set-CMTaskSequencePhase
   [-AllowFallback <Boolean>]
   [-AllowRemoteDP <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-Comments <String>]
   [-DeploymentOption <DeploymentOptionType>]
   [-PreDownload <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-WriteFilterCommit <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-MovePhase <ReorderType>]
   [-MoveToOrder <Int32>]
   [-NewCollection <IResultObject>]
   [-NewCollectionId <String>]
   [-NewCollectionName <String>]
   [-NewPhaseName <String>]
   [-ThrottlingDays <Int32>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-Id <String>]
   [-InputObject] <IResultObject>
   [-Name <String>]
   [-Order <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTaskSequencePhase
   [-AllowFallback <Boolean>]
   [-AllowRemoteDP <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-Comments <String>]
   [-DeploymentOption <DeploymentOptionType>]
   [-PreDownload <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-WriteFilterCommit <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-MovePhase <ReorderType>]
   [-MoveToOrder <Int32>]
   [-NewCollection <IResultObject>]
   [-NewCollectionId <String>]
   [-NewCollectionName <String>]
   [-NewPhaseName <String>]
   [-ThrottlingDays <Int32>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-Id <String>]
   [-Name <String>]
   [-Order <Int32>]
   [-PhasedDeploymentId] <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTaskSequencePhase
   [-AllowFallback <Boolean>]
   [-AllowRemoteDP <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-Comments <String>]
   [-DeploymentOption <DeploymentOptionType>]
   [-PreDownload <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-WriteFilterCommit <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-MovePhase <ReorderType>]
   [-MoveToOrder <Int32>]
   [-NewCollection <IResultObject>]
   [-NewCollectionId <String>]
   [-NewCollectionName <String>]
   [-NewPhaseName <String>]
   [-ThrottlingDays <Int32>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-Id <String>]
   [-Name <String>]
   [-Order <Int32>]
   [-PhasedDeploymentName] <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Gilt für Version 2006 und höher. Verwenden Sie dieses Cmdlet, um eine Bereitstellungsphase für eine Tasksequenz zu konfigurieren. Weitere Informationen finden Sie unter Erstellen von Bereitstellungen in Phasen.

Beispiele

Beispiel 1: Ändern der Auflistung

In diesem Beispiel wird die Auflistung für die zweite Phase in der phasenweisen Bereitstellung der Tasksequenz geändert, die über die Befehlszeile übergeben wird.

$phasedDeployment = Get-CMTaskSequencePhasedDeployment -Name "myPhasedDeployment"

$phasedDeployment | Set-CMTaskSequencePhase -Order 2 -NewCollectionId "XYZ00227"

Beispiel 2: Verschieben einer Phase nach oben

In diesem Beispiel wird eine Phase in der Reihenfolge nach oben verschoben. Es wählt die stufenweise Bereitstellung anhand ihrer ID und die Phase anhand der zugeordneten Sammlungs-ID aus.

Set-CMTaskSequencePhase -PhasedDeploymentId "0bc464d9-e7dd-44c1-a157-3f8be6a79c03" -CollectionId "XYZ00227" -MovePhase MoveUp

Beispiel 3: Konfigurieren von Phaseneinstellungen

In diesem Beispiel werden die Konfigurationseinstellungen für die ausgewählte Phase geändert.

Set-CMTaskSequencePhase -PhasedDeploymentName "myPhasedDeployment" -Name "phase1" -UserNotification HideAll -SoftwareInstallation $true -AllowSystemRestart $true -WriteFilterCommit $false -PreDownload $true -Comments "phase 1 comment" -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -AllowRemoteDP $true -AllowFallback $false -CriteriaOption Compliance -CriteriaValue 90 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 3 -ThrottlingDays 5 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 12

Parameter

-AllowFallback

Dieser Parameter entspricht der folgenden Einstellung auf der Seite Verteilungspunkte des Assistenten zum Hinzufügen von Phasen in der Konsole: Clients die Verwendung von Verteilungspunkten aus der Standardmäßigen Standortbegrenzungsgruppe erlauben.

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

-AllowRemoteDP

Dieser Parameter entspricht der folgenden Einstellung auf der Seite Verteilungspunkte des Assistenten zum Hinzufügen von Phasen in der Konsole: Wenn kein lokaler Verteilungspunkt verfügbar ist, verwenden Sie einen Remoteverteilungspunkt.

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

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

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

-Collection

Angeben eines Objekts für die Zielauflistung

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

-CollectionId

Geben Sie die Zielsammlung anhand der ID an.

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

-CollectionName

Geben Sie die Zielsammlung anhand des Namens an.

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

-Comments

Geben Sie optionale Kommentare für diese Phase an. Die maximale Länge beträgt 512 Zeichen.

Typ:String
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 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 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 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.

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 Phaseneinstellungen des Assistenten zum Hinzufügen von Phasen in der Konsole: Die Installation ist nach diesem Zeitraum erforderlich.

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

-DeploymentOption

Dieser Parameter entspricht der folgenden Einstellung auf der Seite Verteilungspunkte 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. Sie akzeptiert die folgenden Werte:

  • DownloadContentLocallyWhenNeededByRunningTaskSequence: Lokales Herunterladen von Inhalten bei Bedarf durch die ausgeführte Tasksequenz
  • DownloadAllContentLocallyBeforeStartingTaskSequence: Laden Sie alle Inhalte lokal herunter, bevor Sie die Tasksequenz starten.
Typ:DeploymentOptionType
Zulässige Werte:DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence
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

-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

-Id

Geben Sie die ID der zu konfigurierenden Phase an.

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

-InputObject

Geben Sie ein Bereitstellungsobjekt in Phasen an, das die zu konfigurierende Phase enthält.

Typ:IResultObject
Aliase:PhasedDeployment
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
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 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.

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

-MovePhase

Ändern Sie die Reihenfolge für die ausgewählte Phase. Sie können sie um eins nach oben, nach unten oder zu einem bestimmten Index verschieben. Wenn Sie angeben MoveToOrder, verwenden Sie den Parameter -MoveToOrder , um den spezifischen Index festzulegen.

Typ:ReorderType
Zulässige Werte:MoveUp, MoveDown, MoveToOrder
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MoveToOrder

Wenn Sie den Parameter -MovePhase auf MoveToOrderfestlegen, verwenden Sie diesen Parameter, um den spezifischen Index festzulegen.

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

-Name

Geben Sie den Namen der zu konfigurierenden Phase an.

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

-NewCollection

Geben Sie ein Auflistungsobjekt an, das als neues Ziel für die ausgewählte Phase verwendet werden soll.

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

-NewCollectionId

Geben Sie eine Sammlung nach ID an, die als neues Ziel für die ausgewählte Phase verwendet werden soll.

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

-NewCollectionName

Geben Sie eine Sammlung anhand des Namens an, die als neues Ziel für die ausgewählte Phase verwendet werden soll.

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

-NewPhaseName

Verwenden Sie diesen Parameter, um die ausgewählte Phase umzubenennen.

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

-Order

Geben Sie den Index der zu konfigurierenden Phase an.

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

-PhasedDeploymentId

Wählen Sie die stufenweise Bereitstellung nach ID aus. Verwenden Sie dann andere Parameter, um die spezifische Phase in dieser Bereitstellung auszuwählen.

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

-PhasedDeploymentName

Wählen Sie die stufenweise Bereitstellung anhand des Namens aus. Verwenden Sie dann andere Parameter, um die spezifische Phase in dieser Bereitstellung auszuwählen.

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

-PreDownload

Dieser Parameter entspricht der folgenden Einstellung auf der Seite Allgemein des Assistenten zum Hinzufügen von Phasen in der Konsole: Inhalt für diese Tasksequenz vorab herunterladen.

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

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
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 Phaseneinstellungen des Assistenten zum Hinzufügen von Phasen in der Konsole: Schrittweises Bereitstellen dieser Software über diesen Zeitraum (in Tagen).

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

-UserNotification

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
  • HideAll: Im Softwarecenter und alle Benachrichtigungen ausblenden
Typ:UserNotificationType
Zulässige Werte:DisplayAll, HideAll
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

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

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

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

IResultObject