Set-CMTaskSequence
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-Websitelaufwerk aus, z. PS XYZ:\>B. . 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.
| Type: | IResultObject[] |
| Aliases: | AddSupportedOperatingSystemPlatforms |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BootImageId
Gibt die ID eines Startimages an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Category
Gibt eine Kategorie für die Tasksequenz an. Sie können Kategorien verwenden, um Tasksequenzen zu gruppieren.
| 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 |
-CustomText
Gibt benutzerdefinierten Text für die Tasksequenz an. Benutzerdefinierter Text wird im Statusbenachrichtigungsdialogfeld angezeigt, während die Tasksequenz ausgeführt wird.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Gibt eine Beschreibung für die Tasksequenz an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableTaskSequence
Gibt an, ob diese Tasksequenz deaktiviert werden soll.
| Type: | Boolean |
| 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 |
-EnableNotification
Gibt an, ob Benachrichtigungen für diese Tasksequenz aktiviert werden sollen.
| Type: | Boolean |
| Aliases: | EnableNotifications |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableTaskSequence
Gibt an, ob diese Tasksequenz aktiviert werden soll.
| Type: | Boolean |
| 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 |
-HighPerformance
Verwenden Sie diesen Parameter, um die folgende Option auf der Seite Leistung der Tasksequenzeigenschaften festzulegen: Als Hochleistungs-Energiesparplan ausführen.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Gibt ein Tasksequenzobjekt an. Verwenden Sie zum Abrufen eines Tasksequenzobjekts das Cmdlet Get-CMTaskSequence .
| Type: | IResultObject |
| Aliases: | TaskSequence |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-MaxRunTimeMins
Gibt die maximale Laufzeit für die Tasksequenz in Minuten an.
| Type: | Int64 |
| Aliases: | Duration |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NewName
Gibt einen neuen Namen für die Tasksequenz an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
Gibt das aktuelle Arbeitsobjekt zurück. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ProgramName
Gibt den Namen eines Programms an, das von einem Configuration Manager Softwarepaket ausgeführt werden soll, das durch den DeploymentPackageId-Parameter angegeben wird.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveSupportedOperatingSystemPlatform
Entfernt ein unterstütztes Betriebssystemplattformobjekt aus der Tasksequenz. Verwenden Sie das Cmdlet Get-CMSupportedPlatform , um ein unterstütztes Betriebssystemplattformobjekt abzurufen.
| Type: | IResultObject[] |
| Aliases: | RemoveSupportedOperatingSystemPlatforms |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAnotherProgram
Gibt an, ob vor dem Ausführen der Tasksequenz ein anderes Programm ausgeführt werden soll. Geben Sie das Programm mit dem DeploymentPackageId-Parameter und dem ProgramName-Parameter an.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunOnAnyPlatform
Gibt an, dass die Tasksequenz auf einer beliebigen Betriebssystemplattform ausgeführt wird.
| Type: | SwitchParameter |
| Aliases: | ClearSupportedOperatingSystemPlatforms |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SuppressNotification
Gibt an, ob Benachrichtigungen für diese Tasksequenz unterdrückt werden sollen.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TaskSequenceId
Gibt die ID einer Tasksequenz an.
| Type: | String |
| Aliases: | Id, TaskSequencePackageId |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TaskSequenceName
Gibt den Namen einer Tasksequenz an.
| Type: | String |
| Aliases: | Name |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseBootImage
Gibt an, ob die Tasksequenz das mit dem BootImageID-Parameter angegebene Startimage verwendet.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| 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
System.Object
Ähnliche Themen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für