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 $true
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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | BeginConditionType |
Accepted values: | AfterPeriod, Manually |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Collection
Angeben eines Objekts für die Zielauflistung
Type: | IResultObject |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionId
Geben Sie die Zielsammlung anhand der ID an.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Geben Sie die Zielsammlung anhand des Namens an.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
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 |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 CriteriaValue-Parameter an.
Type: | CriteriaType |
Accepted values: | Compliance, Number |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
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 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.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineUnit
Geben Sie den Typ des Stichtags an. Verwenden Sie diesen Parameter mit DeadlineValue.
Type: | TimeUnitType |
Accepted values: | Hours, Days, Weeks, Months |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
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 Standardmäßigen Standortbegrenzungsgruppe verwendet. Sie akzeptiert die folgenden Werte:
DownloadContentLocallyWhenNeededByRunningTaskSequence
: Lokales Herunterladen von Inhalten bei Bedarf durch die ausgeführte TasksequenzDownloadAllContentLocallyBeforeStartingTaskSequence
: Laden Sie alle Inhalte lokal herunter, bevor Sie die Tasksequenz starten.
Type: | DeploymentOptionType |
Accepted values: | DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | InstallationChoiceType |
Accepted values: | AsSoonAsPossible, AfterPeriod |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PhaseName
Geben Sie einen Namen für die Phase an.
Type: | String |
Aliases: | Name |
Position: | Named |
Default value: | None |
Required: | True |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
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 Phaseneinstellungen des Assistenten zum Hinzufügen von Phasen in der Konsole: Schrittweises Bereitstellen dieser Software über diesen Zeitraum (in Tagen).
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 BenachrichtigungenHideAll
: Im Softwarecenter und alle Benachrichtigungen ausblenden
Type: | UserNotificationType |
Accepted values: | DisplayAll, HideAll |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
None
Ausgaben
Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für