Fügen Sie einer Tasksequenz einen Schritt oder eine Gruppe hinzu.
\n","uid":"ConfigurationManager.Add-CMTaskSequenceStep"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.Add-CMTaskSequenceStep":{"href":"add-cmtasksequencestep","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"Add-CMTaskSequenceStep","schemaType":"PowershellCmdlet","summary":"Fügen Sie einer Tasksequenz einen Schritt oder eine Gruppe hinzu.
\n","uid":"ConfigurationManager.Add-CMTaskSequenceStep"}},"description":"Verwenden Sie dieses Cmdlet, um einer vorhandenen Tasksequenz eine Gruppe oder einen Schritt hinzuzufügen. Weitere Informationen zu Tasksequenzschritten finden Sie unter Tasksequenzschritte.
\nBeim programmgesteuerten Hinzufügen von Schritten zu einer Tasksequenz ist es wichtig, die Indexreihenfolge der Schritte zu verstehen. In diesem Artikel wird die folgende Beispieltasksequenz verwendet, um den Index zu visualisieren:
\nWenn Sie den Tasksequenz-Editor verwenden, um einen Schritt hinzuzufügen, wird der neue Schritt nach dem aktuell ausgewählten Schritt hinzugefügt. Dieses Cmdlet funktioniert ähnlich, es fügt den Schritt nach dem angegebenen Index hinzu. Sie verwenden den InsertStepStartIndex-Parameter , um den Schrittindex anzugeben.
\nDieses Cmdlet kann nur Schritte zur Hauptebene der Tasksequenz hinzufügen, nicht in Gruppen. Um Schritte in Gruppen hinzuzufügen, verwenden Sie Set-CMTaskSequenceGroup. Wenn Sie beispielsweise bei der Beispieltasksequenz Add-CMTaskSequenceStep mit dem InsertStepStartIndex-Parameterwert5verwenden, fügt das Cmdlet den neuen Schritt nach group5 und vor step6 hinzu.
Hinweis
\nFühren Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\\>. . Weitere Informationen finden Sie unter Erste Schritte.
Die resultierende Tasksequenz sieht wie die folgende Liste aus:
\nDie Schritte werden aufgrund der Reihenfolge im Step-Parameter auf diese Weise sortiert.
\n","summary":"In diesem Beispiel verwenden die ersten beiden Befehle das Cmdlet New-CMTaskSequenceStepRunPowerShellScript , um Schrittobjekte für den Schritt PowerShell-Skript ausführen zu erstellen. Der dritte Befehl erstellt eine neue benutzerdefinierte Tasksequenz namens Skripts ausführen. Der vierte Befehl übergibt das neue Tasksequenzobjekt durch die Pipeline an Add-CMTaskSequenceStep, wodurch die beiden Schritte hinzugefügt werden.
\n","title":"Beispiel 1: Erstellen einer benutzerdefinierten Tasksequenz, die zwei PowerShell-Skripts ausführt"},{"code":"$step1 = New-CMTaskSequenceStepRunPowerShellScript -Name \"Run script 1\" -PackageID $PackageId -ScriptName \"script1.ps1\" -ExecutionPolicy Bypass\n$step2 = New-CMTaskSequenceStepRunPowerShellScript -Name \"Run script 2\" -PackageID $PackageId -ScriptName \"script2.ps1\" -ExecutionPolicy Bypass\n$ts = New-CMTaskSequence -Name \"Run scripts\" -CustomTaskSequence\n$ts | Add-CMTaskSequenceStep -Step $step1\n$ts | Add-CMTaskSequenceStep -Step $step2","description":"Die resultierende Tasksequenz sieht wie die folgende Liste aus:
\nAufgrund der Reihenfolge der einzelnen Instanzen von Add-CMTaskSequenceStep und der InsertStepStartIndex-Parameter wird standardmäßig index 0verwendet. Daher fügt das Cmdlet den zweiten Schritt vor dem ersten Schritt hinzu.
Dieses Beispiel ähnelt Beispiel 1, mit der Ausnahme, dass zwei Instanzen des Cmdlets Add-CMTaskSequenceStep verwendet werden.
\n","title":"Beispiel 2: Erstellen einer benutzerdefinierten Tasksequenz, die zwei PowerShell-Skripts in einer anderen Reihenfolge ausführt"},{"code":"$step = New-CMTSStepSetVariable -name \"newStep\" -TaskSequenceVariable \"testVar\" -TaskSequenceVariableValue \"testValue\"\nAdd-CMTaskSequenceStep -TaskSequenceName \"ts1\" -Step $step -InsertStepStartIndex 2","description":"","summary":"In diesem Beispiel wird zunächst das Cmdlet New-CMTSStepSetVariable verwendet, um ein Schrittobjekt für den Schritt Tasksequenzvariable festlegen zu erstellen. Anschließend wird dieser Schritt der Tasksequenz mit dem Namen ts1 nach dem Schritt am Index 2 hinzugefügt. Mithilfe der Beispieltasksequenz in der Beschreibung fügt dieser Befehl newStep zwischen Schritt 2 und Schritt3 hinzu.
\n","title":"Beispiel 3: Hinzufügen eines Schritts an einem bestimmten Index"},{"code":"$ts = Copy-CMTaskSequence -Name \"Deploy Windows 10 (v1)\"\n$ts | Set-CMTaskSequence -NewName \"Deploy Windows 10 (v2)\"\n\n$ts | Add-CMObjectSecurityScope -Name \"Contoso main\" | Out-Null\n$ts | Remove-CMObjectSecurityScope -Name \"Default\" -Force |Out-Null\n\n$pkgId = (Get-CMPackage -Name \"Widget tool\" -Fast).PackageID\n$condition = ($ts | Get-CMTaskSequenceStep -StepName \"Restart in Windows PE\").Condition.Operands\n\n$step = New-CMTaskSequenceStepRunCommandLine -CommandLine \"widget.exe /q\" -PackageId $pkgId -Name \"Install Widget in Windows PE\" -Condition $condition\n$ts | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11","description":"","summary":"In diesem Beispiel wird eine vorhandene Tasksequenz kopiert und anschließend umbenannt. Mit den nächsten Schritten wird der Sicherheitsbereich neu konfiguriert. Anschließend wird die ID für ein Paket abgerufen und ein Bedingungsobjekt aus einem anderen Schritt kopiert. In der letzten Gruppe wird ein neuer Schritt Befehlszeile ausführen erstellt, der das Paket und die Bedingungsobjekte verwendet. Anschließend wird der neuen Tasksequenz am Index 11 der neue Schritt hinzugefügt.
\n","title":"Beispiel 4: Kopieren einer Tasksequenz und Hinzufügen eines neuen Schritts"}],"inputs":[{"description":"","name":"Microsoft.ConfigurationManagement.ManagementProvider.IResultObject\n"}],"links":[{"href":"get-cmtasksequencestep","text":"Get-CMTaskSequenceStep"},{"href":"get-cmtasksequencestepcondition","text":"Get-CMTaskSequenceStepCondition"},{"href":"remove-cmtasksequencestep","text":"Remove-CMTaskSequenceStep"},{"href":"get-cmtasksequencegroup","text":"Get-CMTaskSequenceGroup"},{"href":"new-cmtasksequencegroup","text":"New-CMTaskSequenceGroup"},{"href":"set-cmtasksequencegroup","text":"Set-CMTaskSequenceGroup"},{"href":"/mem/configmgr/osd/understand/task-sequence-steps","text":"Info zu Aufgabensequenzschritten"}],"module":"ConfigurationManager","name":"Add-CMTaskSequenceStep","notes":"Sie können die Cmdlets Get-CMTSStep*, New-CMTSStep*, Remove-CMTSStep* und Set-CMTSStep* verwenden, auch wenn sie nicht im Abschnitt zu verwandten Links aufgeführt sind. Zum Beispiel:
\nFür jeden Tasksequenzschritt gibt es eine Reihe dieser Cmdlets.
\n","outputs":[{"description":"","name":"System.Object\n"}],"parameters":[{"aliases":"cf","defaultValue":"None","description":"Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
\n","name":"Confirm","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.
\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.
\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"TaskSequence","defaultValue":"None","description":"Geben Sie ein Tasksequenzobjekt an, dem das Cmdlet den Schritt hinzufügt. Verwenden Sie zum Abrufen dieses Objekts die Cmdlets Get-CMTaskSequence, Copy-CMTaskSequence oder New-CMTaskSequence .
\n","isRequired":true,"name":"InputObject","parameterValueGroup":"","pipelineInput":true,"position":"Named","type":"IResultObject\n"},{"aliases":"InsertStepsStartIndex","defaultValue":"None","description":"Geben Sie einen ganzzahligen Wert für den Tasksequenzindex an. Das Cmdlet fügt den neuen Schritt nach diesem angegebenen Index hinzu. Wenn Sie beispielsweise die Beispieltasksequenz in der Beschreibung verwenden und den Wert 4angeben, fügt das Cmdlet den neuen Schritt nach Schritt 4 hinzu.
Wenn Sie den Wert 0angeben, fügt das Cmdlet den neuen Schritt oben in der Tasksequenz hinzu. Dieses Verhalten ist die Standardeinstellung, wenn Sie diesen Parameter nicht angeben. Das Cmdlet fügt z. B. den neuen Schritt vorSchritt 1 hinzu.
Es gibt keinen Maximalwert. Wenn Sie einen Wert angeben, der größer als der Index des letzten Schritts ist, fügt das Cmdlet den neuen Schritt am Ende der Tasksequenz hinzu. Wenn Sie beispielsweise den Wert 10angeben, fügt das Cmdlet den neuen Schritt nach Schritt6 hinzu.
Geben Sie mindestens ein Schrittobjekt an, das der Tasksequenz hinzugefügt werden soll. Verwenden Sie zum Abrufen dieses Objekts eines der Cmdlets New-CMTSStep* . Beispiel: Get-CMTSStepApplyDataImage.
\n","isRequired":true,"name":"Step","parameterValueGroup":"","position":"Named","type":"IResultObject[]
\n"},{"aliases":"Id, TaskSequencePackageId","defaultValue":"None","description":"Geben Sie die ID einer Tasksequenz an, der das Cmdlet den Schritt hinzufügt. Diese ID ist die Tasksequenzpaket-ID, z. B XYZ00861. .
Geben Sie den Namen einer Tasksequenz an, der das Cmdlet den Schritt hinzufügt.
\n","isRequired":true,"name":"TaskSequenceName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"wi","defaultValue":"None","description":"Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
\n","name":"WhatIf","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"}],"schema":"PowershellCmdlet","summary":"Fügen Sie einer Tasksequenz einen Schritt oder eine Gruppe hinzu.
\n","syntaxes":["Add-CMTaskSequenceStep [-InsertStepStartIndexFügen Sie einer Tasksequenz einen Schritt oder eine Gruppe hinzu.
\n","uid":"ConfigurationManager.Add-CMTaskSequenceStep"}],"canonical_url":"https://learn.microsoft.com/de-de/powershell/module/configurationmanager/add-cmtasksequencestep?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/de-de/powershell/module/configurationmanager/add-cmtasksequencestep?view=sccm-ps"},"pageMetadata":"Verwenden Sie dieses Cmdlet, um einer vorhandenen Tasksequenz eine Gruppe oder einen Schritt hinzuzufügen. Weitere Informationen zu Tasksequenzschritten finden Sie unter Tasksequenzschritte.\nBeim programmgesteuerten Hinzufügen von Schritten zu einer Tasksequenz ist es wichtig, die Indexreihenfolge der Schritte zu verstehen. In diesem Artikel wird die folgende Beispieltasksequenz verwendet, um den Index zu visualisieren:
\nWenn Sie den Tasksequenz-Editor verwenden, um einen Schritt hinzuzufügen, wird der neue Schritt nach dem aktuell ausgewählten Schritt hinzugefügt. Dieses Cmdlet funktioniert ähnlich, es fügt den Schritt nach dem angegebenen Index hinzu. Sie verwenden den InsertStepStartIndex-Parameter , um den Schrittindex anzugeben.
\nDieses Cmdlet kann nur Schritte zur Hauptebene der Tasksequenz hinzufügen, nicht in Gruppen. Um Schritte in Gruppen hinzuzufügen, verwenden Sie Set-CMTaskSequenceGroup. Wenn Sie beispielsweise bei der Beispieltasksequenz Add-CMTaskSequenceStep mit dem InsertStepStartIndex-Parameterwert5verwenden, fügt das Cmdlet den neuen Schritt nach group5 und vor step6 hinzu.
Hinweis
\nFühren Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\\>. . Weitere Informationen finden Sie unter Erste Schritte.
Für jeden Tasksequenzschritt gibt es eine Reihe dieser Cmdlets.
\n\" />\r\n\r\nFügen Sie einer Tasksequenz einen Schritt oder eine Gruppe hinzu.\n\" />\r\n] -Step