Where-Object

Modul:: Microsoft.PowerShell.Core Module

Memilih objek dari koleksi berdasarkan nilai propertinya.

Sintaks

EqualSet (Default)

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    [-InputObject <PSObject>]
    [-EQ]
    [<CommonParameters>]

ScriptBlockSet

Where-Object
    [-FilterScript] <ScriptBlock>
    [-InputObject <PSObject>]
    [<CommonParameters>]

MatchSet

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -Match
    [-InputObject <PSObject>]
    [<CommonParameters>]

CaseSensitiveEqualSet

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -CEQ
    [-InputObject <PSObject>]
    [<CommonParameters>]

NotEqualSet

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -NE
    [-InputObject <PSObject>]
    [<CommonParameters>]

CaseSensitiveNotEqualSet

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -CNE
    [-InputObject <PSObject>]
    [<CommonParameters>]

GreaterThanSet

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -GT
    [-InputObject <PSObject>]
    [<CommonParameters>]

CaseSensitiveGreaterThanSet

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -CGT
    [-InputObject <PSObject>]
    [<CommonParameters>]

LessThanSet

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -LT
    [-InputObject <PSObject>]
    [<CommonParameters>]

CaseSensitiveLessThanSet

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -CLT
    [-InputObject <PSObject>]
    [<CommonParameters>]

GreaterOrEqualSet

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -GE
    [-InputObject <PSObject>]
    [<CommonParameters>]

CaseSensitiveGreaterOrEqualSet

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -CGE
    [-InputObject <PSObject>]
    [<CommonParameters>]

LessOrEqualSet

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -LE
    [-InputObject <PSObject>]
    [<CommonParameters>]

CaseSensitiveLessOrEqualSet

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -CLE
    [-InputObject <PSObject>]
    [<CommonParameters>]

LikeSet

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -Like
    [-InputObject <PSObject>]
    [<CommonParameters>]

CaseSensitiveLikeSet

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -CLike
    [-InputObject <PSObject>]
    [<CommonParameters>]

NotLikeSet

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -NotLike
    [-InputObject <PSObject>]
    [<CommonParameters>]

CaseSensitiveNotLikeSet

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -CNotLike
    [-InputObject <PSObject>]
    [<CommonParameters>]

CaseSensitiveMatchSet

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -CMatch
    [-InputObject <PSObject>]
    [<CommonParameters>]

NotMatchSet

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -NotMatch
    [-InputObject <PSObject>]
    [<CommonParameters>]

CaseSensitiveNotMatchSet

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -CNotMatch
    [-InputObject <PSObject>]
    [<CommonParameters>]

ContainsSet

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -Contains
    [-InputObject <PSObject>]
    [<CommonParameters>]

CaseSensitiveContainsSet

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -CContains
    [-InputObject <PSObject>]
    [<CommonParameters>]

NotContainsSet

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -NotContains
    [-InputObject <PSObject>]
    [<CommonParameters>]

CaseSensitiveNotContainsSet

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -CNotContains
    [-InputObject <PSObject>]
    [<CommonParameters>]

InSet

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -In
    [-InputObject <PSObject>]
    [<CommonParameters>]

CaseSensitiveInSet

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -CIn
    [-InputObject <PSObject>]
    [<CommonParameters>]

NotInSet

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -NotIn
    [-InputObject <PSObject>]
    [<CommonParameters>]

CaseSensitiveNotInSet

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -CNotIn
    [-InputObject <PSObject>]
    [<CommonParameters>]

IsSet

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -Is
    [-InputObject <PSObject>]
    [<CommonParameters>]

IsNotSet

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -IsNot
    [-InputObject <PSObject>]
    [<CommonParameters>]

Not

Where-Object
    [-Property] <String>
    -Not
    [-InputObject <PSObject>]
    [<CommonParameters>]

Deskripsi

Where-Object Cmdlet memilih objek yang memiliki nilai properti tertentu dari kumpulan objek yang diteruskan ke objek tersebut. Misalnya, Anda dapat menggunakan Where-Object cmdlet untuk memilih file yang dibuat setelah tanggal tertentu, peristiwa dengan ID tertentu, atau komputer yang menggunakan versi Windows tertentu.

Dimulai di Windows PowerShell 3.0, ada dua cara berbeda untuk membuat Where-Object perintah.

Sintaksis blok skrip. Anda dapat menggunakan blokir skrip untuk menentukan nama properti, operator perbandingan, dan nilai properti. Where-Object mengembalikan semua objek yang pernyataan blok skripnya benar.

Misalnya, perintah berikut mendapatkan proses di mana nilai properti PriorityClass sama dengan Normal.

Get-Process | Where-Object {$_.PriorityClass -eq "Normal"}

Semua operator perbandingan PowerShell valid dalam format skripblock. Untuk informasi lebih lanjut, lihat about_Comparison_Operators.
Sintaks yang disederhanakan. Untuk mengaktifkan sintaks yang disederhanakan, Where-Object sertakan 31 parameter sakelar yang mewakili operator perbandingan. Sintaks yang disederhanakan lebih mudah dibaca dan ditulis daripada sintaks skripblock. Anda dapat menggabungkan salah satu parameter pengalihan dengan parameter Properti dan Nilai untuk membuat perintah yang memfilter objek berdasarkan nilai propertinya.

Misalnya, perintah berikut juga mendapatkan proses yang memiliki kelas prioritas .Normal Perintah ini setara dan Anda dapat menggunakannya secara bergantian.

Get-Process | Where-Object -Property PriorityClass -Value Normal -EQ

Get-Process | Where-Object PriorityClass -EQ Normal

Seperti yang ditunjukkan dalam contoh, nama parameter Properti dan Nilai bersifat opsional. Parameter Properti adalah parameter posisi yang dipetakan ke posisi 0. Parameter Nilai adalah parameter posisi yang dipetakan ke posisi 1. Parameter sakelar, yang digunakan untuk menentukan perbandingan, dapat digunakan dalam posisi apa pun.

Sintaks yang disederhanakan diperkenalkan di Windows PowerShell 3.0. Untuk informasi selengkapnya, lihat about_Simplified_Syntax.

Saat Anda memberikan satu Properti ke Where-Object, cmdlet memperlakukan nilai properti sebagai ekspresi boolean. Saat nilai Panjang properti bukan nol, ekspresi mengevaluasi ke $true. Misalnya: ('hi', '', 'there') | Where-Object Length

Contoh sebelumnya secara fungsional setara dengan:

('hi', '', 'there') | Where-Object Length -GT 0
('hi', '', 'there') | Where-Object { $_.Length -gt 0 }

Untuk informasi selengkapnya tentang cara PowerShell mengevaluasi boolean, lihat about_Booleans.

Contoh

Contoh 1: Dapatkan layanan yang dihentikan

Perintah ini mendapatkan daftar semua layanan yang dihentikan. Variabel $_ otomatis mewakili setiap objek yang diteruskan ke Where-Object cmdlet.

Perintah pertama menggunakan format blok skrip, perintah kedua menggunakan format pernyataan perbandingan. Perintah memfilter layanan dengan cara yang sama dan mengembalikan output yang sama. Hanya sintaksnya yang berbeda.

Get-Service | Where-Object { $_.Status -eq "Stopped" }
Get-Service | Where-Object Status -EQ "Stopped"

Contoh 2: Mendapatkan proses berdasarkan set kerja

Perintah ini mencantumkan proses yang memiliki set kerja lebih besar dari 250 megabyte (MB). Perintah memfilter proses dengan cara yang sama dan mengembalikan output yang sama. Hanya sintaksnya yang berbeda.

Get-Process | Where-Object { $_.WorkingSet -gt 250MB }
Get-Process | Where-Object WorkingSet -GT 250MB

Contoh 3: Dapatkan proses berdasarkan nama proses

Perintah ini mendapatkan proses yang memiliki nilai properti ProcessName yang dimulai dengan huruf p. Operator -match dan parameter Match memungkinkan Anda menggunakan kecocokan ekspresi reguler.

Perintah memfilter proses dengan cara yang sama dan mengembalikan output yang sama. Hanya sintaksnya yang berbeda.

Get-Process | Where-Object { $_.ProcessName -match "^p.*" }
Get-Process | Where-Object ProcessName -Match "^p.*"

Contoh 4: Gunakan format pernyataan perbandingan

Contoh ini menunjukkan cara menggunakan format pernyataan perbandingan baru cmdlet Where-Object .

Perintah pertama menggunakan format pernyataan perbandingan. Ini tidak menggunakan alias apa pun dan menyertakan nama untuk setiap parameter.

Perintah kedua adalah penggunaan format perintah perbandingan yang lebih alami. Perintah menggantikan where alias untuk Where-Object nama cmdlet dan menghilangkan semua nama parameter opsional.

Perintah memfilter proses dengan cara yang sama dan mengembalikan output yang sama. Hanya sintaksnya yang berbeda.

Get-Process | Where-Object -Property Handles -GE -Value 1000
Get-Process | where Handles -GE 1000

Contoh 5: Dapatkan perintah berdasarkan properti

Contoh ini menunjukkan cara menulis perintah yang mengembalikan item yang benar atau salah atau memiliki nilai apa pun untuk properti tertentu. Setiap contoh menunjukkan format pernyataan blok skrip dan perbandingan untuk perintah tersebut.

Perintah memfilter inputnya dengan cara yang sama dan mengembalikan output yang sama. Hanya sintaksnya yang berbeda.

# Use Where-Object to get commands that have any value for the OutputType
# property of the command. This omits commands that do not have an OutputType
# property and those that have an OutputType property, but no property value.
Get-Command | Where-Object OutputType
Get-Command | Where-Object { $_.OutputType }

# Use Where-Object to get objects that are containers. This gets objects that
# have the **PSIsContainer** property with a value of $true and excludes all
# others.
Get-ChildItem | Where-Object PSIsContainer
Get-ChildItem | Where-Object { $_.PSIsContainer }

# Finally, use the -not operator (!) to get objects that are not containers.
# This gets objects that do have the **PSIsContainer** property and those
# that have a value of $false for the **PSIsContainer** property.
Get-ChildItem | Where-Object -Not PSIsContainer
Get-ChildItem | Where-Object { !$_.PSIsContainer }

Contoh 6: Menggunakan beberapa kondisi

Get-Module -ListAvailable | Where-Object {
    ($_.Name -notlike "Microsoft*" -and $_.Name -notlike "PS*") -and $_.HelpInfoUri
}

Contoh ini menunjukkan cara membuat Where-Object perintah dengan beberapa kondisi.

Perintah ini mendapatkan modul non-inti yang mendukung fitur Bantuan yang Dapat Diperbarui. Perintah menggunakan parameter ListAvailable cmdlet Get-Module untuk mendapatkan semua modul di komputer. Operator alur (|) mengirim modul ke Where-Object cmdlet, yang mendapatkan modul yang namanya tidak dimulai dengan Microsoft atau PS, dan memiliki nilai untuk properti HelpInfoURI , yang memberi tahu PowerShell tempat menemukan file bantuan yang diperbarui untuk modul. Operator -and logis menyambungkan pernyataan perbandingan.

Contohnya menggunakan format perintah blok skrip. Operator logis, seperti -and,-or, dan -not hanya valid dalam blokir skrip. Anda tidak dapat menggunakannya dalam format pernyataan perbandingan Where-Object perintah.

Untuk informasi selengkapnya tentang operator logis PowerShell, lihat about_Logical_Operators.
Untuk informasi selengkapnya tentang fitur Bantuan yang Dapat Diperbarui, lihat about_Updatable_Help.

Parameter

-CContains

Menunjukkan bahwa cmdlet ini mendapatkan objek dari koleksi jika nilai properti objek sama persis dengan nilai yang ditentukan. Operasi ini peka huruf besar/kecil.

Misalnya: Get-Process | Where-Object ProcessName -CContains "svchost"

CContains mengacu pada kumpulan nilai dan benar jika koleksi berisi item yang sama persis dengan nilai yang ditentukan. Jika input adalah objek tunggal, PowerShell mengonversinya menjadi kumpulan satu objek.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

CaseSensitiveContainsSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-CEQ

Menunjukkan bahwa cmdlet ini mendapatkan objek jika nilai properti sama dengan nilai yang ditentukan. Operasi ini peka huruf besar/kecil.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

CaseSensitiveEqualSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-CGE

Menunjukkan bahwa cmdlet ini mendapatkan objek jika nilai properti lebih besar dari atau sama dengan nilai yang ditentukan. Operasi ini peka huruf besar/kecil.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

CaseSensitiveGreaterOrEqualSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-CGT

Menunjukkan bahwa cmdlet ini mendapatkan objek jika nilai properti lebih besar dari nilai yang ditentukan. Operasi ini peka huruf besar/kecil.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

CaseSensitiveGreaterThanSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-CIn

Menunjukkan bahwa cmdlet ini mendapatkan objek jika nilai properti menyertakan nilai yang ditentukan. Operasi ini peka huruf besar/kecil.

Misalnya: Get-Process | Where-Object -Value "svchost" -CIn ProcessName

CIn menyerupai CContains, kecuali bahwa posisi properti dan nilai dibalik. Misalnya, pernyataan berikut keduanya benar.

"abc", "def" -CContains "abc"

"abc" -CIn "abc", "def"

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

CaseSensitiveInSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-CLE

Menunjukkan bahwa cmdlet ini mendapatkan objek jika nilai properti kurang dari atau sama dengan nilai yang ditentukan. Operasi ini peka huruf besar/kecil.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

CaseSensitiveLessOrEqualSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-CLike

Menunjukkan bahwa cmdlet ini mendapatkan objek jika nilai properti cocok dengan nilai yang menyertakan karakter kartubebas (*). Operasi ini peka huruf besar/kecil.

Misalnya: Get-Process | Where-Object ProcessName -CLike "*host"

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

CaseSensitiveLikeSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-CLT

Menunjukkan bahwa cmdlet ini mendapatkan objek jika nilai properti kurang dari nilai yang ditentukan. Operasi ini peka huruf besar/kecil.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

CaseSensitiveLessThanSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-CMatch

Menunjukkan bahwa cmdlet ini mendapatkan objek jika nilai properti cocok dengan ekspresi reguler yang ditentukan. Operasi ini peka huruf besar/kecil. Ketika input adalah objek tunggal, nilai yang cocok disimpan dalam $Matches variabel otomatis.

Misalnya: Get-Process | Where-Object ProcessName -CMatch "Shell"

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

CaseSensitiveMatchSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-CNE

Menunjukkan bahwa cmdlet ini mendapatkan objek jika nilai properti berbeda dari nilai yang ditentukan. Operasi ini peka huruf besar/kecil.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

CaseSensitiveNotEqualSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-CNotContains

Menunjukkan bahwa cmdlet ini mendapatkan objek jika nilai properti objek tidak sama persis dengan nilai yang ditentukan. Operasi ini peka huruf besar/kecil.

Misalnya: Get-Process | Where-Object ProcessName -CNotContains "svchost"

NotContains dan CNotContains mengacu pada kumpulan nilai dan benar ketika koleksi tidak berisi item apa pun yang sama persis dengan nilai yang ditentukan. Jika input adalah objek tunggal, PowerShell mengonversinya menjadi kumpulan satu objek.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

CaseSensitiveNotContainsSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-CNotIn

Menunjukkan bahwa cmdlet ini mendapatkan objek jika nilai properti tidak sama persis dengan nilai yang ditentukan. Operasi ini peka huruf besar/kecil.

Misalnya: Get-Process | Where-Object -Value "svchost" -CNotIn -Property ProcessName

Operator NotIn dan CNotIn menyerupai NotContains dan CNotContains, kecuali bahwa posisi properti dan nilai dibalik. Misalnya, pernyataan berikut benar.

"abc", "def" -CNotContains "Abc"

"abc" -CNotIn "Abc", "def"

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

CaseSensitiveNotInSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-CNotLike

Menunjukkan bahwa cmdlet ini mendapatkan objek jika nilai properti tidak cocok dengan nilai yang menyertakan karakter kartubebas. Operasi ini peka huruf besar/kecil.

Misalnya: Get-Process | Where-Object ProcessName -CNotLike "*host"

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

CaseSensitiveNotLikeSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-CNotMatch

Menunjukkan bahwa cmdlet ini mendapatkan objek jika nilai properti tidak cocok dengan ekspresi reguler yang ditentukan. Operasi ini peka huruf besar/kecil. Ketika input adalah objek tunggal, nilai yang cocok disimpan dalam $Matches variabel otomatis.

Misalnya: Get-Process | Where-Object ProcessName -CNotMatch "Shell"

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

CaseSensitiveNotMatchSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Contains

Menunjukkan bahwa cmdlet ini mendapatkan objek jika ada item dalam nilai properti objek yang sama persis dengan nilai yang ditentukan.

Misalnya: Get-Process | Where-Object ProcessName -Contains "Svchost"

Jika input adalah objek tunggal, PowerShell mengonversinya menjadi kumpulan satu objek.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	IContains

Kumpulan parameter

ContainsSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-EQ

Menunjukkan bahwa cmdlet ini mendapatkan objek jika nilai properti sama dengan nilai yang ditentukan.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	IEQ

Kumpulan parameter

EqualSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-FilterScript

Menentukan blok skrip yang digunakan untuk memfilter objek. Sertakan blok skrip dalam kurung kurawal ({}).

Nama parameter, FilterScript, bersifat opsional.

Properti parameter

Jenis:	ScriptBlock
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

ScriptBlockSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-GE

Menunjukkan bahwa cmdlet ini mendapatkan objek jika nilai properti lebih besar dari atau sama dengan nilai yang ditentukan.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	IGE

Kumpulan parameter

GreaterOrEqualSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-GT

Menunjukkan bahwa cmdlet ini mendapatkan objek jika nilai properti lebih besar dari nilai yang ditentukan.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	IGT

Kumpulan parameter

GreaterThanSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-In

Menunjukkan bahwa cmdlet ini mendapatkan objek jika nilai properti cocok dengan salah satu nilai yang ditentukan. Contohnya:

Get-Process | Where-Object -Property ProcessName -In -Value "Svchost", "TaskHost", "WsmProvHost"

Jika input adalah objek tunggal, PowerShell mengonversinya menjadi kumpulan satu objek.

Jika nilai properti objek adalah array, PowerShell menggunakan kesetaraan referensi untuk menentukan kecocokan. Where-Object mengembalikan objek hanya jika nilai parameter Properti dan nilai Nilai apa pun adalah instans objek yang sama.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	Iin

Kumpulan parameter

InSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-InputObject

Menentukan objek yang akan difilter. Anda juga dapat menyalurkan objek ke Where-Object.

Saat Anda menggunakan parameter InputObject dengan Where-Object, alih-alih hasil perintah pipa ke Where-Object, cmdlet memperlakukan InputObject sebagai satu objek. Ini benar bahkan jika nilainya adalah koleksi yang merupakan hasil dari perintah, seperti -InputObject (Get-Process).

Karena InputObject tidak dapat mengembalikan properti individual dari array atau kumpulan objek, kami sarankan, jika Anda menggunakan Where-Object untuk memfilter kumpulan objek untuk objek yang memiliki nilai tertentu dalam properti yang ditentukan, Anda gunakan Where-Object dalam alur, seperti yang ditunjukkan dalam contoh dalam topik ini.

Properti parameter

Jenis:	PSObject
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	True
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Is

Menunjukkan bahwa cmdlet ini mendapatkan objek jika nilai properti adalah instans dari jenis .NET yang ditentukan. Sertakan nama jenis dalam tanda kurung siku.

Misalnya: Get-Process | Where-Object StartTime -Is [datetime]

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

IsSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-IsNot

Menunjukkan bahwa cmdlet ini mendapatkan objek jika nilai properti bukan instans dari jenis .NET yang ditentukan.

Misalnya: Get-Process | where StartTime -IsNot [datetime]

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

IsNotSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-LE

Menunjukkan bahwa cmdlet ini mendapatkan objek jika nilai properti kurang dari atau sama dengan nilai yang ditentukan.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	ILE

Kumpulan parameter

LessOrEqualSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Like

Menunjukkan bahwa cmdlet ini mendapatkan objek jika nilai properti cocok dengan nilai yang menyertakan karakter kartubebas (*).

Misalnya: Get-Process | Where-Object ProcessName -Like "*host"

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	ILike

Kumpulan parameter

LikeSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-LT

Menunjukkan bahwa cmdlet ini mendapatkan objek jika nilai properti kurang dari nilai yang ditentukan.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	ILT

Kumpulan parameter

LessThanSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Match

Menunjukkan bahwa cmdlet ini mendapatkan objek jika nilai properti cocok dengan ekspresi reguler yang ditentukan. Ketika input adalah objek tunggal, nilai yang cocok disimpan dalam $Matches variabel otomatis.

Misalnya: Get-Process | Where-Object ProcessName -Match "shell"

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	IMatch

Kumpulan parameter

MatchSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-NE

Menunjukkan bahwa cmdlet ini mendapatkan objek jika nilai properti berbeda dari nilai yang ditentukan.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	INE

Kumpulan parameter

NotEqualSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Not

Menunjukkan bahwa cmdlet ini mendapatkan objek jika properti tidak ada atau memiliki nilai $null atau $false.

Misalnya: Get-Service | Where-Object -Not "DependentServices"

Parameter ini diperkenalkan di Windows PowerShell 6.1.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

Not

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-NotContains

Menunjukkan bahwa cmdlet ini mendapatkan objek jika tidak ada item dalam nilai properti yang sama persis dengan nilai yang ditentukan.

Misalnya: Get-Process | Where-Object ProcessName -NotContains "Svchost"

NotContains mengacu pada kumpulan nilai dan benar jika koleksi tidak berisi item apa pun yang sama persis dengan nilai yang ditentukan. Jika input adalah objek tunggal, PowerShell mengonversinya menjadi kumpulan satu objek.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	INotContains

Kumpulan parameter

NotContainsSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-NotIn

Menunjukkan bahwa cmdlet ini mendapatkan objek jika nilai properti tidak sama persis untuk salah satu nilai yang ditentukan.

Misalnya: Get-Process | Where-Object -Value "svchost" -NotIn -Property ProcessName

Jika nilai Nilai adalah objek tunggal, PowerShell mengonversinya menjadi kumpulan satu objek.

Jika nilai properti objek adalah array, PowerShell menggunakan kesetaraan referensi untuk menentukan kecocokan. Where-Object mengembalikan objek hanya jika nilai Properti dan nilai Nilai apa pun bukan instans objek yang sama.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	INotIn

Kumpulan parameter

NotInSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-NotLike

Menunjukkan bahwa cmdlet ini mendapatkan objek jika nilai properti tidak cocok dengan nilai yang menyertakan karakter kartubebas (*).

Misalnya: Get-Process | Where-Object ProcessName -NotLike "*host"

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	INotLike

Kumpulan parameter

NotLikeSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-NotMatch

Menunjukkan bahwa cmdlet ini mendapatkan objek ketika nilai properti tidak cocok dengan ekspresi reguler yang ditentukan. Ketika input adalah objek tunggal, nilai yang cocok disimpan dalam $Matches variabel otomatis.

Misalnya: Get-Process | Where-Object ProcessName -NotMatch "powershell"

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	INotMatch

Kumpulan parameter

NotMatchSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Property

Menentukan nama properti objek input. Properti harus berupa properti instans, bukan properti statis. Ini adalah parameter posisi, sehingga nama, Properti, bersifat opsional.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

EqualSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

LessOrEqualSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CaseSensitiveEqualSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

NotEqualSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CaseSensitiveNotEqualSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

GreaterThanSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CaseSensitiveGreaterThanSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

LessThanSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CaseSensitiveLessThanSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

GreaterOrEqualSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CaseSensitiveGreaterOrEqualSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CaseSensitiveLessOrEqualSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

LikeSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CaseSensitiveLikeSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

NotLikeSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CaseSensitiveNotLikeSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

MatchSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CaseSensitiveMatchSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

NotMatchSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CaseSensitiveNotMatchSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

ContainsSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CaseSensitiveContainsSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

NotContainsSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CaseSensitiveNotContainsSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

InSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CaseSensitiveInSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

NotInSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CaseSensitiveNotInSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

IsSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

IsNotSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

Not

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Value

Menentukan nilai properti. Nama parameter, Nilai, bersifat opsional. Parameter ini menerima karakter kartubebas saat digunakan dengan parameter perbandingan berikut:

CLike
CNotLike
Suka
Tidak Seperti

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	PSObject
Nilai default:	None
Mendukung wildcard:	True
DontShow:	False

Kumpulan parameter

EqualSet

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CaseSensitiveGreaterOrEqualSet

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CaseSensitiveEqualSet

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

NotEqualSet

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CaseSensitiveNotEqualSet

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

GreaterThanSet

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CaseSensitiveGreaterThanSet

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

LessThanSet

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CaseSensitiveLessThanSet

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

GreaterOrEqualSet

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

LessOrEqualSet

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CaseSensitiveLessOrEqualSet

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

LikeSet

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CaseSensitiveLikeSet

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

NotLikeSet

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CaseSensitiveNotLikeSet

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

MatchSet

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CaseSensitiveMatchSet

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

NotMatchSet

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CaseSensitiveNotMatchSet

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

ContainsSet

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CaseSensitiveContainsSet

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

NotContainsSet

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CaseSensitiveNotContainsSet

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

InSet

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CaseSensitiveInSet

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

NotInSet

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CaseSensitiveNotInSet

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

IsSet

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

IsNotSet

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

PSObject

Anda dapat menyalurkan objek apa pun ke cmdlet ini.

Output

Object

Cmdlet ini mengembalikan item yang dipilih dari set objek input.

Catatan

PowerShell menyertakan alias berikut untuk Where-Object:

Semua Platform:
- ?
- where

Mulai dari Windows PowerShell 4.0, Where dan ForEach metode ditambahkan untuk digunakan dengan koleksi.

Anda dapat membaca selengkapnya tentang metode ini di sini about_Arrays

Saran dan Komentar

Apakah halaman ini membantu?

Bagikan melalui

Where-Object

Sintaks

EqualSet (Default)

ScriptBlockSet

MatchSet

CaseSensitiveEqualSet

NotEqualSet

CaseSensitiveNotEqualSet

GreaterThanSet

CaseSensitiveGreaterThanSet

LessThanSet

CaseSensitiveLessThanSet

GreaterOrEqualSet

CaseSensitiveGreaterOrEqualSet

LessOrEqualSet

CaseSensitiveLessOrEqualSet

LikeSet

CaseSensitiveLikeSet

NotLikeSet

CaseSensitiveNotLikeSet

CaseSensitiveMatchSet

NotMatchSet

CaseSensitiveNotMatchSet

ContainsSet

CaseSensitiveContainsSet

NotContainsSet

CaseSensitiveNotContainsSet

InSet

CaseSensitiveInSet

NotInSet

CaseSensitiveNotInSet

IsSet

IsNotSet

Not

Deskripsi

Contoh

Contoh 1: Dapatkan layanan yang dihentikan

Contoh 2: Mendapatkan proses berdasarkan set kerja

Contoh 3: Dapatkan proses berdasarkan nama proses

Contoh 4: Gunakan format pernyataan perbandingan

Contoh 5: Dapatkan perintah berdasarkan properti

Contoh 6: Menggunakan beberapa kondisi

Parameter

-CContains

Properti parameter

Kumpulan parameter

-CEQ

Properti parameter

Kumpulan parameter

-CGE

Properti parameter

Kumpulan parameter

-CGT

Properti parameter

Kumpulan parameter

-CIn

Properti parameter

Kumpulan parameter

-CLE

Properti parameter

Kumpulan parameter

-CLike

Properti parameter

Kumpulan parameter

-CLT

Properti parameter

Kumpulan parameter

-CMatch

Properti parameter

Kumpulan parameter

-CNE

Properti parameter

Kumpulan parameter

-CNotContains

Properti parameter

Kumpulan parameter

-CNotIn

Properti parameter

Kumpulan parameter