Start-CMTaskSequenceDeployment

Modul:

ConfigurationManager

(Veraltet) Starten Sie eine Tasksequenzbereitstellung.

Syntax

Start-CMTaskSequenceDeployment
     [-AlertDateTime <DateTime>]
     [-AlertDay <DateTime>]
     [-AlertTime <DateTime>]
     [-AllowFallback <Boolean>]
     [-AllowSharedContent <Boolean>]
     [-Availability <MakeAvailableToType>]
     [-Collection <IResultObject>]
     [-CollectionId <String>]
     [-CollectionName <String>]
     [-Comment <String>]
     [-DeploymentAvailableDateTime <DateTime>]
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentExpireDateTime <DateTime>]
     [-DeploymentExpireDay <DateTime>]
     [-DeploymentExpireTime <DateTime>]
     [-DeploymentOption <DeploymentOptionType>]
     [-DeployPurpose <DeployPurposeType>]
     [-InputObject] <IResultObject>
     [-InternetOption <Boolean>]
     [-PassThru]
     [-PercentFailure <Int32>]
     [-PercentSuccess <Int32>]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-RerunBehavior <RerunBehaviorType>]
     [-RunFromSoftwareCenter <Boolean>]
     [-Schedule <IResultObject[]>]
     [-ScheduleEvent <ScheduleEventType[]>]
     [-SendWakeupPacket <Boolean>]
     [-ShowTaskSequenceProgress <Boolean>]
     [-SoftwareInstallation <Boolean>]
     [-SystemRestart <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtcForAvailableSchedule <Boolean>]
     [-UseUtcForExpireSchedule <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMTaskSequenceDeployment
     [-AlertDateTime <DateTime>]
     [-AlertDay <DateTime>]
     [-AlertTime <DateTime>]
     [-AllowFallback <Boolean>]
     [-AllowSharedContent <Boolean>]
     [-Availability <MakeAvailableToType>]
     [-Collection <IResultObject>]
     [-CollectionId <String>]
     [-CollectionName <String>]
     [-Comment <String>]
     [-DeploymentAvailableDateTime <DateTime>]
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentExpireDateTime <DateTime>]
     [-DeploymentExpireDay <DateTime>]
     [-DeploymentExpireTime <DateTime>]
     [-DeploymentOption <DeploymentOptionType>]
     [-DeployPurpose <DeployPurposeType>]
     [-InternetOption <Boolean>]
     [-PassThru]
     [-PercentFailure <Int32>]
     [-PercentSuccess <Int32>]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-RerunBehavior <RerunBehaviorType>]
     [-RunFromSoftwareCenter <Boolean>]
     [-Schedule <IResultObject[]>]
     [-ScheduleEvent <ScheduleEventType[]>]
     [-SendWakeupPacket <Boolean>]
     [-ShowTaskSequenceProgress <Boolean>]
     [-SoftwareInstallation <Boolean>]
     [-SystemRestart <Boolean>]
     [-TaskSequencePackageId] <String>
     [-UseMeteredNetwork <Boolean>]
     [-UseUtcForAvailableSchedule <Boolean>]
     [-UseUtcForExpireSchedule <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Beschreibung

Wichtig

Dieses Cmdlet ist veraltet. Verwenden Sie stattdessen New-CMTaskSequenceDeployment .

Verwenden Sie dieses Cmdlet, um eine Tasksequenzbereitstellung zu starten. Eine Tasksequenzbereitstellung weist einer Sammlung von Computern eine Tasksequenz zu. Weitere Informationen finden Sie unter Bereitstellen einer Tasksequenz in Configuration Manager.

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: Starten einer Tasksequenzbereitstellung mit Standardoptionen

Dieser Befehl startet eine Tasksequenzbereitstellung mit dem Namen der Tasksequenzbereitstellung und dem Namen einer Sammlung.

Get-CMTaskSequence -Name "Upgrade Windows 10" | Start-CMTaskSequenceDeployment -CollectionName "Collection 01"

Beispiel 2: Starten einer Tasksequenzbereitstellung mit konfigurierten Optionen

Dieser Befehl startet eine Tasksequenzbereitstellung mit mehreren konfigurierten Optionen.

Start-CMTaskSequenceDeployment -TaskSequencePackageId "XYZ00003" -CollectionName "Collection 02" -Comment "Task sequence test" -DeployPurpose Required -SendWakeUpPacket $True -UseMeteredNetwork $True -ScheduleEvent AsSoonAsPossible -RerunBehavior NeverRerunDeployedProgram -RunFromSoftwareCenter $True -ShowTaskSequenceProgress $False -SoftwareInstallation $True -SystemRestart $True -PersistOnWriteFilterDevice $False -AllowFallback $True -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -AllowSharedContent $True -InternetOption $True

Parameter

-AlertDateTime

Wenn Sie die Bereitstellung so konfigurieren, dass eine Warnung für eine erfolgreiche Bereitstellung erstellt wird, verwenden Sie diesen Parameter, um ein DateTime-Objekt anzugeben. Configuration Manager erstellt eine Bereitstellungswarnung, wenn der Schwellenwert nach diesem Datum niedriger als der PercentSuccess-Wert ist.

Verwenden Sie zum Abrufen dieses Objekts das integrierte Cmdlet Get-Date .

Typ:	DateTime
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-AlertDay

Dieser Parameter ist veraltet. Verwenden Sie AlertDateTime.

Typ:	DateTime
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-AlertTime

Dieser Parameter ist veraltet. Verwenden Sie AlertDateTime.

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.

Wenn Sie angebenClients, ist DownloadAllContentLocallyBeforeStartingTaskSequenceder Standardwert für den DeploymentOption-Parameter . Wenn Sie , MediaAndPxeoder MediaAndPxeHiddenangebenClientsMediaAndPxe, ist DownloadContentLocallyWhenNeededByRunningTaskSequenceder Standardwert für den DeploymentOption-Parameter .

Typ:	MakeAvailableToType
Aliase:	MakeAvailableTo
Zulässige Werte:	Clients, ClientsMediaAndPxe, MediaAndPxe, MediaAndPxeHidden
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Collection

Geben Sie ein Auflistungsobjekt an, für das diese Tasksequenz bereitgestellt wird. 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 die ID der Sammlung an, für die diese Tasksequenz bereitgestellt wird.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-CollectionName

Geben Sie den Namen der Sammlung an, in der diese Tasksequenz bereitgestellt wird.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-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:	False
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DeploymentAvailableDateTime

Geben Sie ein DateTime-Objekt für den Zeitpunkt an, an dem diese Bereitstellung verfügbar ist. Verwenden Sie zum Abrufen dieses Objekts das integrierte Cmdlet Get-Date .

Verwenden Sie DeploymentExpireDateTime, um anzugeben, wann die Bereitstellung abläuft, und Zeitplan, um die Bereitstellungszuweisung oder den Stichtag anzugeben.

Typ:	DateTime
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DeploymentAvailableDay

Dieser Parameter ist veraltet. Verwenden Sie DeploymentAvailableDateTime.

Typ:	DateTime
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DeploymentAvailableTime

Dieser Parameter ist veraltet. Verwenden Sie DeploymentAvailableDateTime.

Typ:	DateTime
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DeploymentExpireDateTime

Geben Sie ein DateTime-Objekt für den Ablauf dieser Bereitstellung an. Verwenden Sie zum Abrufen dieses Objekts das integrierte Cmdlet Get-Date .

Verwenden Sie DeploymentAvailableDateTime , um anzugeben, wann die Bereitstellung verfügbar ist, und Zeitplan , um die Bereitstellungszuweisung oder den Stichtag anzugeben.

Typ:	DateTime
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DeploymentExpireDay

Dieser Parameter ist veraltet. Verwenden Sie DeploymentExpireDateTime.

Typ:	DateTime
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DeploymentExpireTime

Dieser Parameter ist veraltet. Verwenden Sie DeploymentExpireDateTime.

Typ:	DateTime
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.

Wenn Sie für den Parameter Availability angebenClients, ist DownloadAllContentLocallyBeforeStartingTaskSequenceder Standardwert für diesen Parameter . Wenn Sie , MediaAndPxeoder MediaAndPxeHidden für den Availability-Parameter angebenClientsMediaAndPxe, ist DownloadContentLocallyWhenNeededByRunningTaskSequenceder Standardwert für diesen Parameter .

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

-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

Geben Sie ein Tasksequenzbereitstellungsobjekt an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMTaskSequenceDeployment .

Typ:	IResultObject
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-InternetOption

Gibt an, ob die Tasksequenz auf Clients ausgeführt wird, die eine Verbindung über das Internet herstellen.

Typ:	Boolean
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-PassThru

Fügen Sie diesen Parameter hinzu, um ein Objekt zurückzugeben, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet möglicherweise keine Ausgabe.

Typ:	SwitchParameter
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
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:	False
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

IResultObject

Ähnliche Themen

• New-CMTaskSequenceDeployment
• Get-CMTaskSequenceDeployment
• Set-CMTaskSequenceDeployment
• Remove-CMTaskSequenceDeployment
• Bereitstellen einer Tasksequenz in Configuration Manager