New-CMTSStepRunCommandLine
建立 執行命令列 步驟，您可以將它新增至任務順序。
Syntax
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>] Description
此 Cmdlet 會建立新的 執行命令列 step 物件。 然後使用 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 |
-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 |
-Description
指定此任務順序步驟的選用描述。
| Type: | String |
| 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位版本的 OS 可執行檔和文件庫。 新增此參數以停用 WOW64 檔案系統重新導向程式的使用。 Windows 會使用原生64位版本的 OS 可執行檔和文件庫來執行命令。 在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
當您在命令列上指定尚未存在於目的地電腦上的檔案或程式時，請使用此參數指定包含必要檔案的套裝軟體 識別碼 。 套件不需要程式。 如果指定的檔案存在於目的地電腦上，則不需要此選項。
例如，這個值是標準套件識別碼 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: | SwitchParameter |
| Aliases: | DisableThisStep |
| 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 |
-條件
指定要與此步驟搭配使用的 condition 物件。 若要取得此物件，請使用其中一個工作順序條件 Cmdlet。 例如， CMTSStepConditionVariable。
| Type: | IResultObject[] |
| Aliases: | Conditions |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
輸入
無
輸出
IResultObject
備註
如需此 return 物件及其屬性的詳細資訊，請參閱 SMS_TaskSequence_RunCommandLineAction SERVER WMI 類別。