Aggiungere un passaggio o un gruppo a una sequenza di attività.
\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":"Aggiungere un passaggio o un gruppo a una sequenza di attività.
\n","uid":"ConfigurationManager.Add-CMTaskSequenceStep"}},"description":"Usare questo cmdlet per aggiungere un gruppo o un passaggio a una sequenza di attività esistente. Per altre informazioni sui passaggi delle sequenze di attività, vedere Passaggi della sequenza di attività.
\nQuando si aggiungono passaggi a una sequenza di attività a livello di codice, è importante comprendere l'ordine di indice dei passaggi. Per visualizzare l'indice, questo articolo usa la sequenza di attività di esempio seguente:
\nQuando si usa l'editor della sequenza di attività per aggiungere un passaggio, il nuovo passaggio viene aggiunto dopo il passaggio attualmente selezionato. Questo cmdlet funziona in modo analogo e aggiunge il passaggio dopo l'indice specificato. Usare il parametro InsertStepStartIndex per specificare l'indice del passaggio.
\nQuesto cmdlet può aggiungere solo passaggi al livello principale della sequenza di attività, non in gruppi. Per aggiungere passaggi in gruppi, usare Set-CMTaskSequenceGroup. Ad esempio, con la sequenza di attività di esempio, se si usa Add-CMTaskSequenceStep con il valore 5del parametro InsertStepStartIndex , il cmdlet aggiunge il nuovo passaggio dopo group5 e prima del passaggio 6.
Nota
\nEseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\\>. Per altre informazioni, vedere Introduzione.
La sequenza di attività risultante è simile all'elenco seguente:
\nI passaggi vengono ordinati in questo modo a causa del modo in cui vengono ordinati nel parametro Step .
\n","summary":"In questo esempio i primi due comandi usano il cmdlet New-CMTaskSequenceStepRunPowerShellScript per creare oggetti passaggio per il passaggio Esegui script powershell . Il terzo comando crea una nuova sequenza di attività personalizzata denominata Esegui script. Il quarto comando passa il nuovo oggetto sequenza di attività attraverso la pipeline a Add-CMTaskSequenceStep, che aggiunge i due passaggi.
\n","title":"Esempio 1: Creare una sequenza di attività personalizzata che esegue due script di 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 sequenza di attività risultante è simile all'elenco seguente:
\nA causa del modo in cui ogni istanza di Add-CMTaskSequenceStep viene ordinata e non usa il parametro InsertStepStartIndex , per impostazione predefinita usa l'indice 0. Il cmdlet aggiunge quindi il secondo passaggio prima del primo passaggio.
Questo esempio è simile all'esempio 1, ma usa due istanze del cmdlet Add-CMTaskSequenceStep .
\n","title":"Esempio 2: Creare una sequenza di attività personalizzata che esegue due script di PowerShell con un ordine diverso"},{"code":"$step = New-CMTSStepSetVariable -name \"newStep\" -TaskSequenceVariable \"testVar\" -TaskSequenceVariableValue \"testValue\"\nAdd-CMTaskSequenceStep -TaskSequenceName \"ts1\" -Step $step -InsertStepStartIndex 2","description":"","summary":"In questo esempio viene innanzitutto usato il cmdlet New-CMTSStepSetVariable per creare un oggetto passaggio per il passaggio Imposta variabile della sequenza di attività . Aggiunge quindi questo passaggio alla sequenza di attività denominata ts1 dopo il passaggio in corrispondenza dell'indice 2. Usando la sequenza di attività di esempio nella descrizione, questo comando aggiunge newStep tra il passaggio 2 e il passaggio 3.
\n","title":"Esempio 3: Aggiungere un passaggio in corrispondenza di un indice specifico"},{"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 questo esempio viene copiata una sequenza di attività esistente e quindi viene rinominata. Il set di passaggi successivo riconfigura l'ambito di sicurezza. Ottiene quindi l'ID per un pacchetto e copia un oggetto condizione da un altro passaggio. Nell'ultimo gruppo viene creato un nuovo passaggio Esegui riga di comando che usa gli oggetti pacchetto e condizione. Aggiunge quindi il nuovo passaggio alla nuova sequenza di attività in corrispondenza dell'indice 11.
\n","title":"Esempio 4: Copiare una sequenza di attività e aggiungere un nuovo passaggio"}],"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":"Informazioni sui passaggi della sequenza di attività"}],"module":"ConfigurationManager","name":"Add-CMTaskSequenceStep","notes":"Sebbene non sia elencato nella sezione relativa ai collegamenti, è possibile usare i cmdlet Get-CMTSStep*, New-CMTSStep*, Remove-CMTSStep*e Set-CMTSStep* . Ad esempio:
\nÈ disponibile un set di questi cmdlet per ogni passaggio della sequenza di attività.
\n","outputs":[{"description":"","name":"System.Object\n"}],"parameters":[{"aliases":"cf","defaultValue":"None","description":"Richiede la conferma prima di eseguire il cmdlet.
\n","name":"Confirm","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.
\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.
\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"TaskSequence","defaultValue":"None","description":"Specificare un oggetto sequenza di attività a cui il cmdlet aggiunge il passaggio. Per ottenere questo oggetto, usare i cmdlet 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":"Specificare un valore intero per l'indice della sequenza di attività. Il cmdlet aggiunge il nuovo passaggio dopo questo indice specificato. Ad esempio, usando la sequenza di attività di esempio nella descrizione, se si specifica un valore di 4, il cmdlet aggiunge il nuovo passaggio dopo il passaggio 4.
Se si specifica un valore di 0, il cmdlet aggiunge il nuovo passaggio nella parte superiore della sequenza di attività. Questo comportamento è l'impostazione predefinita se non si specifica questo parametro. Ad esempio, il cmdlet aggiunge il nuovo passaggio prima del passaggio 1.
Non è presente alcun valore massimo. Se si specifica un valore maggiore dell'indice dell'ultimo passaggio, il cmdlet aggiunge il nuovo passaggio alla fine della sequenza di attività. Ad esempio, se si specifica un valore di 10, il cmdlet aggiunge il nuovo passaggio dopo il passaggio 6.
Specificare uno o più oggetti passaggio da aggiungere alla sequenza di attività. Per ottenere questo oggetto, usare uno dei cmdlet New-CMTSStep* . Ad esempio, Get-CMTSStepApplyDataImage.
\n","isRequired":true,"name":"Step","parameterValueGroup":"","position":"Named","type":"IResultObject[]
\n"},{"aliases":"Id, TaskSequencePackageId","defaultValue":"None","description":"Specificare l'ID di una sequenza di attività a cui il cmdlet aggiunge il passaggio. Questo ID è l'ID del pacchetto della sequenza di attività, ad esempio XYZ00861.
Specificare il nome di una sequenza di attività a cui il cmdlet aggiunge il passaggio.
\n","isRequired":true,"name":"TaskSequenceName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"wi","defaultValue":"None","description":"Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.
\n","name":"WhatIf","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"}],"schema":"PowershellCmdlet","summary":"Aggiungere un passaggio o un gruppo a una sequenza di attività.
\n","syntaxes":["Add-CMTaskSequenceStep [-InsertStepStartIndexAggiungere un passaggio o un gruppo a una sequenza di attività.
\n","uid":"ConfigurationManager.Add-CMTaskSequenceStep"}],"canonical_url":"https://learn.microsoft.com/it-it/powershell/module/configurationmanager/add-cmtasksequencestep?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/it-it/powershell/module/configurationmanager/add-cmtasksequencestep?view=sccm-ps"},"pageMetadata":"Usare questo cmdlet per aggiungere un gruppo o un passaggio a una sequenza di attività esistente. Per altre informazioni sui passaggi delle sequenze di attività, vedere Passaggi della sequenza di attività.\nQuando si aggiungono passaggi a una sequenza di attività a livello di codice, è importante comprendere l'ordine di indice dei passaggi. Per visualizzare l'indice, questo articolo usa la sequenza di attività di esempio seguente:
\nQuando si usa l'editor della sequenza di attività per aggiungere un passaggio, il nuovo passaggio viene aggiunto dopo il passaggio attualmente selezionato. Questo cmdlet funziona in modo analogo e aggiunge il passaggio dopo l'indice specificato. Usare il parametro InsertStepStartIndex per specificare l'indice del passaggio.
\nQuesto cmdlet può aggiungere solo passaggi al livello principale della sequenza di attività, non in gruppi. Per aggiungere passaggi in gruppi, usare Set-CMTaskSequenceGroup. Ad esempio, con la sequenza di attività di esempio, se si usa Add-CMTaskSequenceStep con il valore 5del parametro InsertStepStartIndex , il cmdlet aggiunge il nuovo passaggio dopo group5 e prima del passaggio 6.
Nota
\nEseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\\>. Per altre informazioni, vedere Introduzione.
È disponibile un set di questi cmdlet per ogni passaggio della sequenza di attività.
\n\" />\r\n\r\nAggiungere un passaggio o un gruppo a una sequenza di attività.\n\" />\r\n] -Step