タスク シーケンスにステップまたはグループを追加します。
\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":"タスク シーケンスにステップまたはグループを追加します。
\n","uid":"ConfigurationManager.Add-CMTaskSequenceStep"}},"description":"このコマンドレットを使用して、グループまたはステップを既存のタスク シーケンスに追加します。 タスク シーケンスの手順の詳細については、「 タスク シーケンスの手順」を参照してください。
\nプログラムによってタスク シーケンスにステップを追加する場合は、手順のインデックス順序を理解することが重要です。 インデックスを視覚化するために、この記事では次のタスク シーケンスの例を使用します。
\n\n タスク シーケンス エディターを使用してステップを追加すると、現在選択されているステップの後に新しいステップが追加されます。 このコマンドレットも同様に機能し、指定したインデックスの後にステップを追加します。 \n InsertStepStartIndex パラメーターを使用して、ステップ インデックスを指定します。
\nこのコマンドレットは、グループではなく、タスク シーケンスのメイン レベルにのみステップを追加できます。 グループに手順を追加するには、 Set-CMTaskSequenceGroup を使用します。 たとえば、サンプル タスク シーケンスでは、InsertStepStartIndex パラメーター値5で Add-CMTaskSequenceStep を使用する場合、コマンドレットは group5 の後と step6 の前に新しいステップを追加します。
注:
\n\n PS XYZ:\\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
結果のタスク シーケンスは、次の一覧のようになります。
\nStep パラメーターでの順序付け方法により、 手順 はこのように並べ替えられます。
\n","summary":"この例では、最初の 2 つのコマンドで New-CMTaskSequenceStepRunPowerShellScript コマンドレットを使用して、 Powershell スクリプトの実行 ステップのステップ オブジェクトを作成します。 3 番目のコマンドは、 Run scripts という名前の新しいカスタム タスク シーケンスを作成します。 4 番目のコマンドは、パイプラインを介して新しいタスク シーケンス オブジェクトを Add-CMTaskSequenceStep に渡します。これは、2 つの手順を追加します。
\n","title":"例 1: 2 つの 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":"結果のタスク シーケンスは、次の一覧のようになります。
\n\n Add-CMTaskSequenceStep の各インスタンスは順序付けされ、InsertStepStartIndex パラメーターも使用されないため、既定ではインデックス 0が使用されます。 そのため、コマンドレットは最初のステップの 前に 2 番目のステップを追加します。
この例は例 1 と似ていますが、 Add-CMTaskSequenceStep コマンドレットの 2 つのインスタンスを使用しています。
\n","title":"例 2: 別の順序で 2 つの PowerShell スクリプトを実行するカスタム タスク シーケンスを作成する"},{"code":"$step = New-CMTSStepSetVariable -name \"newStep\" -TaskSequenceVariable \"testVar\" -TaskSequenceVariableValue \"testValue\"\nAdd-CMTaskSequenceStep -TaskSequenceName \"ts1\" -Step $step -InsertStepStartIndex 2","description":"","summary":"この例では、最初に New-CMTSStepSetVariable コマンドレットを使用して、[ タスク シーケンス変数の設定 ] ステップのステップ オブジェクトを作成します。 次に、インデックス 2 のステップの後に ts1 という名前のタスク シーケンスにこのステップを追加します。 \n 説明のタスク シーケンスの例を使用して、このコマンドは step2 と step3 の間に newStep を追加します。
\n","title":"例 3: 特定のインデックスにステップを追加する"},{"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":"次の使用例は、既存のタスク シーケンスをコピーし、名前を変更します。 次の一連の手順では、セキュリティ スコープを再構成します。 その後、パッケージの ID を取得し、別の手順から条件オブジェクトをコピーします。 最後のグループでは、パッケージオブジェクトと条件オブジェクトを使用する新しい コマンド ライン実行 ステップが作成されます。 次に、インデックス 11 の新しいタスク シーケンスに新しいステップを追加します。
\n","title":"例 4: タスク シーケンスをコピーし、新しい手順を追加する"}],"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":"タスク シーケンスの手順について"}],"module":"ConfigurationManager","name":"Add-CMTaskSequenceStep","notes":"関連リンク セクションには記載されていませんが、 Get-CMTSStep*、 New-CMTSStep*、 Remove-CMTSStep*、 Set-CMTSStep* コマンドレットを 使用できます。 例:
\nタスク シーケンス ステップごとに、これらのコマンドレットのセットがあります。
\n","outputs":[{"description":"","name":"System.Object\n"}],"parameters":[{"aliases":"cf","defaultValue":"None","description":"コマンドレットを実行する前に確認メッセージを表示します。
\n","name":"Confirm","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 \n ForceWildcardHandling と組み合わせることはできません。
\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 \n DisableWildcardHandling と組み合わせることはできません。
\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"TaskSequence","defaultValue":"None","description":"コマンドレットがステップを追加するタスク シーケンス オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMTaskSequence、 Copy-CMTaskSequence、または New-CMTaskSequence コマンドレットを 使用します。
\n","isRequired":true,"name":"InputObject","parameterValueGroup":"","pipelineInput":true,"position":"Named","type":"IResultObject\n"},{"aliases":"InsertStepsStartIndex","defaultValue":"None","description":"タスク シーケンス インデックスの整数値を指定します。 コマンドレットは、この指定したインデックスの後に新しいステップを追加します。 たとえば、 Description のタスク シーケンスの例を使用して、 4の値を指定した場合、コマンドレットは 手順 4 の後に新しいステップを追加します。
\n 0の値を指定すると、コマンドレットはタスク シーケンスの先頭に新しいステップを追加します。 このパラメーターを指定しない場合、この動作は既定です。 たとえば、コマンドレットは手順 1 の前に新しいステップを追加します。
最大値はありません。 最後のステップのインデックスより大きい値を指定すると、コマンドレットはタスク シーケンスの最後に新しいステップを追加します。 たとえば、 10の値を指定すると、コマンドレットは step6 の後に新しいステップを追加します。
タスク シーケンスに追加する 1 つ以上のステップ オブジェクトを指定します。 このオブジェクトを取得するには、 New-CMTSStep* コマンドレットのいずれかを使用します。 たとえば、 Get-CMTSStepApplyDataImage です。
\n","isRequired":true,"name":"Step","parameterValueGroup":"","position":"Named","type":"IResultObject[]
\n"},{"aliases":"Id, TaskSequencePackageId","defaultValue":"None","description":"コマンドレットがステップを追加するタスク シーケンスの ID を指定します。 この ID は、タスク シーケンス パッケージ ID です (たとえば、 XYZ00861)。
コマンドレットがステップを追加するタスク シーケンスの名前を指定します。
\n","isRequired":true,"name":"TaskSequenceName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"wi","defaultValue":"None","description":"コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
\n","name":"WhatIf","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"}],"schema":"PowershellCmdlet","summary":"タスク シーケンスにステップまたはグループを追加します。
\n","syntaxes":["Add-CMTaskSequenceStep [-InsertStepStartIndexタスク シーケンスにステップまたはグループを追加します。
\n","uid":"ConfigurationManager.Add-CMTaskSequenceStep"}],"canonical_url":"https://learn.microsoft.com/ja-jp/powershell/module/configurationmanager/add-cmtasksequencestep?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/ja-jp/powershell/module/configurationmanager/add-cmtasksequencestep?view=sccm-ps"},"pageMetadata":"このコマンドレットを使用して、グループまたはステップを既存のタスク シーケンスに追加します。 タスク シーケンスの手順の詳細については、「 タスク シーケンスの手順」を参照してください。\nプログラムによってタスク シーケンスにステップを追加する場合は、手順のインデックス順序を理解することが重要です。 インデックスを視覚化するために、この記事では次のタスク シーケンスの例を使用します。
\n\n タスク シーケンス エディターを使用してステップを追加すると、現在選択されているステップの後に新しいステップが追加されます。 このコマンドレットも同様に機能し、指定したインデックスの後にステップを追加します。 \n InsertStepStartIndex パラメーターを使用して、ステップ インデックスを指定します。
\nこのコマンドレットは、グループではなく、タスク シーケンスのメイン レベルにのみステップを追加できます。 グループに手順を追加するには、 Set-CMTaskSequenceGroup を使用します。 たとえば、サンプル タスク シーケンスでは、InsertStepStartIndex パラメーター値5で Add-CMTaskSequenceStep を使用する場合、コマンドレットは group5 の後と step6 の前に新しいステップを追加します。
注:
\n\n PS XYZ:\\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
タスク シーケンス ステップごとに、これらのコマンドレットのセットがあります。
\n\" />\r\n\r\nタスク シーケンスにステップまたはグループを追加します。\n\" />\r\n] -Step