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

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

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

どちらのコマンドも Windows コマンドインタープリターを起動し、フォルダーに dir 対してコマンドを Program Files 発行します。このフォルダー名にはスペースが含まれているため、値はエスケープされた引用符で囲む必要があります。最初のコマンドは、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 値を使用します。

Type:	String[]
Aliases:	Args
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

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

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

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

Note

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

Type:	PSCredential
Aliases:	RunAs
Position:	Named
Default value:	Current user
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FilePath

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

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

Type:	String
Aliases:	PSPath
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-LoadUserProfile

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

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

Type:	SwitchParameter
Aliases:	Lup
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoNewWindow

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

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

Type:	SwitchParameter
Aliases:	nnw
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RedirectStandardError

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

Type:	String
Aliases:	RSE
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RedirectStandardInput

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

Type:	String
Aliases:	RSI
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RedirectStandardOutput

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

Type:	String
Aliases:	RSO
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UseNewEnvironment

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Verb

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

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

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

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Wait

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WindowStyle

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

Normal
Hidden
Minimized
Maximized

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

Type:	ProcessWindowStyle
Accepted values:	Normal, Hidden, Minimized, Maximized
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WorkingDirectory

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 することはできません。

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

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: テキストファイルを印刷する