Where-Object

Syntaxe

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

Description

L’applet Where-Object de commande sélectionne les objets qui ont des valeurs de propriété particulières dans la collection d’objets qui lui sont transmis. Par exemple, vous pouvez utiliser l’applet Where-Object de commande pour sélectionner des fichiers créés après une certaine date, des événements avec un ID particulier ou des ordinateurs qui utilisent une version particulière de Windows.

À compter de Windows PowerShell 3.0, il existe deux façons différentes de construire une Where-Object commande.

• Bloc de script. Vous pouvez utiliser un bloc de script pour spécifier le nom de propriété, un opérateur de comparaison et une valeur de propriété. Where-Object retourne tous les objets pour lesquels l’instruction de bloc de script est vraie.

  Par exemple, la commande suivante obtient des processus dans la Normal classe de priorité, autrement dit, traite la valeur de la propriété PriorityClass égale Normal.

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

  Tous les opérateurs de comparaison PowerShell sont valides au format de bloc de script. Pour plus d’informations, consultez about_Comparison_Operators.

• Instruction de comparaison. Vous pouvez également écrire une instruction de comparaison, laquelle se rapproche beaucoup plus du langage naturel. Les instructions de comparaison ont été introduites dans Windows PowerShell 3.0.

  Par exemple, les commandes suivantes obtiennent également des processus qui ont une classe de Normalpriorité . Ces commandes sont équivalentes et vous pouvez les utiliser de manière interchangeable.

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

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

  À compter de Windows PowerShell 3.0, Where-Object ajoute des opérateurs de comparaison en tant que paramètres dans une Where-Object commande. Sauf indication contraire, tous les opérateurs respectent la casse. Avant Windows PowerShell 3.0, les opérateurs de comparaison dans le langage PowerShell n’étaient utilisables que dans les blocs de script.

Lorsque vous fournissez une propriété unique, Where-Objectl’applet de commande traite la valeur de la propriété comme une expression booléenne. Lorsque la valeur de la longueur de la propriété n’est pas égale à $truezéro, l’expression prend la valeur . Par exemple : ('hi', '', 'there') | Where-Object Length

L’exemple précédent est fonctionnellement équivalent à :

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

Pour plus d’informations sur la façon dont PowerShell évalue les valeurs booléennes, consultez about_Booleans.

Exemples

Exemple 1 : Obtenir les services arrêtés

Ces commandes obtiennent la liste de tous les services arrêtés. La $_ variable automatique représente chaque objet passé à l’applet Where-Object de commande.

La première commande utilise le format de bloc de script, la deuxième commande utilise le format d’instruction de comparaison. Les commandes filtrent les services de la même façon et retournent la même sortie. Seule la syntaxe est différente.

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

Exemple 2 : Obtenir des processus en fonction du jeu de travail

Ces commandes répertorient les processus dont le jeu de travail est supérieur à 250 mégaoctets (Mo). Les commandes filtrent les processus de la même façon et retournent la même sortie. Seule la syntaxe est différente.

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

Exemple 3 : Obtenir des processus en fonction du nom du processus

Ces commandes obtiennent les processus qui ont une valeur de propriété ProcessName qui commence par la lettre p. L’opérateur Match vous permet d’utiliser des correspondances d’expression régulière.

Les commandes filtrent les processus de la même façon et retournent la même sortie. Seule la syntaxe est différente.

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

Exemple 4 : Utiliser le format d’instruction de comparaison

Cet exemple montre comment utiliser le nouveau format d’instruction de comparaison de l’applet Where-Object de commande.

La première commande utilise le format d'instruction de comparaison. Il n’utilise pas d’alias et inclut le nom de chaque paramètre.

La deuxième commande représente l'utilisation la plus naturelle du format de commande de comparaison. La commande remplace l’alias where du nom de l’applet Where-Object de commande et omet tous les noms de paramètres facultatifs.

Les commandes filtrent les processus de la même façon et retournent la même sortie. Seule la syntaxe est différente.

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

Exemple 5 : Obtenir des commandes en fonction des propriétés

Cet exemple montre comment écrire des commandes qui retournent des éléments ayant la valeur true ou false, ou ayant une valeur correspondant à une propriété spécifique. Chaque exemple montre les formats de bloc de script et d’instruction de comparaison pour la commande.

Les commandes filtrent leur entrée de la même façon et retournent la même sortie. Seule la syntaxe est différente.

# 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 { !$_.PSIsContainer }
# You cannot use the -not operator (!) in the comparison statement format
# of the command.
Get-ChildItem | Where-Object PSIsContainer -eq $False

Exemple 6 : Utiliser plusieurs conditions

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

Cet exemple montre comment créer une Where-Object commande avec plusieurs conditions.

Cette commande obtient les modules qui ne sont pas des modules de base et qui prennent en charge la fonctionnalité d'aide actualisable. La commande utilise le paramètre ListAvailable de l’applet Get-Module de commande pour obtenir tous les modules sur l’ordinateur. Un opérateur de pipeline (|) envoie les modules à l’applet Where-Object de commande, qui obtient les modules dont les noms ne commencent Microsoft pas ou PSqui ont une valeur pour la propriété HelpInfoURI , qui indique à PowerShell où trouver les fichiers d’aide mis à jour pour le module. L’opérateur -and logique connecte les instructions de comparaison.

L'exemple utilise le format de commande de bloc de script. Les opérateurs logiques, tels que -and,-or, sont -not valides uniquement dans les blocs de script. Vous ne pouvez pas les utiliser dans le format d’instruction de comparaison d’une Where-Object commande.

• Pour plus d’informations sur les opérateurs logiques PowerShell, consultez about_Logical_Operators.
• Pour plus d’informations sur la fonctionnalité d’aide pouvant être mise à jour, consultez about_Updatable_Help.

Paramètres

-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

-NotContains

-NotIn

-NotLike

-NotMatch

-Property

-Value

Entrées

PSObject

Vous pouvez diriger n’importe quel objet vers cette applet de commande.

Sorties

Object

Cette applet de commande retourne les éléments sélectionnés du jeu d’objets d’entrée.

Notes

Windows PowerShell inclut les alias suivants pour Where-Object:

• ?
• where

À compter de Windows PowerShell 4.0, Where les ForEach méthodes ont été ajoutées pour une utilisation avec des collections.

Vous pouvez en savoir plus sur ces méthodes ici about_arrays

Liens associés

• Compare-Object
• ForEach-Object
• Group-Object
• Measure-Object
• New-Object
• Select-Object
• Sort-Object
• Tee-Object
• about_Booleans