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