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>]
说明
使用此 cmdlet 获取 运行 PowerShell 脚本 步骤的一个或多个实例的任务序列步骤对象。 可以使用此对象来:
- 使用 Remove-CMTSStepRunPowerShellScript 从任务序列中删除步骤
- 使用 Add-CMTaskSequenceStep 将步骤复制到另一个任务序列
有关此步骤的详细信息,请参阅 关于任务序列步骤:运行 PowerShell 脚本。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet,例如 PS XYZ:\>
。 有关详细信息,请参阅 入门。
示例
示例 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
提示你在运行 cmdlet 之前进行确认。
类型: | SwitchParameter |
别名: | cf |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-InputObject
指定要从中获取 运行 PowerShell 脚本 步骤的任务序列对象。 若要获取此对象,请使用 Get-CMTaskSequence cmdlet。
类型: | IResultObject |
别名: | TaskSequence |
Position: | 0 |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-StepName
指定要从任务序列获取的 “运行 PowerShell 脚本” 步骤的名称。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-TaskSequenceId
指定要从中获取运行 PowerShell 脚本步骤的任务序列的包 ID。 此值是标准包 ID,例如 XYZ00858
。
类型: | String |
别名: | Id, TaskSequencePackageId |
Position: | 0 |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-TaskSequenceName
指定要从中获取 运行 PowerShell 脚本 步骤的任务序列的名称。
类型: | String |
Position: | 0 |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
类型: | SwitchParameter |
别名: | wi |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
输入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
输出
System.Object