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-Websitelaufwerk aus, z. PS XYZ:\>
B. . 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 den Bereitstellungsablauf 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 $DeployExpireTime
Parameter
-AlertDateTime
Wenn Sie eine Bereitstellungswarnung aktivieren, verwenden Sie diesen Parameter, um eine Uhrzeit für die Warnung anzugeben.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowFallback
Zulassen, dass Clients Verteilungspunkte aus der Standardmäßigen Standortbegrenzungsgruppe verwenden können.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowSharedContent
Zulassen, dass Clients Verteilungspunkte aus einer benachbarten Begrenzungsgruppe verwenden können.
Type: | Boolean |
Aliases: | AllowUseRemoteDistributionPoint |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Availability
Geben Sie an, ob diese Tasksequenz Configuration Manager Clients zur Verfügung gestellt werden soll und ob sie ausgeführt werden kann, wenn Sie ein Betriebssystem mithilfe von Startmedien, vorab bereitgestellten Medien oder PXE bereitstellen.
Type: | MakeAvailableToType |
Aliases: | MakeAvailableTo |
Accepted values: | Clients, ClientsMediaAndPxe, MediaAndPxe, MediaAndPxeHidden |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Collection
Geben Sie ein Auflistungsobjekt als Ziel für diese Tasksequenzbereitstellung an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMCollection .
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionId
Geben Sie eine Sammlungs-ID als Ziel für diese Tasksequenzbereitstellung an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Geben Sie einen Sammlungsnamen als Ziel für diese Tasksequenzbereitstellung an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Comment
Geben Sie einen optionalen Kommentar für die Tasksequenzbereitstellung an.
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 |
-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.
Type: | DateTime |
Aliases: | DeploymentExpireDateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | DeploymentOptionType |
Accepted values: | DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence, RunFromDistributionPoint |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeployPurpose
Geben Sie an, ob diese Bereitstellung für Benutzer zur Installation verfügbar ist oder ob die Installation zum Stichtag erforderlich ist.
Type: | DeployPurposeType |
Accepted values: | Available, Required |
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 |
-DistributeCollectionName
Die Website verteilt Inhalt an die Verteilungspunktgruppen, die diesem Sammlungsnamen zugeordnet sind.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DistributionPointGroupName
Der Standort verteilt Inhalte an diese Verteilungspunktgruppe.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DistributionPointName
Der Standort verteilt Inhalte an diesen Verteilungspunkt.
Type: | String |
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 (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 |
-InputObject
Gibt ein bereitzustellende Tasksequenzobjekt an. Verwenden Sie zum Abrufen eines Tasksequenzobjekts das Cmdlet Get-CMTaskSequence .
Type: | IResultObject |
Aliases: | TaskSequence |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InternetOption
Zulassen, dass die Tasksequenz für Clients im Internet ausgeführt wird.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | RerunBehaviorType |
Accepted values: | NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunFromSoftwareCenter
Ermöglichen Sie Benutzern, das Programm unabhängig von Zuweisungen auszuführen.
Type: | Boolean |
Aliases: | AllowUsersRunIndependently |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | IResultObject[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScheduleEvent
Gibt ein Array von Ereignissen an, die bestimmen, wann die Tasksequenzbereitstellung ausgeführt wird.
Type: | ScheduleEventType[] |
Accepted values: | AsSoonAsPossible, LogOn, LogOff |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SendWakeupPacket
Gibt an, ob vor Beginn der Bereitstellung ein Aktivierungspaket an Computer gesendet werden soll. Wenn dieser Wert ist$True
, aktiviert 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ShowTaskSequenceProgress
Gibt an, ob ein Prozessdialogfeld für eine Tasksequenz angezeigt werden soll.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareInstallation
Wenn der Installationsstichtag erreicht ist, legen Sie diesen Parameter auf fest $true
, damit die Tasksequenz außerhalb des Wartungsfensters installiert werden kann.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SystemRestart
Wenn der Installationsstichtag erreicht ist, legen Sie diesen Parameter auf fest $true
, um den Systemneustart ggf. außerhalb des Wartungsfensters zuzulassen.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TaskSequencePackageId
Geben Sie die ID der bereitzustellenden Tasksequenz an.
Type: | String |
Aliases: | PackageId, TaskSequenceId |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseMeteredNetwork
Gibt an, ob Clients über eine getaktete Internetverbindung inhalte nach dem Installationsstichtag herunterladen dürfen, was zusätzliche Kosten verursachen kann.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseUtcForAvailableSchedule
Gibt an, ob Clientcomputer die UTC-Zeit verwenden, um die Verfügbarkeit eines Programms zu bestimmen. Die UTC-Zeit macht die Tasksequenz gleichzeitig für alle Computer verfügbar.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Boolean |
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 |
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.
Ähnliche Themen
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