Freigeben über

Set-CMTaskSequence

  • Referenz
Modul:
ConfigurationManager

Legt eine Configuration Manager-Tasksequenz fest.

Syntax

Set-CMTaskSequence
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   [-BootImageId <String>]
   [-Category <String>]
   [-CustomText <String>]
   [-DeploymentPackageId <String>]
   [-Description <String>]
   [-DisableTaskSequence <Boolean>]
   [-EnableNotification <Boolean>]
   [-EnableTaskSequence <Boolean>]
   [-HighPerformance <Boolean>]
   -InputObject <IResultObject>
   [-MaxRunTimeMins <Int64>]
   [-NewName <String>]
   [-PassThru]
   [-ProgramName <String>]
   [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
   [-RunAnotherProgram <Boolean>]
   [-RunEveryTime <Boolean>]
   [-RunOnAnyPlatform]
   [-SuppressNotification <Boolean>]
   [-UseBootImage <Boolean>]
   [-UseDefaultText <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTaskSequence
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   [-BootImageId <String>]
   [-Category <String>]
   [-CustomText <String>]
   [-DeploymentPackageId <String>]
   [-Description <String>]
   [-DisableTaskSequence <Boolean>]
   [-EnableNotification <Boolean>]
   [-EnableTaskSequence <Boolean>]
   [-HighPerformance <Boolean>]
   [-MaxRunTimeMins <Int64>]
   [-NewName <String>]
   [-PassThru]
   [-ProgramName <String>]
   [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
   [-RunAnotherProgram <Boolean>]
   [-RunEveryTime <Boolean>]
   [-RunOnAnyPlatform]
   [-SuppressNotification <Boolean>]
   -TaskSequenceId <String>
   [-UseBootImage <Boolean>]
   [-UseDefaultText <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTaskSequence
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   [-BootImageId <String>]
   [-Category <String>]
   [-CustomText <String>]
   [-DeploymentPackageId <String>]
   [-Description <String>]
   [-DisableTaskSequence <Boolean>]
   [-EnableNotification <Boolean>]
   [-EnableTaskSequence <Boolean>]
   [-HighPerformance <Boolean>]
   [-MaxRunTimeMins <Int64>]
   [-NewName <String>]
   [-PassThru]
   [-ProgramName <String>]
   [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
   [-RunAnotherProgram <Boolean>]
   [-RunEveryTime <Boolean>]
   [-RunOnAnyPlatform]
   [-SuppressNotification <Boolean>]
   -TaskSequenceName <String>
   [-UseBootImage <Boolean>]
   [-UseDefaultText <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-CMTaskSequence ändert eine Configuration Manager-Tasksequenz.

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: Abrufen einer Tasksequenz und Ändern des Namens

PS XYZ:\> $TaskSequence = Get-CMTaskSequence -Name "TaskSequence01"
PS XYZ:\> Set-CMTaskSequence -InputObject $TaskSequence -NewName "NewTS01"

Der erste Befehl ruft das Tasksequenzobjekt mit dem Namen TaskSequence01 ab und speichert das Objekt in der variablen $TaskSequence.

Der zweite Befehl ändert den Namen der in $TaskSequence gespeicherten Tasksequenz in NewTS01.

Beispiel 2: Übergeben einer Tasksequenz und Ändern des Namens

PS XYZ:\> Get-CMTaskSequence -Name "TaskSequence02" | Set-CMTaskSequence -NewName "NewTS02"

Dieser Befehl ruft das Tasksequenzobjekt mit dem Namen TaskSequence02 ab und verwendet den Pipelineoperator, um das Objekt an Set-CMTaskSequence zu übergeben, wodurch der Name des Tasksequenzobjekts in NewTS02 geändert wird.

Parameter

-AddSupportedOperatingSystemPlatform

Fügt der Tasksequenz ein unterstütztes Betriebssystemplattformobjekt hinzu. Verwenden Sie das Cmdlet Get-CMSupportedPlatform , um ein unterstütztes Betriebssystemplattformobjekt abzurufen.

Typ:IResultObject[]
Aliase:AddSupportedOperatingSystemPlatforms
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-BootImageId

Gibt die ID eines Startimages an.

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

-Category

Gibt eine Kategorie für die Tasksequenz an. Sie können Kategorien verwenden, um Tasksequenzen zu gruppieren.

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

-CustomText

Gibt benutzerdefinierten Text für die Tasksequenz an. Benutzerdefinierter Text wird im Statusbenachrichtigungsdialogfeld angezeigt, während die Tasksequenz ausgeführt wird.

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

-DeploymentPackageId

Gibt die ID eines Pakets an. Wenn Sie den Wert $True für den RunAnotherProgram-Parameter angeben, wird das angegebene Paket ausgeführt, bevor die Tasksequenz ausgeführt wird.

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

-Description

Gibt eine Beschreibung für die Tasksequenz an.

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

-DisableTaskSequence

Gibt an, ob diese Tasksequenz deaktiviert werden soll.

Typ:Boolean
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

-EnableNotification

Gibt an, ob Benachrichtigungen für diese Tasksequenz aktiviert werden sollen.

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

-EnableTaskSequence

Gibt an, ob diese Tasksequenz aktiviert werden soll.

Typ:Boolean
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

-HighPerformance

Verwenden Sie diesen Parameter, um die folgende Option auf der Seite Leistung der Tasksequenzeigenschaften festzulegen: Als Hochleistungs-Energiesparplan ausführen.

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

-InputObject

Gibt ein Tasksequenzobjekt an. Verwenden Sie zum Abrufen eines Tasksequenzobjekts das Cmdlet Get-CMTaskSequence .

Typ:IResultObject
Aliase:TaskSequence
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-MaxRunTimeMins

Gibt die maximale Laufzeit für die Tasksequenz in Minuten an.

Typ:Int64
Aliase:Duration
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NewName

Gibt einen neuen Namen für die Tasksequenz an.

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

-PassThru

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

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

-ProgramName

Gibt den Namen eines Programms an, das aus einem Configuration Manager-Softwarepaket ausgeführt werden soll, das durch den DeploymentPackageId-Parameter angegeben wird.

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

-RemoveSupportedOperatingSystemPlatform

Entfernt ein unterstütztes Betriebssystemplattformobjekt aus der Tasksequenz. Verwenden Sie das Cmdlet Get-CMSupportedPlatform , um ein unterstütztes Betriebssystemplattformobjekt abzurufen.

Typ:IResultObject[]
Aliase:RemoveSupportedOperatingSystemPlatforms
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RunAnotherProgram

Gibt an, ob vor dem Ausführen der Tasksequenz ein anderes Programm ausgeführt werden soll. Geben Sie das Programm mithilfe des DeploymentPackageId-Parameters und des ProgramName-Parameters an.

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

-RunEveryTime

Gibt an, ob das im ProgramName-Parameter angegebene Programm jedes Mal ausgeführt wird, wenn die Tasksequenz ausgeführt wird. Wenn Sie den Wert $False angeben, wird das Programm nicht ausgeführt, wenn es in der Vergangenheit erfolgreich ausgeführt wurde.

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

-RunOnAnyPlatform

Gibt an, dass die Tasksequenz auf einer beliebigen Betriebssystemplattform ausgeführt wird.

Typ:SwitchParameter
Aliase:ClearSupportedOperatingSystemPlatforms
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SuppressNotification

Gibt an, ob Benachrichtigungen für diese Tasksequenz unterdrückt werden sollen.

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

-TaskSequenceId

Gibt die ID einer Tasksequenz an.

Typ:String
Aliase:Id, TaskSequencePackageId
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TaskSequenceName

Gibt den Namen einer Tasksequenz an.

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

-UseBootImage

Gibt an, ob die Tasksequenz das mit dem BootImageID-Parameter angegebene Startimage verwendet.

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

-UseDefaultText

Gibt an, ob standardtext im Statusbenachrichtigungsdialogfeld verwendet werden soll, während die Tasksequenz ausgeführt wird. Wenn Sie den Wert $False für diesen Parameter auswählen, stellen Sie sicher, dass Sie benutzerdefinierten Text mithilfe des CustomText-Parameters angeben.

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

System.Object