Sélectionne des objets dans une collection en fonction des valeurs de leurs propriétés.
- Syntaxe
- Description
- Exemples
- Exemple 1 : Obtenir les services arrêtés
- Exemple 2 : Obtenir des processus en fonction de l’ensemble de travail
- Exemple 3 : Obtenir les processus en fonction du nom du processus
- Exemple 4 : Utiliser le format d’instruction de comparaison
- Exemple 5 : Obtenir des commandes basées sur des propriétés
- Exemple 6 : Utiliser des conditions multiples
- Paramètres
- Entrées
- Sorties
- Notes
Syntaxe
Where-Object <String> <Object>] Where-Object <ScriptBlock> Where-Object <String> <Object>] -Match Where-Object <String> <Object>] -CEQ Where-Object <String> <Object>] -NE Where-Object <String> <Object>] -CNE Where-Object <String> <Object>] -GT Where-Object <String> <Object>] -CGT Where-Object <String> <Object>] -LT Where-Object <String> <Object>] -CLT Where-Object <String> <Object>] -GE Where-Object <String> <Object>] -CGE Where-Object <String> <Object>] -LE Where-Object <String> <Object>] -CLE Where-Object <String> <Object>] -Like Where-Object <String> <Object>] -CLike Where-Object <String> <Object>] -NotLike Where-Object <String> <Object>] -CNotLike Where-Object <String> <Object>] -CMatch Where-Object <String> <Object>] -NotMatch Where-Object <String> <Object>] -CNotMatch Where-Object <String> <Object>] -Contains Where-Object <String> <Object>] -CContains Where-Object <String> <Object>] -NotContains Where-Object <String> <Object>] -CNotContains .
Where-Object <String> <Object>] -In Where-Object <String> <Object>] -CIn Where-Object <String> <Object>] -NotIn Where-Object <String> <Object>] -CNotIn Where-Object <String> <Object>] -Is Where-Object <String> <Object>] -IsNot Where-Object <String> -Not Description
Le cmdlet Where-Object sélectionne les objets qui ont des valeurs de propriété particulières dans la collectiond’objets qui lui est transmise. Par exemple, vous pouvez utiliser la cmdlet Where-Object pour sélectionner des fichiers qui ont été 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.
À partir de Windows PowerShell 3.0, il existe deux façons différentes de construire une Where-Objectcommande.
-
Bloc de script. Vous pouvez utiliser un bloc de script pour spécifier le nom de la propriété, un opérateur de comparaison, et une valeur de propriété.
Where-Objectrenvoie tous les objets pour lesquels l’énoncé du bloc de script est vrai.Par exemple, la commande suivante obtient les processus de la classe de priorité Normal, c’est-à-dire les processus pour lesquels la valeur de la propriété PriorityClass est égale à Normal.
Get-Process | Where-Object {$_.PriorityClass -eq "Normal"}Tous les opérateurs de comparaison PowerShell sont valides dans le format de bloc de script. Pour plus d’informations sur les opérateurs de comparaison, voirabout_Comparison_Operators.
-
Explication de comparaison. Vous pouvez également écrire une instruction de comparaison, qui ressemble beaucoup plus à un langage naturel. Les déclarations de comparaison ont été introduites dans Windows PowerShell 3.0.
Par exemple, les commandes suivantes obtiennent également les processus qui ont une classe de priorité de Normal. Ces commandes sont équivalentes et peuvent être utilisées de manière interchangeable.
Get-Process | Where-Object -Property PriorityClass -eq -Value "Normal"Get-Process | Where-Object PriorityClass -eq "Normal"Depuis Windows PowerShell 3.0,
Where-Objectajoute des opérateurs de comparaison en tant que paramètres dans une commandeWhere-Object. Sauf indication contraire, tous les opérateurs sont insensibles à la casse. Avant WindowsPowerShell 3.0, les opérateurs de comparaison du langage PowerShell ne pouvaient être utilisés que dans les blocs de script.
Lorsque vous fournissez une seule propriété à Where-Object, la valeur de la propriété est traitée comme une expression booléenne. Lorsque la valeur de Longueur est différente de zéro, l’expression est évaluée àVrai. 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}
Exemples
Exemple 1 : Obtenir les services arrêtés
Ces commandes obtiennent une liste de tous les services qui sont actuellement arrêtés. La variable automatique $_représente chaque objet transmis au cmdlet Where-Object.
La première commande utilise le format de bloc de script, la deuxième commande utilise le format de déclaration de comparaison. Les commandes sont équivalentes et peuvent être utilisées de manière interchangeable.
Get-Service | Where-Object {$_.Status -eq "Stopped"}Get-Service | where Status -eq "Stopped"Exemple 2 : Obtenir des processus en fonction de l’ensemble de travail
Ces commandes répertorient les processus dont l’ensemble de travail est supérieur à 250 mégaoctets (Ko). Les syntaxes de bloc de script et d’instruction sont équivalentes et peuvent être utilisées de manière interchangeable.
Get-Process | Where-Object {$_.WorkingSet -GT 250MB}Get-Process | Where-Object WorkingSet -GT (250MB)Exemple 3 : Obtenir les processus en fonction du nom du processus
Ces commandes obtiennent les processus dont la valeur de la propriété ProcessName commence par la lettre p. L’opérateur Match vous permet d’utiliser des correspondances d’expressions régulières.
La syntaxe du scriptblock et de l’instruction est équivalente et peut être utilisée de manière interchangeable.
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 du cmdlet Where-Object.
La première commande utilise le format d’instruction de comparaison.Dans cette commande, aucun alias n’est utilisé et tous les paramètres incluent le nom du paramètre.
La deuxième commande est l’utilisation plus naturelle du format d’instruction de comparaison. L’alias where est substitué au nom du cmdlet Where-Object et tous les noms de paramètres facultatifs sont omis.
Get-Process | Where-Object -Property Handles -GE -Value 1000Get-Process | where Handles -GE 1000Exemple 5 : Obtenir des commandes basées sur des propriétés
Cet exemple montre comment écrire des commandes qui renvoient des éléments qui sont vrais ou faux ou qui ont une valeur quelconque pour une propriété spécifiée. Chaque exemple montre à la fois le bloc de script et les formats d’instruction de comparaison pour la commande.
# 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 OutputTypeGet-Command | where {$_.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 PSIsContainerGet-ChildItem | where {$_.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 {!$_.PSIsContainer}# You cannot use the Not operator (!) in the comparison statement format of the command.Get-ChildItem | where PSIsContainer -eq $FalseExemple 6 : Utiliser des conditions multiples
Get-Module -ListAvailable | where {($_.Name -notlike "Microsoft*" -and $_.Name -notlike "PS*") -and $_.HelpInfoUri}Cet exemple montre comment créer une commande Where-Object avec plusieurs conditions.
Cette commande obtient des modules non essentiels qui prennent en charge la fonctionnalité Aide actualisable. La commande utilise le paramètreListAvailable du cmdlet Get-Module pour obtenir tous les modules sur l’ordinateur. Un opérateur de ligne de commande (|) envoie les modules à la cmdlet Where-Object, qui récupère les modules dont le nom ne commence pas par Microsoft ou PS, et qui ont une valeur pour la propriété HelpInfoURI, qui indique à PowerShell où trouver les fichiers d’aide mis à jour pour le module. Les instructions de comparaison sont reliées par l’opérateur logique And.
L’exemple utilise le format de commande du bloc de script. Les opérateurs logiques, tels que And et Or, sont valides uniquement dans les blocs de script. Vous ne pouvez pas les utiliser dans le format d’instruction de comparaison d’une commandeWhere-Object.
- Pour plus d’informations sur les opérateurs logiques PowerShell, voir about_Logical_Operators.
- Pour plus d’informations sur la fonctionnalité d’aide actualisable, voir about_Updatable_Help.
Paramètres
Indique que ce cmdlet obtient des objets d’une collection si la valeur de la propriété de l’objet est une correspondance exacte de la valeur spécifiée. Cette opération est sensible à la casse.
Par exemple : Get-Process | where ProcessName -CContains "svchost"
CContains fait référence à une collection de valeurs et est vrai si la collection contient un élément qui correspond exactement à la valeur spécifiée. Si l’entrée est un objet unique, PowerShell la convertit en une collection d’un objet.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Accepter l’entrée du pipeline : | False |
| Accepter les caractères génériques : | False |
Indique que cette cmdlet obtient des objets si la valeur de la propriété est identique à la valeur spécifiée.Cette opération est sensible à la casse.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Acceptation de l’entrée du pipeline : | False |
| Acceptation des caractères génériques: | False |
Indique que cette cmdlet obtient des objets si la valeur de la propriété est supérieure ou égale à la valeur spécifiée. Cette opération est sensible à la casse.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Acceptation de l’entrée du pipeline : | False |
| Accepter les caractères génériques: | False |
Indique que cette cmdlet obtient des objets si la valeur de la propriété est supérieure à la valeur spécifiée.Cette opération est sensible à la casse.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Acceptation de l’entrée du pipeline : | False |
| Acceptation des caractères génériques : | False |
Indique que cette cmdlet obtient des objets si la valeur de la propriété inclut la valeur spécifiée. Cette opération est sensible à la casse.
Par exemple : Get-Process | where -Value "svchost" -CIn ProcessName
CIn ressemble à CContains, sauf que les positions de la propriété et de la valeur sont inversées. Forexample, les déclarations suivantes sont toutes deux vraies.
"abc", "def" -CContains "abc"
"abc" -CIn "abc", "def"
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Acceptation des entrées du pipeline : | False |
| Acceptation des caractères génériques: | False |
Indique que cette cmdlet obtient des objets si la valeur de la propriété est inférieure ou égale à la valeur spécifiée. Cette opération est sensible à la casse.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Acceptation de l’entrée du pipeline : | False |
| Acceptation des caractères génériques: | False |
Indique que cette cmdlet obtient des objets si la valeur de la propriété correspond à une valeur qui inclut des caractères génériques. Cette opération est sensible à la casse.
Par exemple : Get-Process | where ProcessName -CLike "*host"
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Acceptation des entrées du pipeline : | False |
| Acceptation des caractères génériques: | False |
Indique que cette cmdlet obtient des objets si la valeur de la propriété est inférieure à la valeur spécifiée. Cette opération est sensible à la casse.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Acceptation de l’entrée du pipeline : | False |
| Accepter les caractères génériques: | False |
Indique que cette cmdlet obtient des objets si la valeur de la propriété correspond à l’expression réglementaire spécifiée. Cette opération est sensible à la casse. Lorsque l’entrée est scalaire, la valeur mise en correspondance est enregistrée dans $Matchesla variable automatique.
Par exemple : Get-Process | where ProcessName -CMatch "Shell"
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Acceptation des entrées du pipeline : | False |
| Acceptation des caractères génériques: | False |
Indique que cette cmdlet obtient des objets si la valeur de la propriété est différente de la valeur spécifiée.Cette opération est sensible à la casse.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Accepter l’entrée du pipeline : | False |
| Acceptation des caractères génériques: | False |
Indique que cette cmdlet obtient des objets si la valeur de propriété de l’objet n’est pas une correspondance exactepour la valeur spécifiée. Cette opération est sensible à la casse.
Par exemple : Get-Process | where ProcessName -CNotContains "svchost"
NotContains et CNotContains font référence à une collection de valeurs et sont vrais lorsque lacollection ne contient aucun élément qui correspond exactement à la valeur spécifiée. Si l’entrée est un objet unique, PowerShell la convertit en une collection d’un objet.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Accepter l’entrée du pipeline : | False |
| Acceptation des caractères génériques: | False |
Indique que cette cmdlet obtient des objets si la valeur de la propriété ne correspond pas exactement à la valeur spécifiée. Cette opération est sensible à la casse.
Par exemple : Get-Process | where -Value "svchost" -CNotIn -Property ProcessName
Les opérateurs NotIn et CNotIn ressemblent à NotContains et CNotContains, sauf que les positions de la propriété et de la valeur sont inversées. Par exemple, les déclarations suivantes sont vraies.
"abc", "def" -CNotContains "Abc"
"abc" -CNotIn "Abc", "def"
| Type: | SwitchParameter |
| Position : | Nommé |
| Valeur par défaut : | None |
| Accepter l’entrée du pipeline : | False |
| Accepter les caractères génériques : | False |
Indique que cette cmdlet obtient des objets si la valeur de la propriété ne correspond pas à une valeur incluant des caractères génériques. Cette opération est sensible à la casse.
Par exemple : Get-Process | where ProcessName -CNotLike "*host"
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Acceptation des entrées du pipeline : | False |
| Accepter les caractères génériques: | False |
Indique que cette cmdlet obtient des objets si la valeur de la propriété ne correspond pas à l’expression réglementaire spécifiée. Cette opération est sensible à la casse. Lorsque l’entrée est scalaire, la valeur mise en correspondance est enregistrée dans $Matchesla variable automatique.
Par exemple : Get-Process | where ProcessName -CNotMatch "Shell"
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Acceptation des entrées du pipeline : | False |
| Acceptation des caractères génériques: | False |
Indique que cette cmdlet obtient des objets si un élément de la valeur de la propriété de l’objet est une correspondance exacte de la valeur spécifiée.
Par exemple : Get-Process | where ProcessName -Contains "Svchost"
Si la valeur de la propriété contient un seul objet, PowerShell la convertit en une collection d’un objet.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Alias: | IContains |
| Position : | Nommée |
| Valeur par défaut : | None |
| Acceptation des entrées du pipeline : | False |
| Acceptation des caractères génériques : | False |
Indique que cette cmdlet obtient des objets si la valeur de la propriété est identique à la valeur spécifiée.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Alias: | IEQ |
| Position : | Nommée |
| Valeur par défaut : | None |
| Acceptation des entrées du pipeline : | False |
| Acceptation des caractères génériques: | False |
Spécifie le bloc de script qui est utilisé pour filtrer les objets. Encadrez le bloc de script entre accolades({}).
Le nom du paramètre, FilterScript, est facultatif.
| Type: | Bloc de script |
| Position: | 0 |
| Valeur par défaut: | None |
| Accepter l’entrée du pipeline : | False |
| Acceptation des caractères génériques : | False |
Indique que cette cmdlet obtient des objets si la valeur de la propriété est supérieure ou égale à la valeur spécifiée.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Aliases: | IGE |
| Position : | Nommée |
| Valeur par défaut : | None |
| Acceptation des entrées du pipeline : | False |
| Acceptation des caractères génériques : | False |
Indique que cette cmdlet obtient des objets si la valeur de la propriété est supérieure à la valeur spécifiée.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Aliases: | IGT |
| Position : | Nommée |
| Valeur par défaut: | None |
| Acceptation des entrées du pipeline : | False |
| Acceptation des caractères génériques: | False |
Indique que cette cmdlet obtient des objets si la valeur de la propriété correspond à l’une des valeurs spécifiées.Par exemple :
Get-Process | where -Property ProcessName -in -Value "Svchost", "TaskHost", "WsmProvHost"
Si la valeur du paramètre Value est un objet unique, PowerShell le convertit en une collection d’un objet.
Si la valeur de propriété d’un objet est un tableau, PowerShell utilise l’égalité de référence pour déterminer la correspondance. Where-Object renvoie l’objet uniquement si la valeur du paramètre Property et toute valeur de Value sont la même instance d’un objet.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Aliases: | IIn |
| Position: | Named |
| Valeur par défaut : | None |
| Acceptation de l’entrée pipeline: | False |
| Acceptation des caractères génériques: | False |
Spécifie les objets à filtrer. Vous pouvez également acheminer les objets vers Where-Object.
Lorsque vous utilisez le paramètre InputObject avec Where-Object, au lieu d’acheminer les résultats de la commande versWhere-Object, la valeur InputObject est traitée comme un objet unique. Cela est vrai même si la valeur est une collection qui est le résultat d’une commande, comme -InputObject (Get-Process). Étant donné qu’InputObject ne peut pas renvoyer les propriétés individuelles d’un tableau ou d’une collection d’objets, nous vous recommandons, si vous utilisez Where-Object pour filtrer une collection d’objets pour les objets qui ont des valeurs spécifiques dans les propriétés définies, d’utiliser Where-Object dans le pipeline, comme indiqué dans les exemples de cette rubrique.
| Type: | PSObject |
| Position: | Named |
| Valeur par défaut: | None |
| Acceptation de l’entrée du pipeline : | True |
| Accepter les caractères génériques : | False |
Indique que cette cmdlet obtient des objets si la valeur de la propriété est une instance du .NETtype spécifié. Encadrez le nom du type entre crochets.
Par exemple, Get-Process | where StartTime -Is
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Acceptation des entrées du pipeline : | False |
| Acceptation des caractères génériques: | False |
Indique que cette cmdlet obtient des objets si la valeur de la propriété n’est pas une instance du type spécifié.NET.
Par exemple, Get-Process | where StartTime -IsNot
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Acceptation des entrées du pipeline : | False |
| Acceptation des caractères génériques : | False |
Indique que ce cmdlet obtient des objets si la valeur de la propriété est inférieure ou égale à la valeur spécifiée.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Aliases: | ILE |
| Position : | Nommée |
| Valeur par défaut: | None |
| Acceptation des entrées du pipeline : | False |
| Acceptation des caractères génériques: | False |
Indique que cette cmdlet obtient des objets si la valeur de la propriété correspond à une valeur qui inclut des caractères génériques.
Par exemple : Get-Process | where ProcessName -Like "*host"
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Alias: | ILike |
| Position : | Nommée |
| Valeur par défaut : | None |
| Acceptation des entrées du pipeline : | False |
| Acceptation des caractères génériques : | False |
Indique que cette cmdlet obtient des objets si la valeur de la propriété est inférieure à la valeur spécifiée.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Aliases: | ILT |
| Position : | Nommée |
| Valeur par défaut: | None |
| Acceptation des entrées du pipeline : | False |
| Acceptation des caractères génériques: | False |
Indique que cette cmdlet obtient des objets si la valeur de la propriété correspond à l’expression réglementaire spécifiée. Lorsque l’entrée est scalaire, la valeur appariée est enregistrée dans $Matchesla variable automatique.
Par exemple : Get-Process | where ProcessName -Match "shell"
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Aliases: | IMatch |
| Position : | Nommée |
| Valeur par défaut: | None |
| Acceptation des entrées du pipeline : | False |
| Acceptation des caractères génériques : | False |
Indique que cette cmdlet obtient des objets si la valeur de la propriété est différente de la valeur spécifiée.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Aliases: | INE |
| Position : | Nommée |
| Valeur par défaut: | None |
| Acceptation des entrées du pipeline : | False |
| Acceptation des caractères génériques : | False |
Indique que cette cmdlet obtient des objets si la propriété n’existe pas ou a une valeur de null oufalse.
Par exemple : Get-Service | where -Not "DependentServices"
Ce paramètre a été introduit dans Windows PowerShell 6.1.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Acceptation des entrées du pipeline : | False |
| Acceptation des caractères génériques : | False |
Indique que ce cmdlet obtient des objets si aucun des éléments de la valeur de la propriété ne correspond exactement à la valeur spécifiée.
Par exemple : Get-Process | where ProcessName -NotContains "Svchost"
NotContains fait référence à une collection de valeurs et est vrai si la collection ne contient aucun élément qui est une correspondance exacte pour la valeur spécifiée. Si l’entrée est un objet unique, PowerShellla convertit en une collection d’un objet.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Aliases: | INotContains |
| Position : | Nommée |
| Valeur par défaut : | None |
| Acceptation des entrées du pipeline : | False |
| Acceptation des caractères génériques: | False |
Indique que ce cmdlet obtient des objets si la valeur de la propriété n’est pas une correspondance exacte pour l’une des valeurs spécifiées.
Par exemple : Get-Process | where -Value "svchost" -NotIn -Property ProcessName
Si la valeur de Value est un objet unique, PowerShell la convertit en une collection d’un objet.
Si la valeur de propriété d’un objet est un tableau, PowerShell utilise l’égalité de référence pour déterminer la correspondance. Where-Object renvoie l’objet uniquement si la valeur de Property et toute valeur deValue ne sont pas la même instance d’un objet.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Aliases: | INotIn |
| Position : | Nommée |
| Valeur par défaut : | None |
| Acceptation des entrées du pipeline : | False |
| Accepter les caractères génériques: | False |
Indique que ce cmdlet obtient des objets si la valeur de la propriété ne correspond pas à une valeur qui inclut des caractères génériques.
Par exemple : Get-Process | where ProcessName -NotLike "*host"
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Aliases: | INotLike |
| Position : | Nommée |
| Valeur par défaut : | None |
| Acceptation des entrées du pipeline : | False |
| Acceptation des caractères génériques: | False |
Indique que cette cmdlet obtient des objets lorsque la valeur de la propriété ne correspond pas à l’expression réglementaire spécifiée. Lorsque l’entrée est scalaire, la valeur appariée est enregistrée dans $Matchesla variable automatique.
Par exemple : Get-Process | where ProcessName -NotMatch "PowerShell"
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Aliases: | INotMatch |
| Position: | Named |
| Valeur par défaut : | None |
| Acceptent les entrées du pipeline: | False |
| Acceptent les caractères génériques: | False |
Spécifie le nom d’une propriété d’objet. Le nom du paramètre, Property, est facultatif.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | String |
| Position: | 0 |
| Valeur par défaut: | None |
| Acceptation de l’entrée du pipeline : | Faux |
| Acceptent les caractères génériques : | Faux |
Spécifie une valeur de propriété. Le nom du paramètre, Valeur, est facultatif. Ce paramètre accepte les caractères génériques lorsqu’il est utilisé avec les paramètres de comparaison suivants :
- CLike
- CNotLike
- Like
- NotLike
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | Objet |
| Position: | 1 |
| Valeur par défaut: | None |
| Acceptation des entrées du pipeline : | False |
| Acceptation des caractères génériques: | True |
Entrées
PSObject
Vous pouvez canaliser les objets vers cette cmdlet.
Sorties
Objet
Ce cmdlet renvoie les éléments sélectionnés dans l’ensemble d’objets d’entrée.
Notes
Depuis Windows PowerShell 4.0, les méthodes Where et ForEach ont été ajoutées pour être utilisées avec les collections.
Vous pouvez lire plus sur ces nouvelles méthodes ici about_arrays
- Compare-Object
- ForEach-Object
- Group-.Objet
- Measure-Object
- New-Object
- Select-Object
- Sort-Object
- Tee-Object