Get-CMTSStepRunPowerShellScript
特定のタスク シーケンスから PowerShell スクリプトの実行 ステップを取得します。
構文
Get-CMTSStepRunPowerShellScript
[-InputObject] <IResultObject>
[-StepName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Get-CMTSStepRunPowerShellScript
[-TaskSequenceId] <String>
[-StepName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Get-CMTSStepRunPowerShellScript
[-TaskSequenceName] <String>
[-StepName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
PowerShell スクリプトの実行ステップの 1 つ以上のインスタンスのタスク シーケンス ステップ オブジェクトを取得するには、このコマンドレットを使用します。 このオブジェクトを使用すると、次のことができます。
- Remove-CMTSStepRunPowerShellScript を使用してタスク シーケンスからステップを削除する
- Add-CMTaskSequenceStep を使用してステップを別のタスク シーケンスにコピーする
この手順の詳細については、「 タスク シーケンスの手順について: PowerShell スクリプトを実行する」を参照してください。
注:
PS XYZ:\>
など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1
この例では、最初に 、$tsOsd 変数内のタスク シーケンス オブジェクトを取得します。 次に、その変数を入力オブジェクトとして渡して、 PowerShell スクリプトの実行 ステップを取得します。
$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast
$tsStepNameRunPwsh = "Run PowerShell Script"
$tsStepRunPwsh = Get-CMTSStepRunPowerShellScript -InputObject $tsOsd -StepName $tsStepNameRunPwsh
パラメーター
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InputObject
PowerShell スクリプトの実行ステップを取得するタスク シーケンス オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMTaskSequence コマンドレットを使用します。
型: | IResultObject |
Aliases: | TaskSequence |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-StepName
タスク シーケンスから取得する PowerShell スクリプトの実行 ステップの名前を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-TaskSequenceId
PowerShell スクリプトの実行手順を取得するタスク シーケンスのパッケージ ID を指定します。 この値は、 XYZ00858
などの標準パッケージ ID です。
型: | String |
Aliases: | Id, TaskSequencePackageId |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-TaskSequenceName
PowerShell スクリプトの実行ステップを取得するタスク シーケンスの名前を指定します。
型: | String |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
System.Object