New-CMTaskSequencePhase
Verwenden Sie dieses Cmdlet, um eine Bereitstellungsphase für eine Tasksequenz zu erstellen.
Syntax
New-CMTaskSequencePhase
[-AllowFallback <Boolean>]
[-AllowRemoteDP <Boolean>]
[-AllowSystemRestart <Boolean>]
[-BeginCondition <BeginConditionType>]
[-Collection] <IResultObject>
[-Comments <String>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-DeploymentOption <DeploymentOptionType>]
[-InstallationChoice <InstallationChoiceType>]
-PhaseName <String>
[-PreDownload <Boolean>]
[-SoftwareInstallation <Boolean>]
[-ThrottlingDays <Int32>]
[-UserNotification <UserNotificationType>]
[-WriteFilterCommit <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMTaskSequencePhase
[-AllowFallback <Boolean>]
[-AllowRemoteDP <Boolean>]
[-AllowSystemRestart <Boolean>]
[-BeginCondition <BeginConditionType>]
[-CollectionId] <String>
[-Comments <String>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-DeploymentOption <DeploymentOptionType>]
[-InstallationChoice <InstallationChoiceType>]
-PhaseName <String>
[-PreDownload <Boolean>]
[-SoftwareInstallation <Boolean>]
[-ThrottlingDays <Int32>]
[-UserNotification <UserNotificationType>]
[-WriteFilterCommit <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMTaskSequencePhase
[-AllowFallback <Boolean>]
[-AllowRemoteDP <Boolean>]
[-AllowSystemRestart <Boolean>]
[-BeginCondition <BeginConditionType>]
[-CollectionName] <String>
[-Comments <String>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-DeploymentOption <DeploymentOptionType>]
[-InstallationChoice <InstallationChoiceType>]
-PhaseName <String>
[-PreDownload <Boolean>]
[-SoftwareInstallation <Boolean>]
[-ThrottlingDays <Int32>]
[-UserNotification <UserNotificationType>]
[-WriteFilterCommit <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Beschreibung
Verwenden Sie dieses Cmdlet, um eine Bereitstellungsphase für eine Tasksequenz zu erstellen.
Beispiele
Beispiel 1: Erstellen einer Tasksequenzphase
In diesem Beispiel wird eine Tasksequenzphase mit dem Namen MyTSPhase für die Sammlung mit dem Namen MyCollection erstellt.
New-CMTaskSequencePhase -CollectionName "MyCollection" -PhaseName "MyTSPhase" -UserNotification DisplayAll -AllowRemoteDP $trueParameter
-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: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CollectionId
Geben Sie die Zielsammlung anhand der ID an.
| Typ: | String |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CollectionName
Geben Sie die Zielsammlung anhand des Namens an.
| Typ: | String |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| 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 |
-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 |
-PhaseName
Geben Sie einen Namen für die Phase an.
| Typ: | String |
| Aliase: | Name |
| Position: | Named |
| 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
None
Ausgaben
Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase