Start-Process

構文

Start-Process
     [-FilePath] <string>
     [[-ArgumentList] <string[]>]
     [-Credential <pscredential>]
     [-WorkingDirectory <string>]
     [-LoadUserProfile]
     [-NoNewWindow]
     [-PassThru]
     [-RedirectStandardError <string>]
     [-RedirectStandardInput <string>]
     [-RedirectStandardOutput <string>]
     [-WindowStyle <ProcessWindowStyle>]
     [-Wait]
     [-UseNewEnvironment]
     [<CommonParameters>]

Start-Process
     [-FilePath] <string>
     [[-ArgumentList] <string[]>]
     [-WorkingDirectory <string>]
     [-PassThru]
     [-Verb <string>]
     [-WindowStyle <ProcessWindowStyle>]
     [-Wait]
     [<CommonParameters>]

説明

Start-Process コマンドレットは、ローカル コンピューターで 1 つ以上のプロセスを開始します。 既定では、 Start-Process は、現在のプロセスで定義されているすべての環境変数を継承する新しいプロセスを作成します。

プロセスで実行するプログラムを指定するには、実行可能ファイルまたはスクリプト ファイル、またはコンピューター上のプログラムを使用して開くことができるファイルを入力します。 実行可能でないファイルを指定 Start-Process 、 Invoke-Item コマンドレットと同様に、ファイルに関連付けられているプログラムを起動します。

Start-Processのパラメーターを使用して、ユーザー プロファイルの読み込み、新しいウィンドウでのプロセスの開始、代替資格情報の使用などのオプションを指定できます。

例

例 1: 既定値を使用するプロセスを開始する

次の使用例は、現在のフォルダー内の Sort.exe ファイルを使用するプロセスを開始します。 このコマンドでは、既定のウィンドウ スタイル、作業フォルダー、資格情報など、すべての既定値が使用されます。

Start-Process -FilePath "sort.exe"

例 2: テキスト ファイルを印刷する

次の使用例は、 C:\PS-Test\MyFile.txt ファイルを出力するプロセスを開始します。

Start-Process -FilePath "myfile.txt" -WorkingDirectory "C:\PS-Test" -Verb Print

例 3: 項目を新しいファイルに並べ替えるプロセスを開始する

次の使用例は、 TestSort.txt ファイル内のアイテムを並べ替え、 Sorted.txt ファイル内の並べ替えられたアイテムを返すプロセスを開始します。 エラーは、 SortError.txt ファイルに書き込まれます。 UseNewEnvironment パラメーターは、プロセスが独自の環境変数で実行されることを指定します。

$processOptions = @{
    FilePath = "sort.exe"
    RedirectStandardInput = "TestSort.txt"
    RedirectStandardOutput = "Sorted.txt"
    RedirectStandardError = "SortError.txt"
    UseNewEnvironment = $true
}
Start-Process @processOptions

この例では、スプラッティングを使用してパラメーターをコマンドレットに渡します。 詳細については、「 about_Splatting」を参照してください。

例 4: 最大化されたウィンドウでプロセスを開始する

この例では、 Notepad.exe プロセスを開始します。 ウィンドウが最大化されて、プロセスが完了するまでそのまま維持されます。

Start-Process -FilePath "notepad" -Wait -WindowStyle Maximized

例 5: 管理者として PowerShell を起動する

この例では、 Run as administrator オプションを使用して PowerShell を起動します。

Start-Process -FilePath "powershell" -Verb RunAs

例 6: 異なる動詞を使用してプロセスを開始する

この例では、プロセスの開始時に使用できる動詞を検索する方法を示します。 使用可能な動詞は、プロセスで実行されるファイルのファイル名拡張子によって決まります。

$startExe = New-Object System.Diagnostics.ProcessStartInfo -Args powershell.exe
$startExe.verbs

open
runas
runasuser

この例では、New-Objectを使用して、PowerShell プロセスで実行されるファイルpowershell.exeの System.Diagnostics.ProcessStartInfo オブジェクトを作成します。 ProcessStartInfo オブジェクトの Verbs プロパティは、OpenおよびRunAs動詞をpowershell.exe、または.exe ファイルを実行する任意のプロセスで使用できることを示します。

例 7: プロセスへの引数の指定

どちらのコマンドも Windows コマンド インタープリターを起動し、Program Files フォルダーで dir コマンドを発行します。 このフォルダー名にはスペースが含まれているため、値はエスケープされた引用符で囲む必要があります。 最初のコマンドは、文字列を ArgumentList として指定します。 2 番目のコマンドは文字列配列です。

Start-Process -FilePath "$env:comspec" -ArgumentList "/c dir `"%SystemDrive%\Program Files`""
Start-Process -FilePath "$env:comspec" -ArgumentList "/c","dir","`"%SystemDrive%\Program Files`""

パラメーター

-ArgumentList

-Credential

-FilePath

-LoadUserProfile

-NoNewWindow

-PassThru

-RedirectStandardError

-RedirectStandardInput

-RedirectStandardOutput

-UseNewEnvironment

-Verb

-Wait

-WindowStyle

-WorkingDirectory

入力

None

このコマンドレットにオブジェクトをパイプすることはできません。

出力

None

既定では、このコマンドレットは出力を返しません。

Process

PassThru パラメーターを使用すると、このコマンドレットは Process オブジェクトを返します。

メモ

Windows PowerShell には、 Start-Processの次のエイリアスが含まれています。

• saps
• start

ネイティブ コマンドは、オペレーティング システムにインストールされている実行可能ファイルです。 これらの実行可能ファイルは、PowerShell などの任意のコマンド ライン シェルから実行できます。 通常は、bash や cmd.exe の場合とまったく同じようにコマンドを実行します。 Start-Process コマンドレットは、任意のネイティブ コマンドを実行するために使用できますが、コマンドの実行方法を制御する必要がある場合にのみ使用してください。

既定では、Start-Processはプロセスをに起動します。 新しいプロセスがまだ実行されている場合でも、制御はすぐに PowerShell に返されます。

• ローカル システムでは、起動されたプロセスは呼び出し元プロセスとは独立して動作します。
• リモート システムでは、 Start-Process コマンドの直後にリモート セッションが終了すると、新しいプロセスが終了します。 そのため、リモート セッションで Start-Process を使用することはできません。これは、起動されたプロセスがセッションを上回ると予想されます。

リモート セッションで Start-Process を使用する必要がある場合は、 Wait パラメーターを使用して呼び出します。 または、他の方法を使用して、リモート システムに新しいプロセスを作成することもできます。

Wait パラメーターを使用する場合、Start-Processはプロセス ツリー (プロセスとそのすべての子孫) が終了するまで待機してから制御を返します。 これは、指定されたプロセスが終了するまで待機する Wait-Process コマンドレットの動作とは異なります。

Windows では、 Start-Process の最も一般的なユース ケースは、 Wait パラメーターを使用して、新しいプロセスが終了するまで進行状況をブロックすることです。 Windows 以外のシステムでは、コマンド ライン アプリケーションの既定の動作は Start-Process -Waitと同等であるため、これはほとんど必要ありません。

このコマンドレットは、System.Diagnostics.Process クラスの Start メソッドを使用して実装されます。 このメソッドの詳細については、「 Process.Start メソッド」を参照してください。

関連リンク

• about_Quoting_Rules
• Debug-Process
• Get-Process
• Start-Service
• Stop-Process
• Wait-Process