Where-Object

Riferimento

Modulo:: Microsoft.PowerShell.Core

Seleziona gli oggetti da una raccolta in base ai valori delle proprietà.

Sintassi

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>]

Descrizione

Il cmdlet Where-Object seleziona gli oggetti con valori di proprietà specifici dall'insieme di oggetti passati. Ad esempio, è possibile usare il cmdlet Where-Object per selezionare i file creati dopo una determinata data, gli eventi con un ID specifico o i computer che usano una determinata versione di Windows.

A partire da Windows PowerShell 3.0, esistono due modi diversi per costruire un comando Where-Object.

blocco script. È possibile usare un blocco di script per specificare il nome della proprietà, un operatore di confronto e un valore della proprietà. Where-Object restituisce tutti gli oggetti per i quali l'istruzione del blocco di script è true.

Ad esempio, il comando seguente ottiene i processi nella classe di priorità Normal, ovvero elabora dove il valore della proprietà PriorityClass è uguale a Normal.

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

Tutti gli operatori di confronto di PowerShell sono validi nel formato del blocco di script. Per altre informazioni, vedere about_Comparison_Operators.
'istruzione Comparison. È anche possibile scrivere un'istruzione di confronto, molto più simile al linguaggio naturale. Le istruzioni di confronto sono state introdotte in Windows PowerShell 3.0.

Ad esempio, i comandi seguenti ottengono anche processi con una classe di priorità di Normal. Questi comandi sono equivalenti ed è possibile usarli in modo intercambiabile.

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

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

A partire da Windows PowerShell 3.0, Where-Object aggiunge operatori di confronto come parametri in un comando Where-Object. Se non specificato, tutti gli operatori non fanno distinzione tra maiuscole e minuscole. Prima di Windows PowerShell 3.0, gli operatori di confronto nel linguaggio PowerShell erano utilizzabili solo nei blocchi di script.

Quando si specifica un singolo Property per Where-Object, il cmdlet considera il valore della proprietà come espressione booleana. Quando il valore dell'Length della proprietà non è zero, l'espressione restituisce $true. Ad esempio: ('hi', '', 'there') | Where-Object Length

L'esempio precedente è funzionalmente equivalente a:

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

Per altre informazioni su come PowerShell valuta i valori booleani, vedere about_Booleans.

Esempio

Esempio 1: Ottenere i servizi arrestati

Questi comandi ottengono un elenco di tutti i servizi arrestati. La variabile automatica $_ rappresenta ogni oggetto passato al cmdlet Where-Object.

Il primo comando usa il formato del blocco di script, il secondo comando usa il formato dell'istruzione di confronto. I comandi filtrano i servizi nello stesso modo e restituiscono lo stesso output. Solo la sintassi è diversa.

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

Esempio 2: Ottenere processi basati sul working set

Questi comandi elencano i processi con un working set maggiore di 250 megabyte (MB). I comandi filtrano i processi allo stesso modo e restituiscono lo stesso output. Solo la sintassi è diversa.

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

Esempio 3: Ottenere processi in base al nome del processo

Questi comandi ottengono i processi con un valore ProcessName proprietà che inizia con la lettera p. L'operatore Match consente di usare corrispondenze di espressioni regolari.

I comandi filtrano i processi allo stesso modo e restituiscono lo stesso output. Solo la sintassi è diversa.

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

Esempio 4: Usare il formato dell'istruzione di confronto

In questo esempio viene illustrato come usare il nuovo formato di istruzione di confronto del cmdlet Where-Object.

Il primo comando usa il formato dell'istruzione di confronto. Non usa alias e include il nome per ogni parametro.

Il secondo comando è l'uso più naturale del formato del comando di confronto. Il comando sostituisce l'alias where per il nome del cmdlet Where-Object e omette tutti i nomi di parametro facoltativi.

I comandi filtrano i processi allo stesso modo e restituiscono lo stesso output. Solo la sintassi è diversa.

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

Esempio 5: Ottenere i comandi in base alle proprietà

In questo esempio viene illustrato come scrivere comandi che restituiscono elementi che sono true o false o hanno qualsiasi valore per una proprietà specificata. Ogni esempio mostra sia il blocco di script che i formati di istruzione di confronto per il comando .

I comandi filtrano l'input nello stesso modo e restituiscono lo stesso output. Solo la sintassi è diversa.

# 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 }

Esempio 6: Usare più condizioni

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

Questo esempio illustra come creare un comando Where-Object con più condizioni.

Questo comando ottiene moduli non principali che supportano la funzionalità Guida aggiornabile. Il comando usa il parametro ListAvailable del cmdlet Get-Module per ottenere tutti i moduli nel computer. Un operatore pipeline (|) invia i moduli al cmdlet Where-Object, che ottiene i moduli i cui nomi non iniziano con Microsoft o PSe hanno un valore per la proprietà HelpInfoURI, che indica a PowerShell dove trovare i file della Guida aggiornati per il modulo. L'operatore logico -and connette le istruzioni di confronto.

Nell'esempio viene usato il formato del comando del blocco di script. Gli operatori logici, ad esempio -and,-ore -not sono validi solo nei blocchi di script. Non è possibile usarli nel formato dell'istruzione di confronto di un comando Where-Object.

Per altre informazioni sugli operatori logici di PowerShell, vedere about_Logical_Operators.
Per altre informazioni sulla funzionalità Guida aggiornabile, vedere about_Updatable_Help.

Parametri

-CContains

Indica che questo cmdlet ottiene oggetti da una raccolta se il valore della proprietà dell'oggetto è una corrispondenza esatta per il valore specificato. Questa operazione fa distinzione tra maiuscole e minuscole.

Ad esempio: Get-Process | Where-Object ProcessName -CContains "svchost"

CContains fa riferimento a una raccolta di valori ed è true se la raccolta contiene un elemento che corrisponde esattamente al valore specificato. Se l'input è un singolo oggetto, PowerShell lo converte in una raccolta di un oggetto.

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-CEQ

Indica che questo cmdlet ottiene oggetti se il valore della proprietà è uguale al valore specificato. Questa operazione fa distinzione tra maiuscole e minuscole.

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-CGE

Indica che questo cmdlet ottiene oggetti se il valore della proprietà è maggiore o uguale al valore specificato. Questa operazione fa distinzione tra maiuscole e minuscole.

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-CGT

Indica che questo cmdlet ottiene oggetti se il valore della proprietà è maggiore del valore specificato. Questa operazione fa distinzione tra maiuscole e minuscole.

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-CIn

Indica che questo cmdlet ottiene oggetti se il valore della proprietà include il valore specificato. Questa operazione fa distinzione tra maiuscole e minuscole.

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

CIn è simile a CContains, ad eccezione del fatto che le posizioni di proprietà e valore vengono invertite. Ad esempio, le istruzioni seguenti sono entrambe true.

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

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

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-CLE

Indica che questo cmdlet ottiene oggetti se il valore della proprietà è minore o uguale al valore specificato. Questa operazione fa distinzione tra maiuscole e minuscole.

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-CLike

Indica che questo cmdlet ottiene oggetti se il valore della proprietà corrisponde a un valore che include caratteri jolly (*). Questa operazione fa distinzione tra maiuscole e minuscole.

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

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-CLT

Indica che questo cmdlet ottiene oggetti se il valore della proprietà è minore del valore specificato. Questa operazione fa distinzione tra maiuscole e minuscole.

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-CMatch

Indica che questo cmdlet ottiene oggetti se il valore della proprietà corrisponde all'espressione regolare specificata. Questa operazione fa distinzione tra maiuscole e minuscole. Quando l'input è un singolo oggetto, il valore corrispondente viene salvato nella variabile automatica $Matches.

Ad esempio: Get-Process | Where-Object ProcessName -CMatch "Shell"

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-CNE

Indica che questo cmdlet ottiene oggetti se il valore della proprietà è diverso dal valore specificato. Questa operazione fa distinzione tra maiuscole e minuscole.

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-CNotContains

Indica che questo cmdlet ottiene oggetti se il valore della proprietà dell'oggetto non corrisponde esattamente al valore specificato. Questa operazione fa distinzione tra maiuscole e minuscole.

Ad esempio: Get-Process | Where-Object ProcessName -CNotContains "svchost"

NotContains e CNotContains fare riferimento a una raccolta di valori e sono true quando l'insieme non contiene elementi che corrispondono esattamente al valore specificato. Se l'input è un singolo oggetto, PowerShell lo converte in una raccolta di un oggetto.

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-CNotIn

Indica che questo cmdlet ottiene oggetti se il valore della proprietà non corrisponde esattamente al valore specificato. Questa operazione fa distinzione tra maiuscole e minuscole.

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

gli operatori di NotIn e NotIn e Not In sono simili a NotContains e CNotContains, ad eccezione del fatto che le posizioni di proprietà e valore vengono invertite. Ad esempio, le istruzioni seguenti sono true.

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

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

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-CNotLike

Indica che questo cmdlet ottiene oggetti se il valore della proprietà non corrisponde a un valore che include caratteri jolly. Questa operazione fa distinzione tra maiuscole e minuscole.

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

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-CNotMatch

Indica che questo cmdlet ottiene oggetti se il valore della proprietà non corrisponde all'espressione regolare specificata. Questa operazione fa distinzione tra maiuscole e minuscole. Quando l'input è un singolo oggetto, il valore corrispondente viene salvato nella variabile automatica $Matches.

Ad esempio: Get-Process | Where-Object ProcessName -CNotMatch "Shell"

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Contains

Indica che questo cmdlet ottiene oggetti se un elemento nel valore della proprietà dell'oggetto è una corrispondenza esatta per il valore specificato.

Ad esempio: Get-Process | Where-Object ProcessName -Contains "Svchost"

Se l'input è un singolo oggetto, PowerShell lo converte in una raccolta di un oggetto.

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:	SwitchParameter
Alias:	IContains
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-EQ

Indica che questo cmdlet ottiene oggetti se il valore della proprietà è uguale al valore specificato.

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:	SwitchParameter
Alias:	IEQ
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-FilterScript

Specifica il blocco di script utilizzato per filtrare gli oggetti. Racchiudere il blocco di script tra parentesi graffe ({}).

Il nome del parametro, FilterScript, è facoltativo.

Tipo:	ScriptBlock
Posizione:	0
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-GE

Indica che questo cmdlet ottiene oggetti se il valore della proprietà è maggiore o uguale al valore specificato.

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:	SwitchParameter
Alias:	IGE
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-GT

Indica che questo cmdlet ottiene oggetti se il valore della proprietà è maggiore del valore specificato.

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:	SwitchParameter
Alias:	IGT
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-In

Indica che questo cmdlet ottiene oggetti se il valore della proprietà corrisponde a uno dei valori specificati. Per esempio:

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

Se l'input è un singolo oggetto, PowerShell lo converte in una raccolta di un oggetto.

Se il valore della proprietà di un oggetto è una matrice, PowerShell usa l'uguaglianza dei riferimenti per determinare una corrispondenza. Where-Object restituisce l'oggetto solo se il valore del parametro Property e qualsiasi valore di Value sono la stessa istanza di un oggetto .

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:	SwitchParameter
Alias:	IIn
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-InputObject

Specifica gli oggetti da filtrare. È anche possibile inviare tramite pipe gli oggetti a Where-Object.

Quando si usa il parametro InputObject con Where-Object, invece di eseguire il piping dei risultati del comando per Where-Object, il cmdlet considera InputObject come singolo oggetto. Questo vale anche se il valore è una raccolta che rappresenta il risultato di un comando, ad esempio -InputObject (Get-Process).

Poiché InputObject non può restituire singole proprietà da una matrice o da una raccolta di oggetti, è consigliabile, se si usa Where-Object per filtrare una raccolta di oggetti per gli oggetti con valori specifici nelle proprietà definite, è consigliabile usare Where-Object nella pipeline, come illustrato negli esempi di questo argomento.

Tipo:	PSObject
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-Is

Indica che questo cmdlet ottiene oggetti se il valore della proprietà è un'istanza del tipo .NET specificato. Racchiudere il nome del tipo tra parentesi quadre.

Ad esempio, Get-Process | Where-Object StartTime -Is [DateTime]

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-IsNot

Indica che questo cmdlet ottiene oggetti se il valore della proprietà non è un'istanza del tipo .NET specificato.

Ad esempio, Get-Process | where StartTime -IsNot [DateTime]

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-LE

Indica che questo cmdlet ottiene oggetti se il valore della proprietà è minore o uguale al valore specificato.

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:	SwitchParameter
Alias:	ILE
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Like

Indica che questo cmdlet ottiene oggetti se il valore della proprietà corrisponde a un valore che include caratteri jolly (*).

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

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:	SwitchParameter
Alias:	ILike
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-LT

Indica che questo cmdlet ottiene oggetti se il valore della proprietà è minore del valore specificato.

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:	SwitchParameter
Alias:	ILT
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Match

Indica che questo cmdlet ottiene oggetti se il valore della proprietà corrisponde all'espressione regolare specificata. Quando l'input è un singolo oggetto, il valore corrispondente viene salvato nella variabile automatica $Matches.

Ad esempio: Get-Process | Where-Object ProcessName -Match "shell"

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:	SwitchParameter
Alias:	IMatch
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-NE

Indica che questo cmdlet ottiene oggetti se il valore della proprietà è diverso dal valore specificato.

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:	SwitchParameter
Alias:	INE
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Not

Indica che questo cmdlet ottiene oggetti se la proprietà non esiste o ha un valore di $null o $false.

Ad esempio: Get-Service | Where-Object -Not "DependentServices"

Questo parametro è stato introdotto in Windows PowerShell 6.1.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-NotContains

Indica che questo cmdlet ottiene oggetti se nessuno degli elementi nel valore della proprietà è una corrispondenza esatta per il valore specificato.

Ad esempio: Get-Process | Where-Object ProcessName -NotContains "Svchost"

NotContains fa riferimento a una raccolta di valori ed è true se la raccolta non contiene elementi che corrispondono esattamente al valore specificato. Se l'input è un singolo oggetto, PowerShell lo converte in una raccolta di un oggetto.

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:	SwitchParameter
Alias:	INotContains
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-NotIn

Indica che questo cmdlet ottiene oggetti se il valore della proprietà non corrisponde esattamente a uno dei valori specificati.

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

Se il valore di Value è un singolo oggetto, PowerShell lo converte in una raccolta di un oggetto.

Se il valore della proprietà di un oggetto è una matrice, PowerShell usa l'uguaglianza dei riferimenti per determinare una corrispondenza. Where-Object restituisce l'oggetto solo se il valore di Property e qualsiasi valore di Value non sono la stessa istanza di un oggetto.

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:	SwitchParameter
Alias:	INotIn
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-NotLike

Indica che questo cmdlet ottiene oggetti se il valore della proprietà non corrisponde a un valore che include caratteri jolly (*).

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

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:	SwitchParameter
Alias:	INotLike
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-NotMatch

Indica che questo cmdlet ottiene oggetti quando il valore della proprietà non corrisponde all'espressione regolare specificata. Quando l'input è un singolo oggetto, il valore corrispondente viene salvato nella variabile automatica $Matches.

Ad esempio: Get-Process | Where-Object ProcessName -NotMatch "PowerShell"

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:	SwitchParameter
Alias:	INotMatch
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Property

Specifica il nome di una proprietà dell'oggetto di input. La proprietà deve essere una proprietà di istanza, non una proprietà statica. Si tratta di un parametro posizionale, quindi il nome, Property, è facoltativo.

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:	String
Posizione:	0
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Value

Specifica un valore della proprietà. Il nome del parametro, Valore, è facoltativo. Questo parametro accetta caratteri jolly quando vengono usati con i parametri di confronto seguenti:

CLike
CNotLike
Like
NotLike

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:	PSObject
Posizione:	1
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	True

Input

PSObject

È possibile inviare tramite pipe qualsiasi oggetto a questo cmdlet.

Output

Object

Questo cmdlet restituisce gli elementi selezionati dal set di oggetti di input.

Note

PowerShell include gli alias seguenti per Where-Object:

Tutte le piattaforme:
- ?
- where

A partire da Windows PowerShell 4.0, sono stati aggiunti metodi Where e ForEach per l'uso con le raccolte.

Altre informazioni su questi metodi sono disponibili qui about_arrays

Condividi tramite

Where-Object

Sintassi

Descrizione

Esempio

Esempio 1: Ottenere i servizi arrestati

Esempio 2: Ottenere processi basati sul working set

Esempio 3: Ottenere processi in base al nome del processo

Esempio 4: Usare il formato dell'istruzione di confronto

Esempio 5: Ottenere i comandi in base alle proprietà

Esempio 6: Usare più condizioni

Parametri

-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

Input

Output

Note

Collegamenti correlati

Risorse aggiuntive