Adicione um passo 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 um passo ou grupo a uma sequência de tarefas.
\n","uid":"ConfigurationManager.Add-CMTaskSequenceStep"}},"description":"Utilize este cmdlet para adicionar um grupo ou passo a uma sequência de tarefas existente. Para obter mais informações sobre os passos de sequências de tarefas, veja Passos de sequência de tarefas.
\nAo adicionar programaticamente passos a uma sequência de tarefas, é importante compreender a ordem de índice dos passos. Para ajudar a visualizar o índice, este artigo utiliza a seguinte sequência de tarefas de exemplo:
\nQuando utiliza o editor de sequência de tarefas para adicionar um passo, o novo passo é adicionado após o passo atualmente selecionado. Este cmdlet funciona da mesma forma, adiciona o passo após o índice especificado. Utilize o parâmetro InsertStepStartIndex para especificar o índice de passos.
\nEste cmdlet só pode adicionar passos ao nível principal da sequência de tarefas, não em grupos. Para adicionar passos em grupos, utilize Set-CMTaskSequenceGroup. Por exemplo, com a sequência de tarefas de exemplo, se utilizar Add-CMTaskSequenceStep com o valor 5do parâmetro InsertStepStartIndex, o cmdlet adiciona o novo passo após o grupo5 e antes do passo6.
Observação
\nExecute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\\>. Para obter mais informações, veja Introdução.
A sequência de tarefas resultante assemelha-se à seguinte lista:
\nOs passos são ordenados desta forma devido à forma como são ordenados no parâmetro Passo .
\n","summary":"Neste exemplo, os dois primeiros comandos utilizam o cmdlet New-CMTaskSequenceStepRunPowerShellScript para criar objetos de passo para o passo Executar Script do PowerShell . O terceiro comando cria uma nova sequência de tarefas personalizada denominada Executar scripts. O quarto comando transmite o novo objeto de sequência de tarefas através do pipeline para Add-CMTaskSequenceStep, que adiciona os dois passos.
\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 assemelha-se à seguinte lista:
\nDevido à forma como cada instância de Add-CMTaskSequenceStep é ordenada e não utiliza o parâmetro InsertStepStartIndex , por predefinição, utilizam o índice 0. Assim, o cmdlet adiciona o segundo passo antes do primeiro passo.
Este exemplo é semelhante ao Exemplo 1, exceto que utiliza 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 utiliza primeiro o cmdlet New-CMTSStepSetVariable para criar um objeto de passo para o passo Definir Variável de Sequência de Tarefas . Em seguida, adiciona este passo à sequência de tarefas com o nome ts1 após o passo no índice 2. Com a sequência de tarefas de exemplo na Descrição, este comando adiciona newStep entre o passo2 e o passo3.
\n","title":"Exemplo 3: adicionar um passo a 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, em seguida, muda o nome da mesma. O próximo conjunto de passos reconfigura o âmbito de segurança. Em seguida, obtém o ID de um pacote e copia um objeto de condição de outro passo. No último grupo, cria um novo passo Executar Linha de Comandos que utiliza o pacote e os objetos de condição. Em seguida, adiciona o novo passo à nova sequência de tarefas no índice 11.
\n","title":"Exemplo 4: Copiar uma sequência de tarefas e adicionar um novo passo"}],"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 secção de ligações relacionadas, pode utilizar os cmdlets Get-CMTSStep*, New-CMTSStep*, Remove-CMTSStep*e Set-CMTSStep* . Por exemplo:
\nExiste um conjunto destes cmdlets para cada passo de 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":"Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.
\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). 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 o passo. Para obter este objeto, utilize 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 de sequência de tarefas. O cmdlet adiciona o novo passo após este índice especificado. Por exemplo, ao utilizar a sequência de tarefas de exemplo na Descrição, se especificar um valor de 4, o cmdlet adiciona o novo passo após o passo4.
Se especificar um valor de 0, o cmdlet adiciona o novo passo na parte superior da sequência de tarefas. Este comportamento é a predefinição se não especificar este parâmetro. Por exemplo, o cmdlet adiciona o novo passo antesdo passo 1.
Não existe nenhum valor máximo. Se especificar um valor superior ao índice do último passo, o cmdlet adiciona o novo passo no final da sequência de tarefas. Por exemplo, se especificar um valor de 10, o cmdlet adiciona o novo passo após o passo6.
Especifique um ou mais objetos de passo a adicionar à sequência de tarefas. Para obter este objeto, utilize 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 o ID de uma sequência de tarefas à qual o cmdlet adiciona o passo. Este ID é o ID do pacote de sequência de tarefas, por exemplo XYZ00861.
Especifique o nome de uma sequência de tarefas à qual o cmdlet adiciona o passo.
\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 um passo ou grupo a uma sequência de tarefas.
\n","syntaxes":["Add-CMTaskSequenceStep [-InsertStepStartIndexAdicione um passo 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":"Utilize este cmdlet para adicionar um grupo ou passo a uma sequência de tarefas existente. Para obter mais informações sobre os passos de sequências de tarefas, veja Passos de sequência de tarefas.\nAo adicionar programaticamente passos a uma sequência de tarefas, é importante compreender a ordem de índice dos passos. Para ajudar a visualizar o índice, este artigo utiliza a seguinte sequência de tarefas de exemplo:
\nQuando utiliza o editor de sequência de tarefas para adicionar um passo, o novo passo é adicionado após o passo atualmente selecionado. Este cmdlet funciona da mesma forma, adiciona o passo após o índice especificado. Utilize o parâmetro InsertStepStartIndex para especificar o índice de passos.
\nEste cmdlet só pode adicionar passos ao nível principal da sequência de tarefas, não em grupos. Para adicionar passos em grupos, utilize Set-CMTaskSequenceGroup. Por exemplo, com a sequência de tarefas de exemplo, se utilizar Add-CMTaskSequenceStep com o valor 5do parâmetro InsertStepStartIndex, o cmdlet adiciona o novo passo após o grupo5 e antes do passo6.
Observação
\nExecute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\\>. Para obter mais informações, veja Introdução.
Existe um conjunto destes cmdlets para cada passo de sequência de tarefas.
\n\" />\r\n\r\nAdicione um passo ou grupo a uma sequência de tarefas.\n\" />\r\n] -Step