Set-CMTaskSequenceDeployment

Konfigurieren sie eine Tasksequenzbereitstellung.

Syntax

Set-CMTaskSequenceDeployment
   [-AlertDateTime <DateTime>]
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-AllowUsersRunIndependently <Boolean>]
   [-Comment <String>]
   [-CreateAlertOnFailure <Boolean>]
   [-CreateAlertOnSuccess <Boolean>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-DeploymentOption <DeploymentOptionType>]
   -InputObject <IResultObject>
   [-InternetOption <Boolean>]
   [-MakeAvailableTo <MakeAvailableToType>]
   [-PercentFailure <Int32>]
   [-PercentSuccess <Int32>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-ClearSchedule]
   [-RemoveSchedule <IResultObject[]>]
   [-AddSchedule <IResultObject[]>]
   [-Schedule <IResultObject[]>]
   [-ClearScheduleEvent]
   [-RemoveScheduleEvent <ScheduleEventType[]>]
   [-AddScheduleEvent <ScheduleEventType[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-ShowTaskSequenceProgress <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-SystemRestart <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTaskSequenceDeployment
   [-AlertDateTime <DateTime>]
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-AllowUsersRunIndependently <Boolean>]
   [-Comment <String>]
   [-CreateAlertOnFailure <Boolean>]
   [-CreateAlertOnSuccess <Boolean>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-DeploymentOption <DeploymentOptionType>]
   [-InternetOption <Boolean>]
   [-MakeAvailableTo <MakeAvailableToType>]
   [-PercentFailure <Int32>]
   [-PercentSuccess <Int32>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-ClearSchedule]
   [-RemoveSchedule <IResultObject[]>]
   [-AddSchedule <IResultObject[]>]
   [-Schedule <IResultObject[]>]
   [-ClearScheduleEvent]
   [-RemoveScheduleEvent <ScheduleEventType[]>]
   [-AddScheduleEvent <ScheduleEventType[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-ShowTaskSequenceProgress <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-SystemRestart <Boolean>]
   -TaskSequenceDeploymentId <String>
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTaskSequenceDeployment
   [-AlertDateTime <DateTime>]
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-AllowUsersRunIndependently <Boolean>]
   [-Comment <String>]
   [-CreateAlertOnFailure <Boolean>]
   [-CreateAlertOnSuccess <Boolean>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-DeploymentOption <DeploymentOptionType>]
   [-InternetOption <Boolean>]
   [-MakeAvailableTo <MakeAvailableToType>]
   [-PercentFailure <Int32>]
   [-PercentSuccess <Int32>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-ClearSchedule]
   [-RemoveSchedule <IResultObject[]>]
   [-AddSchedule <IResultObject[]>]
   [-Schedule <IResultObject[]>]
   [-ClearScheduleEvent]
   [-RemoveScheduleEvent <ScheduleEventType[]>]
   [-AddScheduleEvent <ScheduleEventType[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-ShowTaskSequenceProgress <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-SystemRestart <Boolean>]
   -TaskSequenceName <String>
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTaskSequenceDeployment
   [-AlertDateTime <DateTime>]
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-AllowUsersRunIndependently <Boolean>]
   [-Comment <String>]
   [-CreateAlertOnFailure <Boolean>]
   [-CreateAlertOnSuccess <Boolean>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-DeploymentOption <DeploymentOptionType>]
   [-InternetOption <Boolean>]
   [-MakeAvailableTo <MakeAvailableToType>]
   [-PercentFailure <Int32>]
   [-PercentSuccess <Int32>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-ClearSchedule]
   [-RemoveSchedule <IResultObject[]>]
   [-AddSchedule <IResultObject[]>]
   [-Schedule <IResultObject[]>]
   [-ClearScheduleEvent]
   [-RemoveScheduleEvent <ScheduleEventType[]>]
   [-AddScheduleEvent <ScheduleEventType[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-ShowTaskSequenceProgress <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-SystemRestart <Boolean>]
   -TaskSequencePackageId <String>
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet "Set-CMTaskSequenceDeployment" konfiguriert eine Tasksequenzbereitstellung. Eine Tasksequenzbereitstellung weist einer Sammlung von Computern eine Tasksequenz zu.

Hinweis

Führen Sie Configuration Manager-Cmdlets beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\> aus. Weitere Informationen finden Sie unter "Erste Schritte".

Beispiele

Beispiel 1: Konfigurieren einer Bereitstellung zum Anzeigen des Fortschritts

Mit diesem Befehl wird die Bereitstellung der Tasksequenz mithilfe des Tasksequenznamens und des Sammlungsnamens konfiguriert. Er legt den Kommentar fest und ermöglicht es dem Client, den Fortschritt der Tasksequenz anzuzeigen.

Set-CMTaskSequenceDeployment -TaskSequenceName "Task Sequence 1333" -CollectionName "All Systems" -Comment "Task sequence test" -ShowTaskSequenceProgress $True

Beispiel 2: Neukonfiguration einer Tasksequenzbereitstellung

Mit diesem Befehl werden die meisten Einstellungen für eine Tasksequenzbereitstellung neu konfiguriert.

Set-CMTaskSequenceDeployment -TaskSequenceName "Task Sequence 1333" -CollectionName "All Desktop and Server Clients" -Comment "Task sequence test" -SendWakeupPacket $True -UseMeteredNetwork $True -DeploymentExpireDateTime $(Get-Date) -ScheduleEvent LogOff -RerunBehavior NeverRerunDeployedProgram -AllowUsersRunIndependently $True -ShowTaskSequenceProgress $False -SoftwareInstallation $True -SystemRestart $True -PersistOnWriteFilterDevice $False -InternetOption $True -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -AllowFallback $True -AllowSharedContent $True

Parameter

-AddSchedule

Geben Sie ein Zeitplantokenobjekt an, das der Bereitstellung hinzugefügt werden soll. Verwenden Sie zum Erstellen eines Zeitplanobjekts das Cmdlet "New-CMSchedule".

Type:IResultObject[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AddScheduleEvent

Geben Sie eines der akzeptierten Zeitplanereignisse an, die der Bereitstellung hinzugefügt werden sollen.

Type:ScheduleEventType[]
Accepted values:AsSoonAsPossible, LogOn, LogOff
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AlertDateTime

Gibt die Uhrzeit der Warnung an.

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

-AllowFallback

Gibt an, ob Clients einen Fallbackquellspeicherort für Inhalte verwenden dürfen.

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

-AllowSharedContent

Gibt an, ob freigegebene Inhalte zugelassen werden sollen.

Type:Boolean
Aliases:AllowUseRemoteDistributionPoint
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AllowUsersRunIndependently

Gibt an, ob Benutzer das Programm unabhängig vom Zuweisungsstatus unabhängig voneinander ausführen können.

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

-ClearSchedule

Fügen Sie diesen Parameter hinzu, um alle Zeitpläne aus der Bereitstellung zu entfernen.

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

-ClearScheduleEvent

Fügen Sie diesen Parameter hinzu, um alle Zeitplanereignisse aus der Bereitstellung zu entfernen.

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

-Collection

Gibt ein Auflistungsobjekt als Ziel der Bereitstellung an.

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

-CollectionId

Gibt die ID einer Auflistung als Ziel der Bereitstellung an.

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

-CollectionName

Gibt den Namen einer Auflistung an, die für den Empfang einer Tasksequenzbereitstellung vorgesehen ist.

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

-Comment

Gibt einen optionalen Kommentar für die Bereitstellung der Tasksequenz an, um ihn zu beschreiben.

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

-CreateAlertOnFailure

Gibt an, ob eine Warnung bei einem Fehler erstellt werden soll.

Type:Boolean
Aliases:CreateAlertBaseOnPercentFailure
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CreateAlertOnSuccess

Gibt an, ob bei Erfolg eine Warnung erstellt werden soll.

Type:Boolean
Aliases:CreateAlertBaseOnPercentSuccess
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentAvailableDateTime

Gibt den verfügbaren Bereitstellungszeitpunkt für die Bereitstellung an.

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

-DeploymentExpireDateTime

Gibt das Datum des Bereitstellungsablaufs an.

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

-DeploymentOption

Gibt an, ob Clients alle Inhalte vor dem Starten der Tasksequenz herunterladen oder inhalte nach Bedarf von der ausgeführten Tasksequenz herunterladen.

Type:DeploymentOptionType
Accepted values:DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence, RunFromDistributionPoint
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.

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

-ForceWildcardHandling

Dieser Parameter verarbeitet Platzhalterzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandlingkombinieren.

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

-InputObject

Gibt ein Tasksequenz-Bereitstellungsobjekt an. Verwenden Sie zum Abrufen eines Tasksequenzobjekts das Cmdlet "Get-CMTaskSequenceDeployment".

Type:IResultObject
Aliases:Deployment, DeploymentSummary, TaskSequence, Advertisement
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-InternetOption

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

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

-MakeAvailableTo

Gibt an, ob diese Tasksequenz für Configuration Manager-Clients verfügbar sein soll und ob sie verfügbar sein soll, wenn Sie ein Betriebssystem mithilfe von Startmedien, Vorabmedien oder PXE bereitstellen.

Type:MakeAvailableToType
Accepted values:Clients, ClientsMediaAndPxe, MediaAndPxe, MediaAndPxeHidden
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Gibt das aktuelle Arbeitsobjekt zurück. Standardmäßig generiert dieses Cmdlet keine Ausgabe.

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

-PercentFailure

Gibt einen Schwellenwert für die Bereitstellung einer fehlerhaften Tasksequenz an.

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

-PercentSuccess

Gibt einen Schwellenwert für eine erfolgreiche Bereitstellung der Tasksequenz an.

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

-PersistOnWriteFilterDevice

Gibt an, ob eine Tasksequenz auf der temporären Überlagerung installiert und änderungen zu einem späteren Zeitpunkt oder zu einem Installations- oder Wartungsfenster ausgeführt werden sollen. Diese Einstellung gilt für Geräte mit einer eingebetteten Edition von Windows mit einem Schreibfilter.

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

-RemoveSchedule

Geben Sie ein Zeitplantokenobjekt an, das aus der Bereitstellung entfernt werden soll. Verwenden Sie zum Erstellen eines Zeitplanobjekts das Cmdlet "New-CMSchedule".

Type:IResultObject[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RemoveScheduleEvent

Geben Sie eines der akzeptierten Zeitplanereignisse an, die aus der Bereitstellung entfernt werden sollen.

Type:ScheduleEventType[]
Accepted values:AsSoonAsPossible, LogOn, LogOff
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RerunBehavior

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

-Schedule

Gibt ein Array von CMSchedule-Objekten an. Ein CMSchedule -Objekt definiert den obligatorischen Zuweisungszeitplan für eine Bereitstellung. Verwenden Sie das Cmdlet "New-CMSchedule", um ein CMSchedule-Objekt zu erstellen.

Type:IResultObject[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ScheduleEvent

Gibt ein Array von Ereignissen an, die bestimmen, wann die Bereitstellung der Tasksequenz ausgeführt wird.

Type:ScheduleEventType[]
Accepted values:AsSoonAsPossible, LogOn, LogOff
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SendWakeupPacket

Gibt an, ob ein Reaktivierungspaket an Computer gesendet werden soll, bevor die Bereitstellung beginnt. Wenn dieser Wert $True ist, aktiviert Configuration Manager einen Computer aus dem Ruhezustand. Wenn dieser Wert $False ist, werden Computer nicht aus dem Ruhezustand aktiviert. Damit Computer aktiviert werden können, konfigurieren Sie zuerst "Wake On LAN".

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

-SoftwareInstallation

Gibt an, ob die Anwendung installiert werden soll, auch wenn die Installation außerhalb eines Wartungsfensters erfolgt.

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

-SystemRestart

Gibt an, ob einem angekündigten Programm der Neustart des Systems gestattet werden soll, auch wenn der Neustart außerhalb eines Wartungsfensters erfolgt.

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

-TaskSequenceDeploymentId

Gibt eine ID für eine zu konfigurierende Tasksequenzbereitstellung an.

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

-TaskSequenceName

Gibt einen Namen für die bereitzustellende Tasksequenz an.

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

-TaskSequencePackageId

Gibt eine ID für eine bereitzustellende Tasksequenz an.

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

-UseMeteredNetwork

Gibt an, ob clients on a metered internet connection to download content after the installation deadline, which might incurs additional costs.

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

-UseUtcForAvailableSchedule

Gibt an, ob Clientcomputer UTC-Zeit verwenden, um die Verfügbarkeit eines Programms zu bestimmen. Die UTC-Zeit macht die Tasksequenz für alle Computer gleichzeitig verfügbar.

Type:Boolean
Position:Named
Default value:None
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 für alle Computer gleichzeitig verfügbar.

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

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

IResultObject