New-CMTaskSequenceDeployment
Erstellen Sie eine Tasksequenzbereitstellung.
Syntax
New-CMTaskSequenceDeployment
[-AlertDateTime <DateTime>]
[-AllowFallback <Boolean>]
[-AllowSharedContent <Boolean>]
[-Availability <MakeAvailableToType>]
[-DeadlineDateTime <DateTime>]
[-DeploymentOption <DeploymentOptionType>]
[-DeployPurpose <DeployPurposeType>]
[-InputObject] <IResultObject>
[-InternetOption <Boolean>]
[-PercentFailure <Int32>]
[-PercentSuccess <Int32>]
[-RerunBehavior <RerunBehaviorType>]
[-RunFromSoftwareCenter <Boolean>]
[-Schedule <IResultObject[]>]
[-ScheduleEvent <ScheduleEventType[]>]
[-ShowTaskSequenceProgress <Boolean>]
[-SoftwareInstallation <Boolean>]
[-SystemRestart <Boolean>]
[-UseUtcForAvailableSchedule <Boolean>]
[-UseUtcForExpireSchedule <Boolean>]
[-DistributeCollectionName <String>]
[-DistributeContent]
[-DistributionPointGroupName <String>]
[-DistributionPointName <String>]
[-AvailableDateTime <DateTime>]
[-Comment <String>]
[-PersistOnWriteFilterDevice <Boolean>]
[-SendWakeupPacket <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMTaskSequenceDeployment
[-AlertDateTime <DateTime>]
[-AllowFallback <Boolean>]
[-AllowSharedContent <Boolean>]
[-Availability <MakeAvailableToType>]
[-DeadlineDateTime <DateTime>]
[-DeploymentOption <DeploymentOptionType>]
[-DeployPurpose <DeployPurposeType>]
[-InternetOption <Boolean>]
[-PercentFailure <Int32>]
[-PercentSuccess <Int32>]
[-RerunBehavior <RerunBehaviorType>]
[-RunFromSoftwareCenter <Boolean>]
[-Schedule <IResultObject[]>]
[-ScheduleEvent <ScheduleEventType[]>]
[-ShowTaskSequenceProgress <Boolean>]
[-SoftwareInstallation <Boolean>]
[-SystemRestart <Boolean>]
[-TaskSequencePackageId] <String>
[-UseUtcForAvailableSchedule <Boolean>]
[-UseUtcForExpireSchedule <Boolean>]
[-DistributeCollectionName <String>]
[-DistributeContent]
[-DistributionPointGroupName <String>]
[-DistributionPointName <String>]
[-AvailableDateTime <DateTime>]
[-Comment <String>]
[-PersistOnWriteFilterDevice <Boolean>]
[-SendWakeupPacket <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Beschreibung
Das Cmdlet New-CMTaskSequenceDeployment erstellt eine Tasksequenzbereitstellung. Eine Tasksequenzbereitstellung weist einer Sammlung von Computern eine Tasksequenz zu.
Hinweis
Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.
Beispiele
Beispiel 1: Bereitstellen einer Tasksequenz mit vielen allgemeinen Parametern
In diesem Beispiel werden die folgenden Aktionen ausgeführt:
- Verwenden Sie das Cmdlet Get-CMTaskSequence , um das bereitzustellende Tasksequenzobjekt abzurufen und in der variablen $DeployTS zu speichern.
- Definieren Sie die Sammlung als Ziel der Bereitstellung in der Variablen $DeployCollection
- Definieren Sie die verfügbare Bereitstellungszeit am 25. November 2025 um 20:00 Uhr in der Variablen $DeployAvailableTime
- Definieren Sie die Ablaufzeit der Bereitstellung am 25. Januar 2026 um 20:00 Uhr in der Variablen $DeployExpireTime
- Definieren Sie den Bereitstellungsstichtag am 25. Dezember 2025 um 20:00 Uhr in der Variablen $ScheduleDateTime
- Verwenden Sie das Cmdlet New-CMSchedule , um ein Zeitplanobjekt für den Stichtag mit einem täglich wiederkehrenden Zeitplan zu erstellen.
- Bereitstellen der Tasksequenz
$DeployTS = Get-CMTaskSequence -TaskSequencePackageId 'PS104823'
$DeployCollection = 'PS11B7C4'
$DeployAvailableTime = [datetime]::ParseExact("20251125-200000", "yyyyMMdd-HHmmss", $null)
$DeployExpireTime = [datetime]::ParseExact("20260125-200000", "yyyyMMdd-HHmmss", $null)
$ScheduleDateTime = [datetime]::ParseExact("20251225-200000", "yyyyMMdd-HHmmss", $null)
$DeploySchedule = New-CMSchedule -DurationInterval Days -RecurInterval Days -RecurCount 1 -DurationCount 0 -Start $ScheduleDateTime
New-CMTaskSequenceDeployment -InputObject $DeployTS -DeployPurpose Required -AvailableDateTime $DeployAvailableTime -Availability Clients -RerunBehavior AlwaysRerunProgram -Schedule $DeploySchedule -CollectionId $DeployCollection -ShowTaskSequenceProgress $true -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -RunFromSoftwareCenter $true -DeadlineDateTime $DeployExpireTimeParameter
-AlertDateTime
Wenn Sie eine Bereitstellungswarnung aktivieren, verwenden Sie diesen Parameter, um eine Uhrzeit für die Warnung anzugeben.
| Typ: | DateTime |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-AllowFallback
Zulassen, dass Clients Verteilungspunkte aus der Standardmäßigen Standortbegrenzungsgruppe verwenden können.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-AllowSharedContent
Ermöglichen Sie Clients die Verwendung von Verteilungspunkten aus einer benachbarten Begrenzungsgruppe.
| Typ: | Boolean |
| Aliase: | AllowUseRemoteDistributionPoint |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Availability
Geben Sie an, ob diese Tasksequenz für Configuration Manager-Clients verfügbar sein soll und ob sie ausgeführt werden kann, wenn Sie ein Betriebssystem mithilfe von Startmedien, vorab bereitgestellten Medien oder PXE bereitstellen.
| Typ: | MakeAvailableToType |
| Aliase: | MakeAvailableTo |
| Zulässige Werte: | Clients, ClientsMediaAndPxe, MediaAndPxe, MediaAndPxeHidden |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-AvailableDateTime
Geben Sie an, wann diese Bereitstellung verfügbar ist.
Verwenden Sie -DeadlineDateTime , um anzugeben, wann die Bereitstellung abläuft, und -Schedule , um die Bereitstellungszuweisung oder den Stichtag anzugeben.
| Typ: | DateTime |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Collection
Geben Sie ein Auflistungsobjekt als Ziel für diese Tasksequenzbereitstellung an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMCollection .
| Typ: | IResultObject |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CollectionId
Geben Sie eine Sammlungs-ID als Ziel für diese Tasksequenzbereitstellung an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CollectionName
Geben Sie einen Sammlungsnamen als Ziel für diese Tasksequenzbereitstellung an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | True |
-Comment
Geben Sie einen optionalen Kommentar für die Tasksequenzbereitstellung an.
| 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 |
-DeadlineDateTime
Verwenden Sie diesen Parameter, um anzugeben, wann die Bereitstellung abläuft.
Verwenden Sie -AvailableDateTime , um anzugeben, wann die Bereitstellung verfügbar ist, und -Schedule , um die Bereitstellungszuweisung oder den Stichtag anzugeben.
| Typ: | DateTime |
| Aliase: | DeploymentExpireDateTime |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DeploymentOption
Geben Sie an, wie Clients mit den Verteilungspunkten interagieren, um Inhalte für die Tasksequenz abzurufen. In bestimmten Szenarien sind nicht alle Optionen verfügbar. Weitere Informationen finden Sie unter Bereitstellen einer Tasksequenz – Bereitstellungsoptionen.
| Typ: | DeploymentOptionType |
| Zulässige Werte: | DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence, RunFromDistributionPoint |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DeployPurpose
Geben Sie an, ob diese Bereitstellung für Benutzer zur Installation verfügbar ist oder ob die Installation zum Stichtag erforderlich ist.
| Typ: | DeployPurposeType |
| Zulässige Werte: | Available, Required |
| 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 |
-DistributeCollectionName
Die Website verteilt Inhalt an die Verteilungspunktgruppen, die diesem Sammlungsnamen zugeordnet sind.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DistributeContent
Fügen Sie diesen Parameter hinzu, um den Inhalt der Tasksequenz zu verteilen, wenn Sie diese Bereitstellung erstellen. Clients können die Tasksequenz erst installieren, wenn Sie Inhalte an Verteilungspunkte verteilen, auf die die Clients zugreifen können.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DistributionPointGroupName
Der Standort verteilt Inhalte an diese Verteilungspunktgruppe.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DistributionPointName
Der Standort verteilt Inhalte an diesen Verteilungspunkt.
| 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 (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-InputObject
Gibt ein bereitzustellende Tasksequenzobjekt an. Verwenden Sie zum Abrufen eines Tasksequenzobjekts das Cmdlet Get-CMTaskSequence .
| Typ: | IResultObject |
| Aliase: | TaskSequence |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-InternetOption
Zulassen, dass die Tasksequenz für Clients im Internet ausgeführt wird.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PercentFailure
Wenn Sie eine Warnung für fehlerhafte Bereitstellungen erstellen, generiert der Standort eine Warnung, wenn der Prozentsatz der fehlerhaften Bereitstellungen höher als diese Anzahl ist.
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PercentSuccess
Wenn Sie eine Warnung für erfolgreiche Bereitstellungen erstellen, generiert der Standort eine Warnung, wenn der Prozentsatz der erfolgreichen Bereitstellungen niedriger als diese Anzahl ist.
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PersistOnWriteFilterDevice
Konfigurieren Sie, wie der Client den Schreibfilter auf Windows Embedded-Geräten behandelt.
-
$true: Committen von Änderungen am Stichtag oder während eines Wartungsfensters. Ein Neustart ist erforderlich. -
$false: Inhalt auf das Overlay anwenden und später committen.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-RerunBehavior
Geben Sie an, ob die Tasksequenz auf einem Computer erneut ausgeführt wird, wenn sie zuvor vor der geplanten obligatorischen Zeit ausgeführt wurde. Standardmäßig wird die Tasksequenz immer erneut ausgeführt.
| Typ: | RerunBehaviorType |
| Zulässige Werte: | NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-RunFromSoftwareCenter
Ermöglichen Sie Benutzern, das Programm unabhängig von Zuweisungen auszuführen.
| Typ: | Boolean |
| Aliase: | AllowUsersRunIndependently |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Schedule
Verwenden Sie diesen Parameter, um die Bereitstellungszuweisung oder den Stichtag anzugeben.
Verwenden Sie -AvailableDateTime , um anzugeben, wann die Bereitstellung verfügbar ist, und -DeadlineDateTime , um anzugeben, wann die Bereitstellung abläuft.
Geben Sie ein Array von Zeitplanobjekten an. Ein Zeitplanobjekt definiert den obligatorischen Zuweisungszeitplan für eine Bereitstellung. Verwenden Sie zum Erstellen eines Zeitplanobjekts das Cmdlet New-CMSchedule .
| Typ: | IResultObject[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ScheduleEvent
Gibt ein Array von Ereignissen an, die bestimmen, wann die Tasksequenzbereitstellung ausgeführt wird.
| Typ: | ScheduleEventType[] |
| Zulässige Werte: | AsSoonAsPossible, LogOn, LogOff |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SendWakeupPacket
Gibt an, ob vor Beginn der Bereitstellung ein Aktivierungspaket an Computer gesendet werden soll. Wenn dieser Wert ist $True, reaktiviert Configuration Manager einen Computer aus dem Ruhezustand. Wenn dieser Wert ist $False, werden Computer nicht aus dem Ruhezustand reaktiviert. Damit Computer aktiviert werden können, konfigurieren Sie zuerst Wake-On-LAN.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ShowTaskSequenceProgress
Gibt an, ob ein Prozessdialogfeld für eine Tasksequenz angezeigt werden soll.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SoftwareInstallation
Wenn der Installationsstichtag erreicht ist, legen Sie diesen Parameter auf fest $true , damit die Tasksequenz außerhalb des Wartungsfensters installiert werden kann.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SystemRestart
Wenn der Installationsstichtag erreicht ist, legen Sie diesen Parameter auf fest $true , um den Systemneustart ggf. außerhalb des Wartungsfensters zuzulassen.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-TaskSequencePackageId
Geben Sie die ID der bereitzustellenden Tasksequenz an.
| Typ: | String |
| Aliase: | PackageId, TaskSequenceId |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UseMeteredNetwork
Gibt an, ob Clients über eine getaktete Internetverbindung inhalte nach dem Installationsstichtag herunterladen dürfen, was zusätzliche Kosten verursachen kann.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UseUtcForAvailableSchedule
Gibt an, ob Clientcomputer UTC-Zeit verwenden, um die Verfügbarkeit eines Programms zu bestimmen. Die UTC-Zeit macht die Tasksequenz gleichzeitig für alle Computer verfügbar.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UseUtcForExpireSchedule
Gibt an, ob Clientcomputer UTC-Zeit verwenden, um den Ablauf eines Programms zu bestimmen. Die UTC-Zeit macht die Tasksequenz gleichzeitig für alle Computer verfügbar.
| Typ: | Boolean |
| 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
Hinweise
Stellen Sie sicher, dass Sie die Zeitplanparameter entsprechend verwenden:
-AvailableDateTime: Geben Sie an, wann diese Bereitstellung verfügbar ist.
-DeadlineDateTime: Geben Sie an, wann die Bereitstellung abläuft.
-Zeitplan: Geben Sie die Bereitstellungszuweisung oder den Stichtag an.