Agregue un paso o un grupo a una secuencia de tareas.
\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":"Agregue un paso o un grupo a una secuencia de tareas.
\n","uid":"ConfigurationManager.Add-CMTaskSequenceStep"}},"description":"Use este cmdlet para agregar un grupo o paso a una secuencia de tareas existente. Para obtener más información sobre los pasos de secuencias de tareas, consulte Pasos de secuencia de tareas.
\nAl agregar pasos a una secuencia de tareas mediante programación, es importante comprender el orden de índice de los pasos. Para ayudar a visualizar el índice, en este artículo se usa la siguiente secuencia de tareas de ejemplo:
\nCuando se usa el editor de secuencia de tareas para agregar un paso, el nuevo paso se agrega después del paso seleccionado actualmente. Este cmdlet funciona de forma similar, agrega el paso después del índice especificado. Use el parámetro InsertStepStartIndex para especificar el índice de paso.
\nEste cmdlet solo puede agregar pasos al nivel principal de la secuencia de tareas, no en grupos. Para agregar pasos en grupos, use Set-CMTaskSequenceGroup. Por ejemplo, con la secuencia de tareas de ejemplo, si usa Add-CMTaskSequenceStep con el valor 5del parámetro InsertStepStartIndex , el cmdlet agrega el nuevo paso después de group5 y antes del paso6.
Nota:
\nEjecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\\>. Para obtener más información, consulte Introducción.
La secuencia de tareas resultante es similar a la siguiente lista:
\nLos pasos se ordenan de esta manera debido a cómo se ordenan en el parámetro Step .
\n","summary":"En este ejemplo, los dos primeros comandos usan el cmdlet New-CMTaskSequenceStepRunPowerShellScript para crear objetos de paso para el paso Ejecutar script de PowerShell . El tercer comando crea una nueva secuencia de tareas personalizada denominada Ejecutar scripts. El cuarto comando pasa el nuevo objeto de secuencia de tareas a través de la canalización a Add-CMTaskSequenceStep, que agrega los dos pasos.
\n","title":"Ejemplo 1: Creación de una secuencia de tareas personalizada que ejecuta dos scripts de PowerShell"},{"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":"La secuencia de tareas resultante es similar a la siguiente lista:
\nDebido a cómo se ordena cada instancia de Add-CMTaskSequenceStep y no usa el parámetro InsertStepStartIndex , de forma predeterminada usan index 0. Por lo tanto, el cmdlet agrega el segundo paso antes del primer paso.
Este ejemplo es similar al ejemplo 1, excepto que usa dos instancias del cmdlet Add-CMTaskSequenceStep .
\n","title":"Ejemplo 2: Crear una secuencia de tareas personalizada que ejecute dos scripts de PowerShell con un orden diferente"},{"code":"$step = New-CMTSStepSetVariable -name \"newStep\" -TaskSequenceVariable \"testVar\" -TaskSequenceVariableValue \"testValue\"\nAdd-CMTaskSequenceStep -TaskSequenceName \"ts1\" -Step $step -InsertStepStartIndex 2","description":"","summary":"En este ejemplo se usa primero el cmdlet New-CMTSStepSetVariable para crear un objeto step para el paso Establecer variable de secuencia de tareas . A continuación, agrega este paso a la secuencia de tareas denominada ts1 después del paso en el índice 2. Con la secuencia de tareas de ejemplo en descripción, este comando agrega newStep entre step2 y step3.
\n","title":"Ejemplo 3: Agregar un paso a un índice específico"},{"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":"En este ejemplo se copia una secuencia de tareas existente y, a continuación, se le cambia el nombre. El siguiente conjunto de pasos vuelve a configurar el ámbito de seguridad. A continuación, obtiene el identificador de un paquete y copia un objeto de condición de otro paso. En el último grupo, crea un nuevo paso Ejecutar línea de comandos que usa los objetos package y condition. A continuación, agrega el nuevo paso a la nueva secuencia de tareas en el índice 11.
\n","title":"Ejemplo 4: Copiar una secuencia de tareas y agregar un nuevo paso"}],"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":"Acerca de los pasos de la secuencia de tareas"}],"module":"ConfigurationManager","name":"Add-CMTaskSequenceStep","notes":"Aunque no aparece en la sección de vínculos relacionados, puede usar los cmdlets Get-CMTSStep*, New-CMTSStep*, Remove-CMTSStep* y Set-CMTSStep* . Por ejemplo:
\nHay un conjunto de estos cmdlets para cada paso de secuencia de tareas.
\n","outputs":[{"description":"","name":"System.Object\n"}],"parameters":[{"aliases":"cf","defaultValue":"None","description":"Solicitará confirmación antes de ejecutar el cmdlet.
\n","name":"Confirm","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.
\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.
\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"TaskSequence","defaultValue":"None","description":"Especifique un objeto de secuencia de tareas al que el cmdlet agrega el paso. Para obtener este objeto, use los cmdlets Get-CMTaskSequence, Copy-CMTaskSequence o New-CMTaskSequence .
\n","isRequired":true,"name":"InputObject","parameterValueGroup":"","pipelineInput":true,"position":"Named","type":"IResultObject\n"},{"aliases":"InsertStepsStartIndex","defaultValue":"None","description":"Especifique un valor entero para el índice de secuencia de tareas. El cmdlet agrega el nuevo paso después de este índice especificado. Por ejemplo, con la secuencia de tareas de ejemplo en descripción, si especifica un valor de 4, el cmdlet agrega el nuevo paso después del paso4.
Si especifica un valor de 0, el cmdlet agrega el nuevo paso en la parte superior de la secuencia de tareas. Este comportamiento es el predeterminado si no especifica este parámetro. Por ejemplo, el cmdlet agrega el nuevo paso antes delpaso 1.
No hay ningún valor máximo. Si especifica un valor mayor que el índice del último paso, el cmdlet agrega el nuevo paso al final de la secuencia de tareas. Por ejemplo, si especifica un valor de 10, el cmdlet agrega el nuevo paso después del paso6.
Especifique uno o varios objetos de paso que se van a agregar a la secuencia de tareas. Para obtener este objeto, use uno de los cmdlets New-CMTSStep* . Por ejemplo, Get-CMTSStepApplyDataImage.
\n","isRequired":true,"name":"Step","parameterValueGroup":"","position":"Named","type":"IResultObject[]
\n"},{"aliases":"Id, TaskSequencePackageId","defaultValue":"None","description":"Especifique el identificador de una secuencia de tareas a la que el cmdlet agrega el paso. Este identificador es el identificador del paquete de secuencia de tareas, por ejemplo XYZ00861.
Especifique el nombre de una secuencia de tareas a la que el cmdlet agrega el paso.
\n","isRequired":true,"name":"TaskSequenceName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"wi","defaultValue":"None","description":"Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.
\n","name":"WhatIf","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"}],"schema":"PowershellCmdlet","summary":"Agregue un paso o un grupo a una secuencia de tareas.
\n","syntaxes":["Add-CMTaskSequenceStep [-InsertStepStartIndexAgregue un paso o un grupo a una secuencia de tareas.
\n","uid":"ConfigurationManager.Add-CMTaskSequenceStep"}],"canonical_url":"https://learn.microsoft.com/es-es/powershell/module/configurationmanager/add-cmtasksequencestep?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/es-es/powershell/module/configurationmanager/add-cmtasksequencestep?view=sccm-ps"},"pageMetadata":"Use este cmdlet para agregar un grupo o paso a una secuencia de tareas existente. Para obtener más información sobre los pasos de secuencias de tareas, consulte Pasos de secuencia de tareas.\nAl agregar pasos a una secuencia de tareas mediante programación, es importante comprender el orden de índice de los pasos. Para ayudar a visualizar el índice, en este artículo se usa la siguiente secuencia de tareas de ejemplo:
\nCuando se usa el editor de secuencia de tareas para agregar un paso, el nuevo paso se agrega después del paso seleccionado actualmente. Este cmdlet funciona de forma similar, agrega el paso después del índice especificado. Use el parámetro InsertStepStartIndex para especificar el índice de paso.
\nEste cmdlet solo puede agregar pasos al nivel principal de la secuencia de tareas, no en grupos. Para agregar pasos en grupos, use Set-CMTaskSequenceGroup. Por ejemplo, con la secuencia de tareas de ejemplo, si usa Add-CMTaskSequenceStep con el valor 5del parámetro InsertStepStartIndex , el cmdlet agrega el nuevo paso después de group5 y antes del paso6.
Nota:
\nEjecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\\>. Para obtener más información, consulte Introducción.
Hay un conjunto de estos cmdlets para cada paso de secuencia de tareas.
\n\" />\r\n\r\nAgregue un paso o un grupo a una secuencia de tareas.\n\" />\r\n] -Step