New-CMTSStepRunCommandLine
创建 可添加到 任务序列的"运行命令行"步骤。
语法
New-CMTSStepRunCommandLine
-CommandLine <String>
[-DisableWow64Redirection]
[-PackageId <String>]
[-RunAsUser]
[-SuccessCode <Int32[]>]
[-Timeout <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMTSStepRunCommandLine
-CommandLine <String>
[-DisableWow64Redirection]
[-OutputVariableName <String>]
[-PackageId <String>]
[-RunAsUser]
[-SuccessCode <Int32[]>]
[-Timeout <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMTSStepRunCommandLine
-CommandLine <String>
[-DisableWow64Redirection]
[-OutputVariableName <String>]
[-PackageId <String>]
[-RunAsUser]
[-SuccessCode <Int32[]>]
[-Timeout <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 说明
此 cmdlet 创建新的 Run 命令行 步骤对象。 然后使用 Add-CMTaskSequenceStep cmdlet 将步骤添加到任务序列。 有关此步骤详细信息，请参阅关于 任务序列步骤：运行命令行。
备注
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\> 。 有关详细信息，请参阅 入门。
示例
示例 1
此示例首先为"运行命令行" 步骤创建一 个对象。 它指定要使用的命令行和程序包。
然后，它获取一个任务序列对象，并将这个新步骤添加到索引为 11 的任务序列。
$step = New-CMTSStepRunCommandLine -Name "Run Command Line" -CommandLine "cmd.exe /c copy Jan98.dat c:\sales\Jan98.dat" -PackageId "XYZ00821"
$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast
$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11参数
-CommandLine
指定任务序列运行的命令行。 包括文件扩展名，例如 ， .exe 。 包括所有必需的设置文件和命令行选项。
例如：cmd.exe /c copy Jan98.dat c:\sales\Jan98.dat
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Condition
指定要用于此步骤的条件对象。 若要获取此对象，请使用任务序列条件 cmdlet 之一。 例如 ，Get-CMTSStepConditionVariable。
| Type: | IResultObject[] |
| Aliases: | Conditions |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ContinueOnError
添加此参数以启用步骤选项 "错误时继续"。 启用此选项后，如果步骤失败，任务序列将继续。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Disable
添加此参数可禁用此任务序列步骤。
| Type: | SwitchParameter |
| Aliases: | DisableThisStep |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
此参数将通配符视为文字字符值。 不能将其与 ForceWildcardHandling 结合使用。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWow64Redirection
默认情况下，64 位操作系统使用 WOW64 文件系统重定向程序运行命令行。 此行为用于正确查找 32 位版本的操作系统可执行文件和库。 添加此参数以禁止使用 WOW64 文件系统重定向程序。 Windows使用本机 64 位版本的操作系统可执行文件和库运行命令。 此选项在 32 位操作系统上运行时不起作用。
| Type: | SwitchParameter |
| Aliases: | DisableRedirectionFor64BitFileSystem |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
此参数处理通配符，并且可能会导致意外行为 (不建议) 。 不能将其与 DisableWildcardHandling 结合使用。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OutputVariableName
指定自定义任务序列变量的名称。 使用此参数时，该步骤会将命令输出的最后 1000 个字符保存到变量中。
| Type: | String |
| Aliases: | Output, OutputVariable |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PackageId
当你在命令行上指定目标计算机上不存在的文件或程序时，请使用此参数指定具有所需文件的包的程序包 ID。 **** 程序包不需要程序。 如果指定文件存在于目标计算机上，则不需要此选项。
此值是标准程序包 ID，例如 XYZ00821 。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsUser
添加此参数以将命令行作为Windows而不是本地系统帐户运行。 然后使用 UserName 和 UserPassword 参数。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SuccessCode
将整数值数组指定为步骤应评估为成功的命令中的退出代码。
| Type: | Int32[] |
| Aliases: | SuccessCodes |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Timeout
指定一个整数值，它代表 Configuration Manager 允许命令行运行多久。 此值可以是分钟 1 到 999 分钟。 默认值为 15 分钟。
如果输入的值不足以让指定命令成功完成，则此步骤将失败。 整个任务序列可能会失败，具体取决于步骤或组条件。 如果超时过期，Configuration Manager 将终止命令行进程。
| Type: | Int32 |
| Aliases: | TimeoutInMinutes |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserName
使用RunAsUser参数时，请使用此参数指定用户帐户Windows的名称。 若要指定帐户密码，请使用 UserPassword 参数。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserPassword
使用 RunAsUser 参数时，使用此参数指定使用 UserName指定的帐户的密码。
| Type: | SecureString |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不运行。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WorkingDirectory
指定命令启动的文件夹。 此路径最多为 127 个字符。
| Type: | String |
| Aliases: | StartIn |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-名称
指定此步骤的名称以在任务序列中标识它。
| Type: | String |
| Aliases: | StepName |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-描述
指定此任务序列步骤的可选说明。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
输入
无
输出
IResultObject
备注
有关此返回对象及其属性的信息，请参阅SMS_TaskSequence_RunCommandLineAction WMI 类。