Adicione uma etapa ou grupo a uma sequência de tarefas.
\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":"Adicione uma etapa ou grupo a uma sequência de tarefas.
\n","uid":"ConfigurationManager.Add-CMTaskSequenceStep"}},"description":"Use este cmdlet para adicionar um grupo ou etapa a uma sequência de tarefas existente. Para obter mais informações sobre etapas de sequências de tarefas, consulte Etapas de sequência de tarefas.
\nAo adicionar programaticamente etapas a uma sequência de tarefas, é importante entender a ordem de índice das etapas. Para ajudar a visualizar o índice, este artigo usa a seguinte sequência de tarefas de exemplo:
\nQuando você usa o editor de sequência de tarefas para adicionar uma etapa, a nova etapa é adicionada após a etapa selecionada no momento. Este cmdlet funciona da mesma forma, adicionando a etapa após o índice especificado. Você usa o parâmetro InsertStepStartIndex para especificar o índice da etapa.
\nEste cmdlet só pode adicionar etapas ao nível principal da sequência de tarefas, não em grupos. Para adicionar etapas em grupos, use Set-CMTaskSequenceGroup. Por exemplo, com a sequência de tarefas de exemplo, se você usar Add-CMTaskSequenceStep com o valor 5do parâmetro InsertStepStartIndex , o cmdlet adicionará a nova etapa após o grupo5 e antes da etapa6.
Observação
\nExecute cmdlets do Configuration Manager na unidade do site do Configuration Manager, por exemploPS XYZ:\\>. Para obter mais informações, consulte introdução.
A sequência de tarefas resultante se parece com a seguinte lista:
\nAs etapas são ordenadas dessa forma devido à forma como são ordenadas no parâmetro Step .
\n","summary":"Neste exemplo, os dois primeiros comandos usam o cmdlet New-CMTaskSequenceStepRunPowerShellScript para criar objetos de etapa para a etapa Executar Script do Powershell . O terceiro comando cria uma nova sequência de tarefas personalizada chamada Executar scripts. O quarto comando passa o novo objeto de sequência de tarefas pelo pipeline para Add-CMTaskSequenceStep, que adiciona as duas etapas.
\n","title":"Exemplo 1: Criar uma sequência de tarefas personalizada que executa dois scripts do 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":"A sequência de tarefas resultante se parece com a seguinte lista:
\nDevido à forma como cada instância de Add-CMTaskSequenceStep é ordenada e nenhum deles usa o parâmetro InsertStepStartIndex , por padrão, eles usam índice 0. Portanto, o cmdlet adiciona a segunda etapa antes da primeira etapa.
Este exemplo é semelhante ao Exemplo 1, exceto que usa duas instâncias do cmdlet Add-CMTaskSequenceStep .
\n","title":"Exemplo 2: Criar uma sequência de tarefas personalizada que executa dois scripts do PowerShell com uma ordem diferente"},{"code":"$step = New-CMTSStepSetVariable -name \"newStep\" -TaskSequenceVariable \"testVar\" -TaskSequenceVariableValue \"testValue\"\nAdd-CMTaskSequenceStep -TaskSequenceName \"ts1\" -Step $step -InsertStepStartIndex 2","description":"","summary":"Este exemplo usa primeiro o cmdlet New-CMTSStepSetVariable para criar um objeto de etapa para a etapa Definir Variável de Sequência de Tarefas . Em seguida, ele adiciona essa etapa à sequência de tarefas chamada ts1 após a etapa no índice 2. Usando a sequência de tarefas de exemplo na Descrição, esse comando adiciona newStep entre as etapas 2 e 3.
\n","title":"Exemplo 3: Adicionar uma etapa em um í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":"Este exemplo copia uma sequência de tarefas existente e a renomeia. O próximo conjunto de etapas reconfigura o escopo de segurança. Em seguida, ele obtém a ID de um pacote e copia um objeto de condição de outra etapa. No último grupo, ele cria uma nova etapa Executar Linha de Comando que usa os objetos package e condition. Em seguida, adiciona a nova etapa à nova sequência de tarefas no índice 11.
\n","title":"Exemplo 4: Copiar uma sequência de tarefas e adicionar uma nova etapa"}],"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":"Sobre as etapas da sequência de tarefas"}],"module":"ConfigurationManager","name":"Add-CMTaskSequenceStep","notes":"Embora não esteja listado na seção de links relacionados, você pode usar os cmdlets Get-CMTSStep*, New-CMTSStep*, Remove-CMTSStep* e Set-CMTSStep* . Por exemplo:
\nHá um conjunto desses cmdlets para cada etapa da sequência de tarefas.
\n","outputs":[{"description":"","name":"System.Object\n"}],"parameters":[{"aliases":"cf","defaultValue":"None","description":"Solicita a confirmação antes de executar o cmdlet.
\n","name":"Confirm","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Esse parâmetro trata caracteres curinga como valores de caracteres literais. Você não pode combiná-lo com ForceWildcardHandling.
\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.
\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"TaskSequence","defaultValue":"None","description":"Especifique um objeto de sequência de tarefas ao qual o cmdlet adiciona a etapa. Para obter esse objeto, use os cmdlets Get-CMTaskSequence, Copy-CMTaskSequence ou New-CMTaskSequence .
\n","isRequired":true,"name":"InputObject","parameterValueGroup":"","pipelineInput":true,"position":"Named","type":"IResultObject\n"},{"aliases":"InsertStepsStartIndex","defaultValue":"None","description":"Especifique um valor inteiro para o índice da sequência de tarefas. O cmdlet adiciona a nova etapa após esse índice especificado. Por exemplo, usando a sequência de tarefas de exemplo na Descrição, se você especificar um valor de 4, o cmdlet adicionará a nova etapa após a etapa4.
Se você especificar um valor de 0, o cmdlet adicionará a nova etapa na parte superior da sequência de tarefas. Esse comportamento será o padrão se você não especificar esse parâmetro. Por exemplo, o cmdlet adiciona a nova etapa antes da etapa 1.
Não há valor máximo. Se você especificar um valor maior que o índice da última etapa, o cmdlet adicionará a nova etapa no final da sequência de tarefas. Por exemplo, se você especificar um valor de 10, o cmdlet adicionará a nova etapa após a etapa 6.
Especifique um ou mais objetos de etapa para adicionar à sequência de tarefas. Para obter esse objeto, use um dos cmdlets New-CMTSStep* . Por exemplo, Get-CMTSStepApplyDataImage.
\n","isRequired":true,"name":"Step","parameterValueGroup":"","position":"Named","type":"IResultObject[]
\n"},{"aliases":"Id, TaskSequencePackageId","defaultValue":"None","description":"Especifique a ID de uma sequência de tarefas à qual o cmdlet adiciona a etapa. Essa ID é a ID do pacote de sequência de tarefas, por exemplo XYZ00861.
Especifique o nome de uma sequência de tarefas à qual o cmdlet adiciona a etapa.
\n","isRequired":true,"name":"TaskSequenceName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"wi","defaultValue":"None","description":"Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
\n","name":"WhatIf","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"}],"schema":"PowershellCmdlet","summary":"Adicione uma etapa ou grupo a uma sequência de tarefas.
\n","syntaxes":["Add-CMTaskSequenceStep [-InsertStepStartIndexAdicione uma etapa ou grupo a uma sequência de tarefas.
\n","uid":"ConfigurationManager.Add-CMTaskSequenceStep"}],"canonical_url":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/add-cmtasksequencestep?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/add-cmtasksequencestep?view=sccm-ps"},"pageMetadata":"Use este cmdlet para adicionar um grupo ou etapa a uma sequência de tarefas existente. Para obter mais informações sobre etapas de sequências de tarefas, consulte Etapas de sequência de tarefas.\nAo adicionar programaticamente etapas a uma sequência de tarefas, é importante entender a ordem de índice das etapas. Para ajudar a visualizar o índice, este artigo usa a seguinte sequência de tarefas de exemplo:
\nQuando você usa o editor de sequência de tarefas para adicionar uma etapa, a nova etapa é adicionada após a etapa selecionada no momento. Este cmdlet funciona da mesma forma, adicionando a etapa após o índice especificado. Você usa o parâmetro InsertStepStartIndex para especificar o índice da etapa.
\nEste cmdlet só pode adicionar etapas ao nível principal da sequência de tarefas, não em grupos. Para adicionar etapas em grupos, use Set-CMTaskSequenceGroup. Por exemplo, com a sequência de tarefas de exemplo, se você usar Add-CMTaskSequenceStep com o valor 5do parâmetro InsertStepStartIndex , o cmdlet adicionará a nova etapa após o grupo5 e antes da etapa6.
Observação
\nExecute cmdlets do Configuration Manager na unidade do site do Configuration Manager, por exemploPS XYZ:\\>. Para obter mais informações, consulte introdução.
Há um conjunto desses cmdlets para cada etapa da sequência de tarefas.
\n\" />\r\n\r\nAdicione uma etapa ou grupo a uma sequência de tarefas.\n\" />\r\n] -Step