Start-CMTaskSequenceDeployment

Referenz

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-Websitelaufwerk aus, z. PS XYZ:\>B. . 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 .

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AlertDay

Dieser Parameter ist veraltet. Verwenden Sie AlertDateTime.

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AlertTime

Dieser Parameter ist veraltet. Verwenden Sie AlertDateTime.

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.

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

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

-Collection

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CollectionName

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-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:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DeploymentAvailableDay

Dieser Parameter ist veraltet. Verwenden Sie DeploymentAvailableDateTime.

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DeploymentAvailableTime

Dieser Parameter ist veraltet. Verwenden Sie DeploymentAvailableDateTime.

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DeploymentExpireDay

Dieser Parameter ist veraltet. Verwenden Sie DeploymentExpireDateTime.

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DeploymentExpireTime

Dieser Parameter ist veraltet. Verwenden Sie DeploymentExpireDateTime.

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

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

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

-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

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

Type:	IResultObject
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-InternetOption

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
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
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 können, 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:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

IResultObject