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>]
説明
このコマンドレットは、新しい Run Command Line ステップ オブジェクトを 作成します。 次に 、Add-CMTaskSequenceStep コマンドレットを使用して、手順をタスク シーケンスに追加します。 この手順の詳細については、「タスク シーケンスの手順 について: コマンド ラインの実行」を参照してください。
注意
Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\>
。 詳細については 、「Getting started」を参照してください。
例
例 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
この手順で使用する条件オブジェクトを指定します。 このオブジェクトを取得するには、タスク シーケンス条件コマンドレットのいずれかを使用します。 たとえば 、Get-CMTSStepConditionVariable です。
Type: | IResultObject[] |
Aliases: | Conditions |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
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 |
-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 ファイル システム リダイレクターを使用してコマンド ラインを実行します。 この動作は、OS の実行可能ファイルとライブラリの 32 ビット バージョンを適切に検索します。 WOW64 ファイル システム リダイレクターの使用を無効にするには、このパラメーターを追加します。 Windows 64 ビット 版の OS 実行可能ファイルとライブラリを使用してコマンドを実行します。 このオプションは、32 ビット OS で実行する場合は無効です。
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 |
-Name
タスク シーケンスで識別するには、この手順の名前を指定します。
Type: | String |
Aliases: | StepName |
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
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
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 |
入力
なし
出力
IResultObject
メモ
この戻り値オブジェクトとそのプロパティの詳細については、「SMS_TaskSequence_RunCommandLineAction WMI クラス」を参照してください。