Where-Object

參考

模組:: Microsoft.PowerShell.Core

根據對象的屬性值，從集合中選取物件。

Syntax

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Description

Cmdlet 會 Where-Object 從傳遞給它的物件集合中選取具有特定屬性值的物件。例如，您可以使用 Where-Object Cmdlet 來選取在特定日期之後建立的檔案、具有特定標識碼的事件，或是使用特定 Windows 版本的電腦。

從 Windows PowerShell 3.0 開始，有兩種不同的方法來建構 Where-Object 命令。

腳本區塊。您可以使用文稿區塊來指定屬性名稱、比較運算子和屬性值。 Where-Object 會傳回腳本區塊語句為 true 的所有物件。

例如，下列命令會取得優先順序類別中的 Normal 進程，也就是說，會處理 PriorityClass 屬性值等於 Normal的位置。

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

所有 PowerShell 比較運算子都以腳本區塊格式有效。如需詳細資訊，請參閱 about_Comparison_Operators。
比較語句。您也可以撰寫比較語句，這更像是自然語言。比較語句是在 Windows PowerShell 3.0 中引進的。

例如，下列命令也會取得優先順序類別 Normal為的進程。這些命令是相等的，而且您可以交替使用。

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

Get-Process | Where-Object PriorityClass -EQ "Normal"

從 Windows PowerShell 3.0 開始， Where-Object 將比較運算元新增為命令中的 Where-Object 參數。除非指定，否則所有運算子都不區分大小寫。在 Windows PowerShell 3.0 之前，PowerShell 語言中的比較運算符只能在腳本區塊中使用。

當您將單 一 PropertyWhere-Object提供給時，Cmdlet 會將屬性的值視為布爾表達式。當屬性值的 Length 不是零時，表示式會評估為 $true。例如：('hi', '', 'there') | Where-Object Length

上一個範例的功能相當於：

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

如需 PowerShell 如何評估布爾值的詳細資訊，請參閱 about_Booleans。

範例

範例 1：取得已停止的服務

這些命令會取得已停止的所有服務清單。自動 $_ 變數代表傳遞至 Where-Object Cmdlet 的每個物件。

第一個命令使用文本區塊格式，第二個命令會使用比較語句格式。命令會以相同的方式篩選服務，並傳回相同的輸出。只有語法不同。

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

範例 2：根據工作集取得進程

這些命令會列出工作集大於 250 MB （MB）的進程。命令會以相同方式篩選進程，並傳回相同的輸出。只有語法不同。

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

範例 3：根據進程名稱取得進程

這些命令會取得具有以字母 p開頭之 ProcessName 屬性值的進程。 Match 運算子可讓您使用正則表示式比對。

命令會以相同方式篩選進程，並傳回相同的輸出。只有語法不同。

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

範例 4：使用比較語句格式

此範例示範如何使用 Cmdlet 的新比較語句格式 Where-Object 。

第一個命令會使用比較語句格式。它不會使用任何別名，並包含每個參數的名稱。

第二個命令是比較命令格式更自然的用法。命令會 where 取代 Cmdlet 名稱的 Where-Object 別名，並省略所有選擇性參數名稱。

命令會以相同方式篩選進程，並傳回相同的輸出。只有語法不同。

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

範例 5：根據屬性取得命令

這個範例示範如何撰寫命令，以傳回 true 或 false 或具有指定屬性的任何值的專案。每個範例都會顯示命令的腳本區塊和比較語句格式。

命令會以相同的方式篩選其輸入，並傳回相同的輸出。只有語法不同。

# 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：使用多個條件

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

此範例示範如何建立 Where-Object 具有多個條件的命令。

此命令會取得支援可更新說明功能的非核心模組。此命令會使用 Cmdlet 的 Get-Module ListAvailable 參數來取得電腦上的所有模組。管線運算符（|）會將模組傳送至 Where-Object Cmdlet，此 Cmdlet 會取得名稱不是以 Microsoft 或 PS開頭的模組，並具有 HelpInfoURI 屬性的值，這會告訴 PowerShell 在何處尋找模組的更新說明檔。 -and邏輯運算子會連接比較語句。

此範例使用腳本區塊命令格式。邏輯運算符，例如 -and、-or 和 -not 只有在腳本區塊中才有效。您無法在命令的 Where-Object 比較語句格式中使用它們。

如需 PowerShell 邏輯運算子的詳細資訊，請參閱 about_Logical_Operators。
如需可更新說明功能的詳細資訊，請參閱 about_Updatable_Help。

參數

-CContains

指出如果對象的屬性值與指定的值完全相符，這個 Cmdlet 會從集合取得物件。此作業區分大小寫。

例如：Get-Process | Where-Object ProcessName -CContains "svchost"

CContains 是指值的集合，如果集合包含與指定值完全相符的專案，則為 true。如果輸入是單一物件，PowerShell 會將它轉換成一個物件的集合。

此參數是在 Windows PowerShell 3.0 中引進的。

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

-CEQ

指出如果屬性值與指定的值相同，這個 Cmdlet 會取得物件。此作業區分大小寫。

此參數是在 Windows PowerShell 3.0 中引進的。

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

-CGE

指出如果屬性值大於或等於指定的值，這個 Cmdlet 會取得物件。此作業區分大小寫。

此參數是在 Windows PowerShell 3.0 中引進的。

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

-CGT

指出如果屬性值大於指定的值，這個 Cmdlet 會取得物件。此作業區分大小寫。

此參數是在 Windows PowerShell 3.0 中引進的。

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

-CIn

指出如果屬性值包含指定的值，這個 Cmdlet 會取得物件。此作業區分大小寫。

例如：Get-Process | Where-Object -Value "svchost" -CIn ProcessName

CIn 類似於 CContains，不同之處在於屬性和值位置會反轉。例如，下列語句都是 true。

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

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

此參數是在 Windows PowerShell 3.0 中引進的。

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

-CLE

指出如果屬性值小於或等於指定的值，這個 Cmdlet 會取得物件。此作業區分大小寫。

此參數是在 Windows PowerShell 3.0 中引進的。

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

-CLike

指出如果屬性值符合包含通配符的值，*則這個 Cmdlet 會取得物件。此作業區分大小寫。

例如：Get-Process | Where-Object ProcessName -CLike "*host"

此參數是在 Windows PowerShell 3.0 中引進的。

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

-CLT

指出如果屬性值小於指定的值，這個 Cmdlet 會取得物件。此作業區分大小寫。

此參數是在 Windows PowerShell 3.0 中引進的。

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

-CMatch

指出如果屬性值符合指定的正則表達式，這個 Cmdlet 會取得物件。此作業區分大小寫。當輸入是單一物件時，相符的值會儲存在自動變數中 $Matches 。

例如：Get-Process | Where-Object ProcessName -CMatch "Shell"

此參數是在 Windows PowerShell 3.0 中引進的。

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

-CNE

指出如果屬性值與指定的值不同，這個 Cmdlet 會取得物件。此作業區分大小寫。

此參數是在 Windows PowerShell 3.0 中引進的。

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

-CNotContains

指出如果對象的屬性值與指定的值不完全相符，則這個 Cmdlet 會取得物件。此作業區分大小寫。

例如：Get-Process | Where-Object ProcessName -CNotContains "svchost"

NotContains 和 CNotContains 是指值的集合，而且當集合不包含與指定值完全相符的任何專案時，則為 true。如果輸入是單一物件，PowerShell 會將它轉換成一個物件的集合。

此參數是在 Windows PowerShell 3.0 中引進的。

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

-CNotIn

指出如果屬性值與指定的值不完全相符，則這個 Cmdlet 會取得物件。此作業區分大小寫。

例如：Get-Process | Where-Object -Value "svchost" -CNotIn -Property ProcessName

NotIn 和 CNotIn 運算符類似於 NotContains 和 CNotContains，不同之處在於屬性和值位置會反轉。例如，下列語句為 true。

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

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

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

-CNotLike

指出如果屬性值不符合包含通配符的值，這個 Cmdlet 會取得物件。此作業區分大小寫。

例如：Get-Process | Where-Object ProcessName -CNotLike "*host"

此參數是在 Windows PowerShell 3.0 中引進的。

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

-CNotMatch

指出如果屬性值不符合指定的正則表達式，這個 Cmdlet 會取得物件。此作業區分大小寫。當輸入是單一物件時，相符的值會儲存在自動變數中 $Matches 。

例如：Get-Process | Where-Object ProcessName -CNotMatch "Shell"

此參數是在 Windows PowerShell 3.0 中引進的。

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

-Contains

指出如果物件屬性值中的任何專案與指定值完全相符，這個 Cmdlet 會取得物件。

例如：Get-Process | Where-Object ProcessName -Contains "Svchost"

如果輸入是單一物件，PowerShell 會將它轉換成一個物件的集合。

此參數是在 Windows PowerShell 3.0 中引進的。

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

-EQ

指出如果屬性值與指定的值相同，這個 Cmdlet 會取得物件。

此參數是在 Windows PowerShell 3.0 中引進的。

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

-FilterScript

指定用來篩選物件的腳本區塊。以大括弧（{}）括住腳本區塊。

參數名稱 FilterScript 是選擇性的。

Type:	ScriptBlock
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-GE

指出如果屬性值大於或等於指定的值，這個 Cmdlet 會取得物件。

此參數是在 Windows PowerShell 3.0 中引進的。

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

-GT

指出如果屬性值大於指定的值，這個 Cmdlet 會取得物件。

此參數是在 Windows PowerShell 3.0 中引進的。

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

-In

指出如果屬性值符合任何指定的值，這個 Cmdlet 會取得物件。例如：

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

如果輸入是單一物件，PowerShell 會將它轉換成一個物件的集合。

如果對象的屬性值是陣列，PowerShell 會使用參考相等來判斷相符專案。 Where-Object只有當 Property 參數的值和 Value 的任何值是物件的相同實例時，才會傳回物件。

此參數是在 Windows PowerShell 3.0 中引進的。

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

-InputObject

指定要篩選的物件。您也可以使用管線將物件傳送至 Where-Object。

當您搭配 使用 InputObject 參數時Where-Object，Cmdlet 會將 InputObject 視為單一物件，而不是將命令結果Where-Object管線傳送至。即使值是命令的結果集合，也是如此，例如 -InputObject (Get-Process)。

由於 InputObject 無法從物件的陣列或集合傳回個別屬性，因此建議您， Where-Object 如果您使用篩選那些在定義屬性中具有特定值的物件集合，您可以在 Where-Object 管線中使用，如本主題中的範例所示。

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

-Is

指出如果屬性值是指定之 .NET 類型的實例，這個 Cmdlet 會取得物件。以方括弧括住類型名稱。

例如，Get-Process | Where-Object StartTime -Is [DateTime]

此參數是在 Windows PowerShell 3.0 中引進的。

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

-IsNot

指出如果屬性值不是指定之 .NET 類型的實例，這個 Cmdlet 會取得物件。

例如，Get-Process | where StartTime -IsNot [DateTime]

此參數是在 Windows PowerShell 3.0 中引進的。

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

-LE

指出如果屬性值小於或等於指定的值，這個 Cmdlet 會取得物件。

此參數是在 Windows PowerShell 3.0 中引進的。

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

-Like

指出如果屬性值符合包含通配符的值，*則這個 Cmdlet 會取得物件。

例如：Get-Process | Where-Object ProcessName -Like "*host"

此參數是在 Windows PowerShell 3.0 中引進的。

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

-LT

指出如果屬性值小於指定的值，這個 Cmdlet 會取得物件。

此參數是在 Windows PowerShell 3.0 中引進的。

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

-Match

指出如果屬性值符合指定的正則表達式，這個 Cmdlet 會取得物件。當輸入是單一物件時，相符的值會儲存在自動變數中 $Matches 。

例如：Get-Process | Where-Object ProcessName -Match "shell"

此參數是在 Windows PowerShell 3.0 中引進的。

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

-NE

指出如果屬性值與指定的值不同，這個 Cmdlet 會取得物件。

此參數是在 Windows PowerShell 3.0 中引進的。

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

-Not

指出這個 Cmdlet 如果屬性不存在或具有或 $false的值$null，則取得物件。

例如：Get-Service | Where-Object -Not "DependentServices"

此參數是在 Windows PowerShell 6.1 中引進的。

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

-NotContains

指出如果屬性值中沒有任何專案與指定值完全相符，則這個 Cmdlet 會取得物件。

例如：Get-Process | Where-Object ProcessName -NotContains "Svchost"

NotContains 是指值的集合，如果集合不包含與指定值完全相符的任何專案，則為 true。如果輸入是單一物件，PowerShell 會將它轉換成一個物件的集合。

此參數是在 Windows PowerShell 3.0 中引進的。

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

-NotIn

指出如果屬性值與任何指定值不完全相符，則這個 Cmdlet 會取得物件。

例如：Get-Process | Where-Object -Value "svchost" -NotIn -Property ProcessName

如果 Value 的值是單一物件，PowerShell 會將它轉換成一個物件的集合。

如果對象的屬性值是陣列，PowerShell 會使用參考相等來判斷相符專案。 Where-Object只有在 Property 的值和 Value 的任何值不是物件的相同實例時，才會傳回物件。

此參數是在 Windows PowerShell 3.0 中引進的。

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

-NotLike

指出如果屬性值不符合包含通配符的值，*則這個 Cmdlet 會取得物件。

例如：Get-Process | Where-Object ProcessName -NotLike "*host"

此參數是在 Windows PowerShell 3.0 中引進的。

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

-NotMatch

指出當屬性值不符合指定的正則表達式時，這個 Cmdlet 會取得物件。當輸入是單一物件時，相符的值會儲存在自動變數中 $Matches 。

例如：Get-Process | Where-Object ProcessName -NotMatch "PowerShell"

此參數是在 Windows PowerShell 3.0 中引進的。

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

-Property

指定物件屬性的名稱。參數名稱 Property 是選擇性的。

此參數是在 Windows PowerShell 3.0 中引進的。

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

-Value

指定屬性值。參數名稱 Value 是選擇性的。當搭配下列比較參數使用時，此參數會接受通配符：

CLike
CNotLike
Like
NotLike

此參數是在 Windows PowerShell 3.0 中引進的。

Type:	PSObject
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

輸入

PSObject

您可以使用管線將任何物件傳送至此 Cmdlet。

輸出

Object

此 Cmdlet 會從輸入物件集傳回選取的專案。

備註

PowerShell 包含下列的 Where-Object別名：

所有平臺：
- ?
- where

從 Windows PowerShell 4.0 開始， Where 已 ForEach 新增方法以搭配集合使用。

您可以在這裡深入了解這些方法about_arrays

Where-Object

Syntax

Description

範例

範例 1：取得已停止的服務

範例 2：根據工作集取得進程

範例 3：根據進程名稱取得進程

範例 4：使用比較語句格式

範例 5：根據屬性取得命令

範例 6：使用多個條件

參數

-CContains

-CEQ

-CGE

-CGT

-CIn

-CLE

-CLike

-CLT

-CMatch

-CNE

-CNotContains

-CNotIn

-CNotLike

-CNotMatch

-Contains

-EQ

-FilterScript

-GE

-GT

-In

-InputObject

-Is

-IsNot

-LE

-Like

-LT

-Match

-NE

-Not

-NotContains

-NotIn

-NotLike

-NotMatch

-Property

-Value

輸入

輸出

備註

相關連結

意見反應

其他資源