Bagikan melalui

Wait-Process

  • Referensi
Modul:
Microsoft.PowerShell.Management

Menunggu proses dihentikan sebelum menerima lebih banyak input.

Sintaks

Wait-Process
    [-Name] <String[]>
    [[-Timeout] <Int32>]
    [-Any]
    [-PassThru]
    [<CommonParameters>]
Wait-Process
    [-Id] <Int32[]>
    [[-Timeout] <Int32>]
    [-Any]
    [-PassThru]
    [<CommonParameters>]
Wait-Process
    [[-Timeout] <Int32>]
    [-Any]
    [-PassThru]
    -InputObject <Process[]>
    [<CommonParameters>]

Deskripsi

Cmdlet ini tidak berfungsi di Linux atau macOS.

Wait-Process Cmdlet menunggu satu atau beberapa proses yang berjalan dihentikan sebelum menerima input. Di konsol PowerShell, cmdlet ini menekan prompt perintah hingga proses dihentikan. Anda dapat menentukan proses berdasarkan nama proses atau ID proses (PID), atau menyalurkan objek proses ke Wait-Process.

Wait-Process hanya berfungsi pada proses yang berjalan di komputer lokal.

Contoh

Contoh 1: Hentikan proses dan tunggu

Contoh ini menghentikan proses Notepad lalu menunggu proses dihentikan sebelum dilanjutkan dengan perintah berikutnya.

$nid = (Get-Process notepad).id
Stop-Process -Id $nid
Wait-Process -Id $nid

Get-Process Cmdlet mendapatkan ID proses proses Notepad dan menyimpannya dalam $nid variabel. Stop-Process menghentikan proses dengan ID yang disimpan di $nid. Wait-Process menunggu hingga proses Notepad dihentikan.

Contoh 2: Menentukan proses

Contoh ini menunjukkan tiga metode berbeda untuk menentukan proses ke Wait-Process. Perintah pertama mendapatkan proses Notepad dan menyimpannya dalam $p variabel. Perintah kedua menggunakan parameter Id, perintah ketiga menggunakan parameter Nama, dan perintah keempat menggunakan parameter InputObject.

$p = Get-Process notepad
Wait-Process -Id $p.id
Wait-Process -Name "notepad"
Wait-Process -InputObject $p

Perintah ini memiliki hasil yang sama dan dapat digunakan secara bergantian.

Contoh 3: Tunggu proses untuk waktu yang ditentukan

Dalam contoh ini, Wait-Process menunggu 30 detik agar proses Outlook dan Winword berhenti. Jika kedua proses tidak dihentikan, cmdlet menampilkan kesalahan yang tidak mengakhiri dan prompt perintah.

Wait-Process -Name outlook, winword -Timeout 30

Parameter

-Any

Ketika beberapa proses diteruskan ke Wait-Process, cmdlet menunggu semua proses keluar sebelum kembali. Dengan parameter ini, cmdlet kembali ketika salah satu proses keluar. Proses yang tersisa terus berjalan.

Parameter ini ditambahkan di PowerShell 7.4.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Id

Menentukan ID proses. Untuk menentukan beberapa ID, gunakan koma untuk memisahkan ID. Untuk menemukan PID proses, ketik Get-Process.

Jenis:Int32[]
Alias:PID, ProcessId
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-InputObject

Menentukan proses dengan mengirimkan objek proses. Masukkan variabel yang berisi objek proses, atau ketik perintah atau ekspresi yang mendapatkan objek proses, seperti Get-Process cmdlet.

Jenis:Process[]
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-Name

Menentukan nama proses. Untuk menentukan beberapa nama, gunakan koma untuk memisahkan nama. Karakter kartubebas tidak didukung.

Jenis:String[]
Alias:ProcessName
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-PassThru

Secara default, cmdlet ini tidak menghasilkan apa pun. Dengan parameter ini, cmdlet mengembalikan objek yang mewakili proses yang ditunggu.

Parameter ini ditambahkan di PowerShell 7.4.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Timeout

Menentukan waktu maksimum, dalam detik, bahwa cmdlet ini menunggu proses yang ditentukan berhenti. Ketika interval ini kedaluwarsa, perintah menampilkan kesalahan yang tidak mengakhiri yang mencantumkan proses yang masih berjalan, dan mengakhiri penantian. Secara default, tidak ada waktu habis.

Jenis:Int32
Alias:TimeoutSec
Position:1
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Input

Process

Anda dapat menyalurkan objek proses ke cmdlet ini.

Output

None

Secara default, cmdlet ini tidak mengembalikan output.

Process

Cmdlet mengembalikan objek proses saat Anda menggunakan parameter PassThru .

Catatan

  • Cmdlet ini menggunakan metode WaitForExit dari kelas System.Diagnostics.Process .

  • Tidak seperti Start-Process -Wait, Wait-Process hanya menunggu proses yang diidentifikasi. Start-Process -Wait menunggu pohon proses (proses dan semua turunannya) keluar sebelum mengembalikan kontrol.