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 phasenweisen Bereitstellungen.
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. Sie wählt die phasenweise 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 gestatten.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowSystemRestart
Dieser Parameter entspricht der folgenden Einstellung auf der Seite "Benutzererfahrung" des Assistenten zum Hinzufügen von Phasen in der Konsole: Systemneustart (falls erforderlich, umdie Installation abzuschließen). Diese Einstellung gilt, wenn der Installationstermin erreicht ist, damit diese Aktivität außerhalb des Wartungsfensters ausgeführt werden kann.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BeginCondition
Geben Sie eine Option für den Beginn dieser Bereitstellungsphase nach dem Erfolg der vorherigen Phase an:
AfterPeriod
: Dieser Parameter entspricht der folgenden Einstellung auf der Seite "Phase Einstellungen" des Assistenten zum Hinzufügen von Phasen 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 Seite "Phase Einstellungen" des Assistenten zum Hinzufügen von Phasen in der Konsole: Beginnen Sie diese Bereitstellungsphase manuell.
Type: | BeginConditionType |
Accepted values: | AfterPeriod, Manually |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Collection
Angeben eines Objekts für die Zielsammlung
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionId
Geben Sie die Zielsammlung nach ID an.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Geben Sie die Zielsammlung anhand des Namens an.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Comments
Geben Sie optionale Kommentare für diese Phase an. Die maximale Länge beträgt 512 Zeichen.
Type: | String |
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 vorherigen Phase an:
Compliance
: Dieser Parameter entspricht der folgenden Einstellung auf der Seite "Phase Einstellungen" des Assistenten zum Hinzufügen von Phasen in der Konsole: Prozentsatz des Bereitstellungserfolgs. Geben Sie den Prozentwert mit dem Parameter CriteriaValue an.Number
: Dieser Parameter entspricht der folgenden Einstellung auf der Seite "Phase Einstellungen" 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.
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 vorherigen Phase an, um diese Phase zu beginnen. Dieser Parameter entspricht der folgenden Einstellung auf der Seite "Phase Einstellungen" des Assistenten zum Hinzufügen von Phasen 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 Seite "Phase Einstellungen" des Assistenten zum Hinzufügen von Phasen 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 |
-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 Standard-Standortgrenzengruppe verwendet. Sie akzeptiert die folgenden Werte:
DownloadContentLocallyWhenNeededByRunningTaskSequence
: Inhalte lokal herunterladen, wenn dies von der ausgeführten Tasksequenz benötigt wirdDownloadAllContentLocallyBeforeStartingTaskSequence
: Laden Sie alle Inhalte lokal herunter, bevor Sie die Tasksequenz starten
Type: | DeploymentOptionType |
Accepted values: | DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence |
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 |
-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 |
-Id
Geben Sie die ID der zu konfigurierenden Phase an.
Type: | String |
Aliases: | PhaseId |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Geben Sie ein phasenweises Bereitstellungsobjekt an, das die zu konfigurierende Phase enthält.
Type: | IResultObject |
Aliases: | PhasedDeployment |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
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 Seite "Phase Einstellungen" 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 "Phase Einstellungen" 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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MovePhase
Ändern Sie die Reihenfolge für die ausgewählte Phase. Sie können es nach oben, nach unten oder zu einem bestimmten Index verschieben. Wenn Sie dies MoveToOrder
angeben, verwenden Sie den Parameter "-MoveToOrder", um den spezifischen Index festzulegen.
Type: | ReorderType |
Accepted values: | MoveUp, MoveDown, MoveToOrder |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MoveToOrder
Wenn Sie den Parameter "-MovePhase" auf "-MovePhase" MoveToOrder
festlegen, verwenden Sie diesen Parameter, um den spezifischen Index festzulegen.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Geben Sie den Namen der zu konfigurierenden Phase an.
Type: | String |
Aliases: | PhaseName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewCollection
Geben Sie ein Auflistungsobjekt an, das als neues Ziel für die ausgewählte Phase verwendet werden soll.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewCollectionId
Geben Sie eine Auflistung nach ID an, die als neues Ziel für die ausgewählte Phase verwendet werden soll.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewCollectionName
Geben Sie eine Auflistung anhand des Namens an, die als neues Ziel für die ausgewählte Phase verwendet werden soll.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewPhaseName
Verwenden Sie diesen Parameter, um die ausgewählte Phase umzubenennen.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Order
Geben Sie den Index der zu konfigurierenden Phase an.
Type: | Int32 |
Aliases: | PhaseOrder |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PhasedDeploymentId
Wählen Sie die phasenweise Bereitstellung nach ID aus. Verwenden Sie dann andere Parameter, um die spezifische Phase in dieser Bereitstellung auszuwählen.
Type: | String |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PhasedDeploymentName
Wählen Sie die phasenweise Bereitstellung nach Namen aus. Verwenden Sie dann andere Parameter, um die spezifische Phase in dieser Bereitstellung auszuwählen.
Type: | String |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareInstallation
Dieser Parameter entspricht der folgenden Einstellung auf der Seite "Benutzererfahrung" des Assistenten zum Hinzufügen von Phasen in der Konsole: Softwareinstallation. Diese Einstellung gilt, wenn der Installationstermin erreicht ist, damit diese Aktivität außerhalb des Wartungsfensters ausgeführt werden kann.
Type: | Boolean |
Position: | Named |
Default value: | None |
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 "Phase Einstellungen" des Assistenten zum Hinzufügen von Phasen in der Konsole: Stellen Sie diese Software über diesen Zeitraum (in Tagen) schrittweise zur Verfügung.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserNotification
Dieser Parameter entspricht der folgenden Einstellung auf der Seite "Benutzererfahrung" des Assistenten zum Hinzufügen von Phasen in der Konsole: Geben Sie die Einstellung für die Benutzererfahrung für diese Bereitstellung mit den folgenden Werten an:
DisplayAll
: Anzeigen im Software Center und Anzeigen aller BenachrichtigungenHideAll
: Ausblenden im Software Center und aller Benachrichtigungen
Type: | UserNotificationType |
Accepted values: | DisplayAll, HideAll |
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 |
-WriteFilterCommit
Dieser Parameter ist identisch mit der folgenden Einstellung auf der Seite "Benutzererfahrung" des Assistenten zum Hinzufügen von Phasen in der Konsole: Übernehmen Sie einen Commit für Änderungen zum Stichtag oder während eines Wartungsfensters (neustart erforderlich). Diese Einstellung gilt für die Schreibfilterbehandlung für Windows Embedded-Geräte.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Ausgaben
IResultObject
Ähnliche Themen
- Get-CMPhase
- New-CMTaskSequencePhase
- Get-CMTaskSequencePhasedDeployment
- New-CMTaskSequenceAutoPhasedDeployment
- New-CMTaskSequenceManualPhasedDeployment
- Remove-CMTaskSequencePhasedDeployment
- Set-CMTaskSequencePhasedDeployment
- Get-CMPhasedDeploymentStatus
- Move-CMPhasedDeploymentToNext
- Resume-CMPhasedDeployment
- Suspend-CMPhasedDeployment
- Erstellen von phasenweisen Bereitstellungen