タスク シーケンスで PowerShell スクリプトの実行 ステップを作成します。
\n","uid":"ConfigurationManager.New-CMTSStepRunPowerShellScript"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.New-CMTSStepRunPowerShellScript":{"href":"new-cmtssteprunpowershellscript","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMTSStepRunPowerShellScript","schemaType":"PowershellCmdlet","summary":"タスク シーケンスで PowerShell スクリプトの実行 ステップを作成します。
\n","uid":"ConfigurationManager.New-CMTSStepRunPowerShellScript"}},"description":"このコマンドレットは、 新しい PowerShell スクリプトの実行 ステップ オブジェクトを作成します。 次に、 Add-CMTaskSequenceStep コマンドレットを使用して、タスク シーケンスにステップを追加します。 この手順の詳細については、「 タスク シーケンスの手順について: PowerShell スクリプトを実行する」を参照してください。
\n注:
\n\n PS XYZ:\\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
この例では、最初に PowerShell スクリプトの実行 ステップのオブジェクトを作成します。 実行するスクリプトの名前を持つパッケージを指定します。 PowerShell 実行ポリシーを最も安全な AllSigned レベルに 設定します。このレベルでは、スクリプトをデジタル署名する必要があります。
\n次に、タスク シーケンス オブジェクトを取得し、インデックス 11 のタスク シーケンスにこの新しいステップを追加します。
\n","title":"例 1"}],"inputs":[{"description":"","name":"None\n"}],"links":[{"href":"get-cmtssteprunpowershellscript","text":"Get-CMTSStepRunPowerShellScript"},{"href":"remove-cmtssteprunpowershellscript","text":"Remove-CMTSStepRunPowerShellScript"},{"href":"set-cmtssteprunpowershellscript","text":"Set-CMTSStepRunPowerShellScript"},{"href":"/mem/configmgr/osd/understand/task-sequence-steps#BKMK_RunPowerShellScript","text":"タスク シーケンスの手順について: PowerShell スクリプトを実行する"}],"module":"ConfigurationManager","name":"New-CMTSStepRunPowerShellScript","notes":"この戻りオブジェクトとそのプロパティの詳細については、「 サーバー WMI クラスSMS_TaskSequence_RunPowerShellScriptAction」を参照してください。
\n","outputs":[{"description":"","name":"IResultObject\n"}],"parameters":[{"aliases":"Conditions","defaultValue":"None","description":"この手順で使用する条件オブジェクトを指定します。 このオブジェクトを取得するには、タスク シーケンス条件コマンドレットのいずれかを使用します。 たとえば、 Get-CMTSStepConditionVariable です。
\n","name":"Condition","parameterValueGroup":"","position":"Named","type":"IResultObject[]
\n"},{"aliases":"cf","defaultValue":"None","description":"コマンドレットを実行する前に確認メッセージを表示します。
\n","name":"Confirm","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"このパラメーターを追加して、ステップ オプション [ エラー時に続行] を有効にします。 このオプションを有効にすると、ステップが失敗した場合、タスク シーケンスは続行されます。
\n","name":"ContinueOnError","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"このタスク シーケンス ステップの説明 (省略可能) を指定します。
\n","name":"Description","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"DisableThisStep","defaultValue":"None","description":"このタスク シーケンス ステップを無効にするには、このパラメーターを追加します。
\n","name":"Disable","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 \n ForceWildcardHandling と組み合わせることはできません。
\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"PowerShellExecutionPolicy","defaultValue":"None","description":"コンピューターでの実行を許可するスクリプトの PowerShell 実行ポリシーを指定します。 次のいずれかのポリシーを選択します。
\n\n AllSigned: 信頼された発行元によって署名されたスクリプトのみを実行します。
\n Undefined: 実行ポリシーを定義しないでください。
\n Bypass: すべての構成ファイルを読み込み、すべてのスクリプトを実行します。 署名されていないスクリプトをインターネットからダウンロードした場合、PowerShell はスクリプトを実行する前にアクセス許可を求められません。
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 \n DisableWildcardHandling と組み合わせることはできません。
\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"StepName","defaultValue":"None","description":"この手順の名前を指定して、タスク シーケンスで識別します。
\n","isRequired":true,"name":"Name","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"Output, OutputVariable","defaultValue":"None","description":"カスタム タスク シーケンス変数の名前を指定します。 このパラメーターを使用すると、コマンド出力の最後の 1,000 文字が変数に保存されます。
\n","name":"OutputVariableName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"PowerShell スクリプトを持つパッケージのパッケージ ID を 指定します。 パッケージにはプログラムは必要ありません。 1 つのパッケージに複数のスクリプトを含めることができます。
\nこの値は、 XYZ00821などの標準パッケージ ID です。
次に、 ScriptName パラメーターを使用してスクリプトの名前を指定します。
\n","isRequired":true,"name":"PackageId","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"Parameters","defaultValue":"None","description":"PowerShell スクリプトに渡されるパラメーターを指定します。 これらのパラメーターは、コマンド ラインの PowerShell スクリプト パラメーターと同じです。 PowerShell コマンド ラインではなく、スクリプトによって使用されるパラメーターを指定します。
\n次の例には 、有効な パラメーターが含まれています。
\n-MyParameter1 MyValue1 -MyParameter2 MyValue2
次の例には 、無効な パラメーターが含まれています。 最初の 2 つの項目は、PowerShell コマンド ライン パラメーター (NoLogo と ExecutionPolicy) です。 スクリプトでは、これらのパラメーターは使用されません。
\n-NoLogo -ExecutionPolicy Unrestricted -File MyScript.ps1 -MyParameter1 MyValue1 -MyParameter2 MyValue2
パラメーター値に特殊文字またはスペースが含まれている場合は、値の周囲に単一引用符 (') を使用します。 二重引用符 (") を使用すると、タスク シーケンス ステップでパラメーターが誤って処理される可能性があります。
例: -Arg1 '%TSVar1%' -Arg2 '%TSVar2%'
このパラメーターをタスク シーケンス変数に設定することもできます。 たとえば、 %MyScriptVariable%を指定すると、タスク シーケンスでスクリプトが実行されるときに、このカスタム変数の値が PowerShell コマンド ラインに追加されます。
実行するスクリプトの名前を指定します。 このスクリプトは、 PackageId パラメーターで指定されたパッケージ内にあります。
\n","isRequired":true,"name":"ScriptName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"SourceCode","defaultValue":"None","description":"\n PackageId パラメーターと ScriptName パラメーターを使用する代わりに、このパラメーターを使用してスクリプト コマンドを直接指定します。 この文字列値は、この手順で実行される PowerShell コマンドです。
\n既存のスクリプト ファイルの内容を文字列変数に読み取り、その変数をこのパラメーターに使用できます。 例:
\n$script = [IO.File]::ReadAllText( "C:\\temp\\script.ps1" )
ステップが成功と評価するスクリプトの終了コードとして整数値の配列を指定します。
\n","name":"SuccessCode","parameterValueGroup":"","position":"Named","type":"Int32[]
\n"},{"aliases":"TimeoutInMinutes","defaultValue":"None","description":"Configuration Manager がスクリプトの実行を許可する期間を表す整数値を指定します。 この値は、 1 分から 999 分までです。 既定値は 15 分です。
指定したスクリプトが正常に完了するのに十分な時間を許可しない値を入力すると、この手順は失敗します。 ステップまたはグループの条件によっては、タスク シーケンス全体が失敗する可能性があります。 タイムアウトが切れた場合、Configuration Manager は PowerShell プロセスを終了します。
\n","name":"TimeoutMins","parameterValueGroup":"","position":"Named","type":"Int32\n"},{"aliases":"User","defaultValue":"None","description":"このパラメーターを使用して、ローカル システム アカウントではなく Windows ユーザー アカウントとしてスクリプトを実行します。 Windows ユーザー アカウントの名前を指定します。 アカウント パスワードを指定するには、 UserPassword パラメーターを使用します。
\n","name":"UserName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"Password","defaultValue":"None","description":"\n UserName で指定するアカウントのパスワードを指定するには、このパラメーターを使用します。
\n","name":"UserPassword","parameterValueGroup":"","position":"Named","type":"SecureString\n"},{"aliases":"wi","defaultValue":"None","description":"コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
\n","name":"WhatIf","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"StartIn","defaultValue":"None","description":"コマンドを開始するフォルダーを指定します。 このパスは最大 127 文字です。
\n","name":"WorkingDirectory","parameterValueGroup":"","position":"Named","type":"String\n"}],"schema":"PowershellCmdlet","summary":"タスク シーケンスで PowerShell スクリプトの実行 ステップを作成します。
\n","syntaxes":["New-CMTSStepRunPowerShellScript -Nameタスク シーケンスで PowerShell スクリプトの実行 ステップを作成します。
\n","uid":"ConfigurationManager.New-CMTSStepRunPowerShellScript"}],"canonical_url":"https://learn.microsoft.com/ja-jp/powershell/module/configurationmanager/new-cmtssteprunpowershellscript?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/ja-jp/powershell/module/configurationmanager/new-cmtssteprunpowershellscript?view=sccm-ps"},"pageMetadata":"このコマンドレットは、 新しい PowerShell スクリプトの実行 ステップ オブジェクトを作成します。 次に、 Add-CMTaskSequenceStep コマンドレットを使用して、タスク シーケンスにステップを追加します。 この手順の詳細については、「 タスク シーケンスの手順について: PowerShell スクリプトを実行する」を参照してください。\n注:
\n\n PS XYZ:\\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。