Start-Process

リファレンス

モジュール:: Microsoft.PowerShell.Management

ローカルコンピューターで 1 つ以上のプロセスを開始します。

構文

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 を起動する

この例では、[管理者として実行] オプションを使用して 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.exe(PowerShell プロセスで実行されるファイル) の System.Diagnostics.ProcessStartInfo オブジェクトを作成します。 ProcessStartInfo オブジェクトの Verbs プロパティは、powershell.exeまたは .exe ファイルを実行する任意のプロセスで、Open および RunAs 動詞を使用できることを示しています。

例 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

このコマンドレットがプロセスを開始するときに使用するパラメーターまたはパラメーター値を指定します。引数は、スペースで区切られた引数を持つ単一の文字列として、またはコンマで区切られた文字列の配列として受け取ることができます。コマンドレットは、配列を 1 つの文字列に結合し、配列の各要素を 1 つのスペースで区切ります。

ArgumentList 値が新しいプロセスに渡されるときに、PowerShell 文字列の外側の引用符は含まれません。パラメーターまたはパラメーター値にスペースまたは引用符が含まれている場合は、エスケープされた二重引用符で囲む必要があります。詳細については、about_Quoting_Rulesを参照してください。

最適な結果を得るには、すべての引数と必要な引用符文字を含む 1 つの ArgumentList 値を使用します。

型:	String[]
Aliases:	Args
配置:	1
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Credential

このアクションを実行するアクセス許可を持つユーザーアカウントを指定します。既定では、コマンドレットは現在のユーザーの資格情報を使用します。

User01 や Domain01\User01などのユーザー名を入力するか、Get-Credential コマンドレットによって生成された PSCredential オブジェクトを入力します。ユーザー名を入力すると、パスワードの入力を求められます。

資格情報は PSCredential オブジェクトに格納され、パスワードは SecureStringとして格納されます。

手記

SecureString データ保護 の詳細については、「SecureString のセキュリティ方法」を参照してください。.

型:	PSCredential
Aliases:	RunAs
配置:	Named
規定値:	Current user
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-FilePath

プロセスで実行されるプログラムのオプションのパスとファイル名を指定します。コンピューター上のプログラムに関連付けられている実行可能ファイルまたはドキュメントの名前 (.txt、.doc ファイルなど) を入力します。このパラメーターは必須です。

ファイル名のみを指定する場合は、WorkingDirectory パラメーターを使用してパスを指定します。

型:	String
Aliases:	PSPath
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-LoadUserProfile

このコマンドレットは、現在のユーザーの HKEY_USERS レジストリキーに格納されている Windows ユーザープロファイルを読み込みます。

このパラメーターは、PowerShell プロファイルには影響しません。詳細については、about_Profilesを参照してください。

型:	SwitchParameter
Aliases:	Lup
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-NoNewWindow

現在のコンソールウィンドウで新しいプロセスを開始します。 Windows の既定では、PowerShell によって新しいウィンドウが開きます。

同じコマンドで NoNewWindow パラメーターと WindowStyle パラメーターを使用することはできません。

型:	SwitchParameter
Aliases:	nnw
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PassThru

コマンドレットが開始した各プロセスのプロセスオブジェクトを返します。既定では、このコマンドレットは出力を生成しません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RedirectStandardError

ファイルを指定します。このコマンドレットは、プロセスによって生成されたエラーを、指定したファイルに送信します。パスとファイル名を入力します。既定では、エラーはコンソールに表示されます。

型:	String
Aliases:	RSE
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RedirectStandardInput

ファイルを指定します。このコマンドレットは、指定されたファイルから入力を読み取ります。入力ファイルのパスとファイル名を入力します。既定では、プロセスはキーボードから入力を取得します。

型:	String
Aliases:	RSI
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RedirectStandardOutput

ファイルを指定します。このコマンドレットは、プロセスによって生成された出力を、指定したファイルに送信します。パスとファイル名を入力します。既定では、出力はコンソールに表示されます。

型:	String
Aliases:	RSO
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-UseNewEnvironment

このコマンドレットが、プロセスに指定された新しい環境変数を使用することを示します。既定では、開始プロセスは、親プロセスから継承された環境変数で実行されます。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Verb

このコマンドレットがプロセスを開始するときに使用する動詞を指定します。使用できる動詞は、プロセスで実行されるファイルのファイル名拡張子によって決まります。

次の表は、一般的なプロセスファイルの種類の動詞を示しています。

ファイルの種類	動詞
.cmd	`Edit`, `Open`, `Print`, `RunAs`, `RunAsUser`
.exe	`Open`、`RunAs`、`RunAsUser`
.txt	`Open`、`Print`、`PrintTo`
.wav	`Open`、`Play`

プロセスで実行されるファイルで使用できる動詞を検索するには、New-Object コマンドレットを使用して、ファイルの System.Diagnostics.ProcessStartInfo オブジェクトを作成します。使用可能な動詞は、ProcessStartInfo オブジェクトの Verbs プロパティにあります。詳細については、例を参照してください。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Wait

このコマンドレットは、指定されたプロセスとその子孫が完了するまで待機してから、より多くの入力を受け入れることを示します。このパラメーターは、コマンドプロンプトを抑制するか、プロセスが完了するまでウィンドウを保持します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WindowStyle

新しいプロセスに使用されるウィンドウの状態を指定します。既定値は Normalです。このパラメーターに使用できる値は次のとおりです。

Normal
Hidden
Minimized
Maximized

WindowStyle を使用して、同じコマンドで NoNewWindow パラメーターを することはできません。

型:	ProcessWindowStyle
指定可能な値:	Normal, Hidden, Minimized, Maximized
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WorkingDirectory

新しいプロセスを開始する場所を指定します。既定値は、起動中の実行可能ファイルまたはドキュメントの場所です。ワイルドカードはサポートされていません。パスには、ワイルドカードとして解釈される文字を含めてはなりません。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

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 メソッドの」を参照してください。

次の方法で共有

Start-Process

構文

説明

例

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

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

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

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

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

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

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

パラメーター

-ArgumentList

-Credential

-FilePath

-LoadUserProfile

-NoNewWindow

-PassThru

-RedirectStandardError

-RedirectStandardInput

-RedirectStandardOutput

-UseNewEnvironment

-Verb

-Wait

-WindowStyle

-WorkingDirectory

入力

出力

メモ

その他のリソース

次の方法で共有

Start-Process

構文

説明

例

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

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

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

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

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

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

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

パラメーター

-ArgumentList

-Credential

-FilePath

-LoadUserProfile

-NoNewWindow

-PassThru

-RedirectStandardError

-RedirectStandardInput

-RedirectStandardOutput

-UseNewEnvironment

-Verb

-Wait

-WindowStyle

-WorkingDirectory

入力

出力

メモ

関連リンク

その他のリソース

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