Where-Object
Objektumokat jelöl ki egy gyűjteményből a tulajdonságértékük alapján.
Syntax
EqualSet (Alapértelmezett)
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>]
Description
A Where-Object parancsmag olyan objektumokat jelöl ki, amelyek adott tulajdonságértékekkel rendelkeznek a neki átadott objektumok gyűjteményéből. A Where-Object parancsmaggal például kijelölheti azokat a fájlokat, amelyeket egy adott dátum, egy adott azonosítójú esemény vagy a Windows egy adott verzióját használó számítógépek hoztak létre.
A Windows PowerShell 3.0-tól kezdve két különböző módon hozhat létre Where-Object parancsokat.
szkriptblokk. Szkriptblokk használatával megadhatja a tulajdonság nevét, egy összehasonlító operátort és egy tulajdonságértéket.
Where-Objectvisszaadja az összes olyan objektumot, amelynek a szkriptblokk-utasítása igaz.Az alábbi parancs például a
Normalprioritási osztályban lévő folyamatokat, vagyis azokat a folyamatokat kapja meg, amelyeknél a PriorityClass tulajdonság értékeNormal.Get-Process | Where-Object {$_.PriorityClass -eq "Normal"}Minden PowerShell-összehasonlító operátor érvényes a szkriptblokk formátumában. További információkért lásd: about_Comparison_Operators.
Összehasonlító kimutatás. Összehasonlító utasítást is írhat, amely sokkal inkább hasonlít a természetes nyelvhez. Az összehasonlító utasítások a Windows PowerShell 3.0-ban lettek bevezetve.
Az alábbi parancsok például olyan folyamatokat is lekérnek, amelyek prioritási osztálya
Normal. Ezek a parancsok egyenértékűek, és felcserélhetők.Get-Process | Where-Object -Property PriorityClass -EQ -Value "Normal"Get-Process | Where-Object PriorityClass -EQ "Normal"A Windows PowerShell 3.0-tól kezdve
Where-Objectösszehasonlító operátorokat ad hozzá paraméterekként egyWhere-Objectparancsban. Ha nincs megadva, minden operátor érzéketlen a kis- és nagybetűk között. A Windows PowerShell 3.0 előtt a PowerShell nyelv összehasonlító operátorai csak szkriptblokkokban voltak használhatóak.
Ha egyetlen tulajdonságotWhere-Objectad meg, a parancsmag logikai kifejezésként kezeli a tulajdonság értékét. Ha a tulajdonság Hossz értéke nem nulla, a kifejezés a következő lesz $true: . Például: ('hi', '', 'there') | Where-Object Length
Az előző példa funkcionálisan egyenértékű a következő értékével:
('hi', '', 'there') | Where-Object Length -GT 0('hi', '', 'there') | Where-Object { $_.Length -gt 0 }
További információ a PowerShell logikai értékek kiértékelésének módjáról: about_Booleans.
Példák
1. példa: Leállított szolgáltatások lekérése
Ezek a parancsok lekérik a leállított szolgáltatások listáját. A $_ automatikus változó a Where-Object parancsmagnak átadott összes objektumot jelöli.
Az első parancs a szkriptblokk formátumát használja, a második parancs pedig az összehasonlító utasítás formátumát. A parancsok ugyanúgy szűrik a szolgáltatásokat, és ugyanazt a kimenetet adják vissza. Csak a szintaxis különbözik.
Get-Service | Where-Object { $_.Status -eq "Stopped" }
Get-Service | Where-Object Status -EQ "Stopped"
2. példa: Folyamatok lekérése munkakészlet alapján
Ezek a parancsok felsorolják a 250 megabájtnál (MB) nagyobb munkakészlettel rendelkező folyamatokat. A parancsok ugyanúgy szűrik a folyamatokat, és ugyanazt a kimenetet adják vissza. Csak a szintaxis különbözik.
Get-Process | Where-Object { $_.WorkingSet -GT 250MB }
Get-Process | Where-Object WorkingSet -GT 250MB
3. példa: Folyamatok lekérése folyamatnév alapján
Ezek a parancsok a ProcessName tulajdonságértékkel rendelkező folyamatokat kapják meg, amelyek a betűvel pkezdődnek. A Egyezés operátorral normál kifejezésegyezéseket használhat.
A parancsok ugyanúgy szűrik a folyamatokat, és ugyanazt a kimenetet adják vissza. Csak a szintaxis különbözik.
Get-Process | Where-Object { $_.ProcessName -Match "^p.*" }
Get-Process | Where-Object ProcessName -Match "^p.*"
4. példa: Az összehasonlító utasítás formátumának használata
Ez a példa bemutatja, hogyan használható a Where-Object parancsmag új összehasonlító utasításformátuma.
Az első parancs az összehasonlító utasítás formátumát használja. Nem használ aliasokat, és minden paraméter nevét tartalmazza.
A második parancs az összehasonlító parancs formátumának természetesebb használata. A parancs a where parancsmag nevének Where-Object aliasát helyettesíti, és kihagyja az összes választható paraméternevet.
A parancsok ugyanúgy szűrik a folyamatokat, és ugyanazt a kimenetet adják vissza. Csak a szintaxis különbözik.
Get-Process | Where-Object -Property Handles -GE -Value 1000
Get-Process | where Handles -GE 1000
5. példa: Parancsok lekérése tulajdonságok alapján
Ez a példa bemutatja, hogyan írhat olyan parancsokat, amelyek igaz vagy hamis elemeket adnak vissza, vagy amelyek egy adott tulajdonsághoz bármilyen értékkel rendelkeznek. Mindegyik példa a parancs szkriptblokk- és összehasonlító utasításformátumát mutatja be.
A parancsok ugyanúgy szűrik a bemenetüket, és ugyanazt a kimenetet adják vissza. Csak a szintaxis különbözik.
# 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 }
6. példa: Több feltétel használata
Get-Module -ListAvailable | Where-Object {
($_.Name -notlike "Microsoft*" -and $_.Name -notlike "PS*") -and $_.HelpInfoUri
}
Ez a példa bemutatja, hogyan hozhat létre Where-Object parancsokat több feltétellel.
Ez a parancs nem magos modulokat kap, amelyek támogatják az Frissíthető súgó funkciót. A parancs a parancsmag Get-Module paraméterét használja a számítógép összes moduljának lekéréséhez. A folyamatüzemeltető (|) elküldi a modulokat a Where-Object parancsmagnak, amely lekéri azokat a modulokat, amelyeknek a neve nem kezdődik, Microsoft vagy PSa HelpInfoURI tulajdonság értéke jelzi a PowerShellnek, hogy hol találhatók a modul frissített súgófájljai. A -and logikai operátor összekapcsolja az összehasonlítási utasításokat.
A példa a szkriptblokk parancsformátumát használja. A logikai operátorok, például -and,-orés -not csak szkriptblokkokban érvényesek. Nem használhatja őket Where-Object parancsok összehasonlító utasításformátumában.
- További információ a PowerShell logikai operátorairól: about_Logical_Operators.
- Az Frissíthető súgó funkcióval kapcsolatos további információkért lásd: about_Updatable_Help.
Paraméterek
-CContains
Azt jelzi, hogy ez a parancsmag objektumokat kér le egy gyűjteményből, ha az objektum tulajdonságértéke pontosan megegyezik a megadott értékkel. Ez a művelet megkülönbözteti a kis- és nagybetűk megkülönböztetettségét.
Például: Get-Process | Where-Object ProcessName -CContains "svchost"
A CContains értékgyűjteményre hivatkozik, és igaz, ha a gyűjtemény olyan elemet tartalmaz, amely pontosan egyezik a megadott értékkel. Ha a bemenet egyetlen objektum, a PowerShell egy objektum gyűjteményét alakítja át.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
CaseSensitiveContainsSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-CEQ
Azt jelzi, hogy ez a parancsmag objektumokat kap, ha a tulajdonság értéke megegyezik a megadott értékkel. Ez a művelet megkülönbözteti a kis- és nagybetűk megkülönböztetettségét.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
CaseSensitiveEqualSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-CGE
Azt jelzi, hogy ez a parancsmag objektumokat kap, ha a tulajdonság értéke nagyobb vagy egyenlő a megadott értékkel. Ez a művelet megkülönbözteti a kis- és nagybetűk megkülönböztetettségét.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
CaseSensitiveGreaterOrEqualSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-CGT
Azt jelzi, hogy ez a parancsmag objektumokat kap, ha a tulajdonság értéke nagyobb a megadott értéknél. Ez a művelet megkülönbözteti a kis- és nagybetűk megkülönböztetettségét.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
CaseSensitiveGreaterThanSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-CIn
Azt jelzi, hogy ez a parancsmag objektumokat kap, ha a tulajdonság értéke tartalmazza a megadott értéket. Ez a művelet megkülönbözteti a kis- és nagybetűk megkülönböztetettségét.
Például: Get-Process | Where-Object -Value "svchost" -CIn ProcessName
A CIn a CContainshoz hasonlít, azzal a kivételsel, hogy a tulajdonság- és értékpozíciók fordítottak. Az alábbi állítások például mind igazak.
"abc", "def" -CContains "abc"
"abc" -CIn "abc", "def"
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
CaseSensitiveInSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-CLE
Azt jelzi, hogy ez a parancsmag objektumokat kap, ha a tulajdonság értéke kisebb vagy egyenlő a megadott értéknél. Ez a művelet megkülönbözteti a kis- és nagybetűk megkülönböztetettségét.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
CaseSensitiveLessOrEqualSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-CLike
Azt jelzi, hogy ez a parancsmag objektumokat kap, ha a tulajdonság értéke egyezik egy helyettesítő karaktereket (*) tartalmazó értékkel. Ez a művelet megkülönbözteti a kis- és nagybetűk megkülönböztetettségét.
Például: Get-Process | Where-Object ProcessName -CLike "*host"
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
CaseSensitiveLikeSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-CLT
Azt jelzi, hogy ez a parancsmag objektumokat kap, ha a tulajdonság értéke kisebb a megadott értéknél. Ez a művelet megkülönbözteti a kis- és nagybetűk megkülönböztetettségét.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
CaseSensitiveLessThanSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-CMatch
Azt jelzi, hogy ez a parancsmag objektumokat kap, ha a tulajdonság értéke megegyezik a megadott reguláris kifejezéssel. Ez a művelet megkülönbözteti a kis- és nagybetűk megkülönböztetettségét. Ha a bemenet egyetlen objektum, a rendszer menti a megfeleltetett értéket az $Matches automatikus változóba.
Például: Get-Process | Where-Object ProcessName -CMatch "Shell"
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
CaseSensitiveMatchSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-CNE
Azt jelzi, hogy ez a parancsmag objektumokat kap, ha a tulajdonság értéke eltér a megadott értékétől. Ez a művelet megkülönbözteti a kis- és nagybetűk megkülönböztetettségét.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
CaseSensitiveNotEqualSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-CNotContains
Azt jelzi, hogy ez a parancsmag akkor kap objektumokat, ha az objektum tulajdonságértéke nem egyezik meg pontosan a megadott értékkel. Ez a művelet megkülönbözteti a kis- és nagybetűk megkülönböztetettségét.
Például: Get-Process | Where-Object ProcessName -CNotContains "svchost"
A NotContains és a CNotContains értékgyűjteményre hivatkozik, és igaz, ha a gyűjtemény nem tartalmaz olyan elemeket, amelyek pontosan egyeznek a megadott értékkel. Ha a bemenet egyetlen objektum, a PowerShell egy objektum gyűjteményét alakítja át.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
CaseSensitiveNotContainsSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-CNotIn
Azt jelzi, hogy ez a parancsmag objektumokat kap, ha a tulajdonság értéke nem egyezik meg pontosan a megadott értékkel. Ez a művelet megkülönbözteti a kis- és nagybetűk megkülönböztetettségét.
Például: Get-Process | Where-Object -Value "svchost" -CNotIn -Property ProcessName
A NotIn és a CNotIn operátorok a NotContainsra és a CNotContainsra hasonlítanak, azzal a kivételsel, hogy a tulajdonság- és értékpozíciók fordítottak. Például az alábbi állítások igazak.
"abc", "def" -CNotContains "Abc"
"abc" -CNotIn "Abc", "def"
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
CaseSensitiveNotInSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-CNotLike
Azt jelzi, hogy ez a parancsmag objektumokat kap, ha a tulajdonság értéke nem egyezik meg a helyettesítő karaktereket tartalmazó értékkel. Ez a művelet megkülönbözteti a kis- és nagybetűk megkülönböztetettségét.
Például: Get-Process | Where-Object ProcessName -CNotLike "*host"
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
CaseSensitiveNotLikeSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-CNotMatch
Azt jelzi, hogy ez a parancsmag objektumokat kap, ha a tulajdonság értéke nem egyezik a megadott reguláris kifejezéssel. Ez a művelet megkülönbözteti a kis- és nagybetűk megkülönböztetettségét. Ha a bemenet egyetlen objektum, a rendszer menti a megfeleltetett értéket az $Matches automatikus változóba.
Például: Get-Process | Where-Object ProcessName -CNotMatch "Shell"
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
CaseSensitiveNotMatchSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Contains
Azt jelzi, hogy ez a parancsmag objektumokat kap, ha az objektum tulajdonságértékének bármely eleme pontosan egyezik a megadott értékkel.
Például: Get-Process | Where-Object ProcessName -Contains "Svchost"
Ha a bemenet egyetlen objektum, a PowerShell egy objektum gyűjteményét alakítja át.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | IContains |
Paraméterkészletek
ContainsSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-EQ
Azt jelzi, hogy ez a parancsmag objektumokat kap, ha a tulajdonság értéke megegyezik a megadott értékkel.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | IEQ |
Paraméterkészletek
EqualSet
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-FilterScript
Megadja az objektumok szűréséhez használt szkriptblokkot. Csatolja a szkriptblokkot kapcsos zárójelekbe ({}).
A FilterScript paraméternév megadása nem kötelező.
Paramétertulajdonságok
| Típus: | ScriptBlock |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
ScriptBlockSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-GE
Azt jelzi, hogy ez a parancsmag objektumokat kap, ha a tulajdonság értéke nagyobb vagy egyenlő a megadott értékkel.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | IGE |
Paraméterkészletek
GreaterOrEqualSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-GT
Azt jelzi, hogy ez a parancsmag objektumokat kap, ha a tulajdonság értéke nagyobb a megadott értéknél.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | IGT |
Paraméterkészletek
GreaterThanSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-In
Azt jelzi, hogy ez a parancsmag objektumokat kap, ha a tulajdonság értéke megfelel valamelyik megadott értéknek. Például:
Get-Process | Where-Object -Property ProcessName -in -Value "Svchost", "TaskHost", "WsmProvHost"
Ha a bemenet egyetlen objektum, a PowerShell egy objektum gyűjteményét alakítja át.
Ha egy objektum tulajdonságértéke tömb, a PowerShell hivatkozási egyenlőséget használ egyezés meghatározásához.
Where-Object Az objektumot csak akkor adja vissza, ha a Tulajdonság paraméter értéke és az Érték bármely értéke megegyezik egy objektum példányával.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Iin |
Paraméterkészletek
InSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-InputObject
Megadja a szűrni kívánt objektumokat. Az objektumokat Where-Objectis becsúszthatja.
Amikor az InputObject paramétert Where-Objecthasználja a parancsok eredményeinek Where-Objectpipálása helyett, a parancsmag egyetlen objektumként kezeli az InputObjectet . Ez akkor is igaz, ha az érték olyan gyűjtemény, amely egy parancs, például -InputObject (Get-Process)eredménye.
Mivel az InputObject nem tud egyedi tulajdonságokat visszaadni egy tömbből vagy objektumgyűjteményből, javasoljuk, hogy ha olyan objektumok gyűjteményét szeretné Where-Object szűrni, amelyek meghatározott tulajdonságokban meghatározott értékekkel rendelkeznek, használja Where-Object a folyamatot a jelen témakör példáiban látható módon.
Paramétertulajdonságok
| Típus: | PSObject |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Is
Azt jelzi, hogy ez a parancsmag objektumokat kap, ha a tulajdonság értéke a megadott .NET-típus egy példánya. A típusnevet szögletes zárójelek közé kell foglalni.
Például: Get-Process | Where-Object StartTime -Is [DateTime]
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
IsSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-IsNot
Azt jelzi, hogy ez a parancsmag objektumokat kap, ha a tulajdonság értéke nem a megadott .NET-típus példánya.
Például: Get-Process | where StartTime -IsNot [DateTime]
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
IsNotSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-LE
Azt jelzi, hogy ez a parancsmag objektumokat kap, ha a tulajdonság értéke kisebb vagy egyenlő a megadott értéknél.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | ILE |
Paraméterkészletek
LessOrEqualSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Like
Azt jelzi, hogy ez a parancsmag objektumokat kap, ha a tulajdonság értéke egyezik egy helyettesítő karaktereket (*) tartalmazó értékkel.
Például: Get-Process | Where-Object ProcessName -Like "*host"
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | ILike |
Paraméterkészletek
LikeSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-LT
Azt jelzi, hogy ez a parancsmag objektumokat kap, ha a tulajdonság értéke kisebb a megadott értéknél.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | vezetett tréning |
Paraméterkészletek
LessThanSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Match
Azt jelzi, hogy ez a parancsmag objektumokat kap, ha a tulajdonság értéke megegyezik a megadott reguláris kifejezéssel. Ha a bemenet egyetlen objektum, a rendszer menti a megfeleltetett értéket az $Matches automatikus változóba.
Például: Get-Process | Where-Object ProcessName -Match "shell"
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | IMatch |
Paraméterkészletek
MatchSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-NE
Azt jelzi, hogy ez a parancsmag objektumokat kap, ha a tulajdonság értéke eltér a megadott értékétől.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | INE |
Paraméterkészletek
NotEqualSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Not
Azt jelzi, hogy ez a parancsmag objektumokat kap, ha a tulajdonság nem létezik, vagy $null vagy $falseértékkel rendelkezik.
Például: Get-Service | Where-Object -Not "DependentServices"
Ez a paraméter a Windows PowerShell 6.1-ben lett bevezetve.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
Not
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-NotContains
Azt jelzi, hogy ez a parancsmag objektumokat kap, ha a tulajdonságérték egyik eleme sem felel meg pontosan a megadott értéknek.
Például: Get-Process | Where-Object ProcessName -NotContains "Svchost"
A NotContains értékgyűjteményre hivatkozik, és igaz, ha a gyűjtemény nem tartalmaz olyan elemeket, amelyek pontosan egyeznek a megadott értékkel. Ha a bemenet egyetlen objektum, a PowerShell egy objektum gyűjteményét alakítja át.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | INotContains |
Paraméterkészletek
NotContainsSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-NotIn
Azt jelzi, hogy ez a parancsmag objektumokat kap, ha a tulajdonság értéke nem egyezik meg a megadott értékek egyikével sem.
Például: Get-Process | Where-Object -Value "svchost" -NotIn -Property ProcessName
Ha az Érték érték egyetlen objektum, a PowerShell egy objektum gyűjteményét alakítja át.
Ha egy objektum tulajdonságértéke tömb, a PowerShell hivatkozási egyenlőséget használ egyezés meghatározásához.
Where-Object Az objektumot csak akkor adja vissza, ha a Tulajdonság és az Érték érték nem azonos az objektum példányával.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | INotIn |
Paraméterkészletek
NotInSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-NotLike
Azt jelzi, hogy ez a parancsmag objektumokat kap, ha a tulajdonság értéke nem egyezik meg a helyettesítő karaktereket (*) tartalmazó értékkel.
Például: Get-Process | Where-Object ProcessName -NotLike "*host"
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | INotLike |
Paraméterkészletek
NotLikeSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-NotMatch
Azt jelzi, hogy ez a parancsmag akkor kap objektumokat, ha a tulajdonság értéke nem egyezik meg a megadott reguláris kifejezéssel. Ha a bemenet egyetlen objektum, a rendszer menti a megfeleltetett értéket az $Matches automatikus változóba.
Például: Get-Process | Where-Object ProcessName -NotMatch "PowerShell"
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | INotMatch |
Paraméterkészletek
NotMatchSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Property
Megadja a bemeneti objektum egyik tulajdonságának nevét. A tulajdonságnak példánytulajdonságnak kell lennie, nem statikus tulajdonságnak. Ez egy pozícióparaméter, ezért a tulajdonság neve nem kötelező.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
EqualSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
LessOrEqualSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CaseSensitiveEqualSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
NotEqualSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CaseSensitiveNotEqualSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
GreaterThanSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CaseSensitiveGreaterThanSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
LessThanSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CaseSensitiveLessThanSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
GreaterOrEqualSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CaseSensitiveGreaterOrEqualSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CaseSensitiveLessOrEqualSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
LikeSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CaseSensitiveLikeSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
NotLikeSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CaseSensitiveNotLikeSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
MatchSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CaseSensitiveMatchSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
NotMatchSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CaseSensitiveNotMatchSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
ContainsSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CaseSensitiveContainsSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
NotContainsSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CaseSensitiveNotContainsSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
InSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CaseSensitiveInSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
NotInSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CaseSensitiveNotInSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
IsSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
IsNotSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
Not
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Value
Tulajdonságértéket ad meg. Az Érték paraméternév megadása nem kötelező. Ez a paraméter helyettesítő karaktereket fogad el, ha az alábbi összehasonlító paraméterekkel használja:
- CLike
- CNotLike
- Like
- Nem tetszik
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | PSObject |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
EqualSet
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CaseSensitiveGreaterOrEqualSet
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CaseSensitiveEqualSet
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
NotEqualSet
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CaseSensitiveNotEqualSet
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
GreaterThanSet
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CaseSensitiveGreaterThanSet
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
LessThanSet
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CaseSensitiveLessThanSet
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
GreaterOrEqualSet
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
LessOrEqualSet
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CaseSensitiveLessOrEqualSet
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
LikeSet
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CaseSensitiveLikeSet
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
NotLikeSet
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CaseSensitiveNotLikeSet
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
MatchSet
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CaseSensitiveMatchSet
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
NotMatchSet
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CaseSensitiveNotMatchSet
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
ContainsSet
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CaseSensitiveContainsSet
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
NotContainsSet
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CaseSensitiveNotContainsSet
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
InSet
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CaseSensitiveInSet
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
NotInSet
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CaseSensitiveNotInSet
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
IsSet
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
IsNotSet
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
PSObject
A parancsmaghoz bármilyen objektumot csövezhet.
Kimenetek
Object
Ez a parancsmag a bemeneti objektumkészlet kijelölt elemeit adja vissza.
Jegyzetek
A PowerShell a következő aliasokat tartalmazza Where-Object:
- Minden platform:
?where
A Windows PowerShell 4.0-tól kezdve Where és ForEach metódusok lettek hozzáadva a gyűjteményekhez való használatra.
Ezekről a módszerekről itt olvashat bővebben about_arrays