Selecciona objetos de una colección basándose en los valores de sus propiedades.
- Sintaxis
- Descripción
- Ejemplos
- Ejemplo 1: Obtener servicios detenidos
- Ejemplo 2: Obtener procesos basados en el conjunto de trabajo
- Ejemplo 3: Obtener procesos basados en el nombre del proceso
- Ejemplo 4: Utilizar el formato de sentencia de comparación
- Ejemplo 5: Obtener comandos basados en propiedades
- Ejemplo 6: Usar múltiples condiciones
- Parameters
- Entradas
- Salidas
- Notas
Sintaxis
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
Descripción
El cmdlet Where-Object
selecciona objetos que tienen valores de propiedades particulares de la colección de objetos que se le pasan. Por ejemplo, puede utilizar el cmdlet Where-Object
para seleccionar archivos que se crearon después de una fecha determinada, eventos con un ID concreto o equipos que utilizan una versión particular de Windows.
A partir de Windows PowerShell 3.0, hay dos formas diferentes de construir un comando Where-Object
.
-
Bloque de script. Puede utilizar un bloque de script para especificar el nombre de la propiedad, un operador de comparación y un valor de la propiedad.
Where-Object
devuelve todos los objetos para los que la declaración del bloque de script es verdadera.Por ejemplo, el siguiente comando obtiene los procesos de la clase de prioridad Normal, es decir, los procesos en los que el valor de la propiedad PriorityClass es igual a Normal.
Get-Process | Where-Object {$_.PriorityClass -eq "Normal"}
Todos los operadores de comparación de PowerShell son válidos en el formato de bloque de script. Para obtener más informaciónacerca de los operadores de comparación, consulteacerca de los operadores de comparación.
-
Declaración de comparación. También puede escribir una sentencia de comparación, que es mucho más parecida al lenguaje natural. Las sentencias de comparación se introdujeron en Windows PowerShell 3.0.
Por ejemplo, los siguientes comandos también obtienen procesos que tienen una clase de prioridad Normal. Estos comandos son equivalentes y pueden utilizarse indistintamente.
Get-Process | Where-Object -Property PriorityClass -eq -Value "Normal"
Get-Process | Where-Object PriorityClass -eq "Normal"
A partir de Windows PowerShell 3.0,
Where-Object
añade operadores de comparación como parámetros en un comandoWhere-Object
. A menos que se especifique, todos los operadores no distinguen entre mayúsculas y minúsculas. Antes de WindowsPowerShell 3.0, los operadores de comparación en el lenguaje PowerShell sólo podían utilizarse en bloques de scripts.
Cuando se proporciona una única Propiedad a Where-Object
, el valor de la propiedad se trata como una expresión booleana. Cuando el valor de Length es distinto de cero, la expresión se evalúa comoTrue. Por ejemplo: ('hi', '', 'there') | Where-Object Length
El ejemplo anterior es funcionalmente equivalente a:
('hi', '', 'there') | Where-Object Length -GT 0
('hi', '', 'there') | Where-Object {$_.Length -gt 0}
Ejemplos
Ejemplo 1: Obtener servicios detenidos
Estos comandos obtienen una lista de todos los servicios que están actualmente detenidos. La variable automática $_
representa cada objeto que se pasa al cmdlet Where-Object
.
El primer comando utiliza el formato de bloque de script, el segundo comando utiliza el formato de declaración de comparación. Los comandos son equivalentes y pueden utilizarse indistintamente.
Get-Service | Where-Object {$_.Status -eq "Stopped"}Get-Service | where Status -eq "Stopped"
Ejemplo 2: Obtener procesos basados en el conjunto de trabajo
Estos comandos enumeran los procesos que tienen un conjunto de trabajo superior a 250 megabytes (KB). La sintaxis del bloque de guiones y de la declaración son equivalentes y pueden utilizarse indistintamente.
Get-Process | Where-Object {$_.WorkingSet -GT 250MB}Get-Process | Where-Object WorkingSet -GT (250MB)
Ejemplo 3: Obtener procesos basados en el nombre del proceso
Estos comandos obtienen los procesos que tienen un valor de propiedad ProcessName que comienza con la letra p
. El operador Match permite utilizar coincidencias de expresiones regulares.
La sintaxis del bloque de script y de la sentencia son equivalentes y pueden utilizarse indistintamente.
Get-Process | Where-Object {$_.ProcessName -Match "^p.*"}Get-Process | Where-Object ProcessName -Match "^p.*"
Ejemplo 4: Utilizar el formato de sentencia de comparación
Este ejemplo muestra cómo utilizar el nuevo formato de sentencia de comparación del cmdlet Where-Object
.
El primer comando utiliza el formato de sentencia de comparación.En este comando, no se utilizan alias y todos los parámetros incluyen el nombre del parámetro.
El segundo comando es el uso más natural del formato de comando de comparación. El alias where
se sustituye por el nombre del cmdlet Where-Object
y se omiten todos los nombres de parámetros opcionales.
Get-Process | Where-Object -Property Handles -GE -Value 1000Get-Process | where Handles -GE 1000
Ejemplo 5: Obtener comandos basados en propiedades
Este ejemplo muestra cómo escribir comandos que devuelven elementos que son verdaderos o falsos o que tienen cualquier valor para una propiedad especificada. Cada ejemplo muestra tanto el bloque de script como los formatos de sentencia de comparaciónpara el comando.
# 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 $False
Ejemplo 6: Usar múltiples condiciones
Get-Module -ListAvailable | where {($_.Name -notlike "Microsoft*" -and $_.Name -notlike "PS*") -and $_.HelpInfoUri}
Este ejemplo muestra cómo crear un comando Where-Object
con múltiples condiciones.
Este comando obtiene módulos no centrales que soportan la característica de Ayuda Actualizable. El comando utiliza el parámetroListAvailable del cmdlet Get-Module
para obtener todos los módulos del equipo. Un operador de línea de producción (|
) envía los módulos al cmdlet Where-Object
, que obtiene los módulos cuyos nombres no empiezan por Microsoft o PS y tienen un valor para la propiedad HelpInfoURI, que indica a PowerShell dónde encontrar archivos de ayuda actualizados para el módulo. Las sentencias de comparación están conectadas por el operador lógico And.
El ejemplo utiliza el formato de comando de bloque de script. Los operadores lógicos, como And y Or, sólo son válidos en los bloques de script. No puede utilizarlos en el formato de sentencia de comparación de un comandoWhere-Object
.
- Para obtener más información sobre los operadores lógicos de PowerShell, consulte about_Logical_Operators.
- Para obtener más información sobre la función de ayuda actualizable, consulte about_Updatable_Help.
Parameters
Indica que este cmdlet obtiene objetos de una colección si el valor de la propiedad del objeto coincide de forma anexa con el valor especificado. Esta operación distingue entre mayúsculas y minúsculas.
Por ejemplo: Get-Process | where ProcessName -CContains "svchost"
CContiene se refiere a una colección de valores y es verdadero si la colección contiene un elemento que coincide exactamente con el valor especificado. Si la entrada es un solo objeto, PowerShell lo convierte en una colección de un objeto.
Este parámetro se introdujo en Windows PowerShell 3.0.
Tipo: | SwitchParameter |
Posición: | Nombre |
Valor por defecto: | Ninguna |
Acepta la entrada de la tubería: | False |
Acepta caracteres comodín: | False |
Indica que este cmdlet obtiene objetos si el valor de la propiedad es el mismo que el valor especificado.Esta operación distingue entre mayúsculas y minúsculas.
Este parámetro se introdujo en Windows PowerShell 3.0.
Tipo: | SwitchParameter |
Posición: | Nombrado |
Valor por defecto: | Ninguna |
Acepta la entrada de la tubería: | False |
Acepta caracteres comodín: | False |
Indica que este cmdlet obtiene objetos si el valor de la propiedad es mayor o igual al valor especificado. Esta operación distingue entre mayúsculas y minúsculas.
Este parámetro se introdujo en Windows PowerShell 3.0.
Tipo: | SwitchParameter |
Posición: | Nombre |
Valor por defecto: | Ninguna |
Acepta la entrada de la tubería: | False |
Acepta caracteres comodín: | False |
Indica que este cmdlet obtiene objetos si el valor de la propiedad es mayor que el valor especificado.Esta operación distingue entre mayúsculas y minúsculas.
Este parámetro se introdujo en Windows PowerShell 3.0.
Tipo: | SwitchParameter |
Posición: | Nombre |
Valor por defecto: | Ninguna |
Acepta la entrada de la tubería: | False |
Aceptar caracteres comodín: | False |
Indica que este cmdlet obtiene objetos si el valor de la propiedad incluye el valor especificado. Esta operación distingue entre mayúsculas y minúsculas.
Por ejemplo: Get-Process | where -Value "svchost" -CIn ProcessName
CIn se parece a CContains, excepto que las posiciones de la propiedad y el valor se invierten. Por ejemplo, las siguientes afirmaciones son ambas verdaderas.
"abc", "def" -CContains "abc"
"abc" -CIn "abc", "def"
Este parámetro se introdujo en Windows PowerShell 3.0.
Tipo: | SwitchParameter |
Posición: | Nombre |
Valor por defecto: | Ninguna |
Acepta la entrada de la tubería: | False |
Acepta caracteres comodín: | False |
Indica que este cmdlet obtiene objetos si el valor de la propiedad es menor o igual que el valor especificado. Esta operación distingue entre mayúsculas y minúsculas.
Este parámetro se introdujo en Windows PowerShell 3.0.
Tipo: | SwitchParameter |
Posición: | Nombre |
Valor por defecto: | Ninguno |
Acepta la entrada de la tubería: | Falso |
Aceptar caracteres comodín: | Falso |
Indica que este cmdlet obtiene objetos si el valor de la propiedad coincide con un valor que incluye caracteres comodín. Esta operación distingue entre mayúsculas y minúsculas.
Por ejemplo: Get-Process | where ProcessName -CLike "*host"
Este parámetro se introdujo en Windows PowerShell 3.0.
Tipo: | SwitchParameter |
Posición: | Nombre |
Valor por defecto: | Ninguna |
Acepta la entrada de la tubería: | False |
Acepta caracteres comodín: | False |
Indica que este cmdlet obtiene objetos si el valor de la propiedad es menor que el valor especificado. Esta operación distingue entre mayúsculas y minúsculas.
Este parámetro se introdujo en Windows PowerShell 3.0.
Tipo: | SwitchParameter |
Posición: | Nombre |
Valor por defecto: | Ninguno |
Acepta la entrada de la tubería: | False |
Aceptar caracteres comodín: | False |
Indica que este cmdlet obtiene objetos si el valor de la propiedad coincide con la expresión reguladora especificada. Esta operación distingue entre mayúsculas y minúsculas. Cuando la entrada es escalar, el valor coincidente se guarda en $Matches
variable automática.
Por ejemplo: Get-Process | where ProcessName -CMatch "Shell"
Este parámetro se introdujo en Windows PowerShell 3.0.
Tipo: | SwitchParameter |
Posición: | Nombre |
Valor por defecto: | Ninguna |
Acepta la entrada de la tubería: | False |
Acepta caracteres comodín: | False |
Indica que este cmdlet obtiene objetos si el valor de la propiedad es diferente del valor especificado.Esta operación distingue entre mayúsculas y minúsculas.
Este parámetro se introdujo en Windows PowerShell 3.0.
Tipo: | SwitchParameter |
Posición: | Nombre |
Valor por defecto: | Ninguna |
Acepta la entrada de la tubería: | False |
Acepta caracteres comodín: | False |
Indica que este cmdlet obtiene objetos si el valor de la propiedad del objeto no es una coincidencia exacta para el valor especificado. Esta operación distingue entre mayúsculas y minúsculas.
Por ejemplo: Get-Process | where ProcessName -CNotContains "svchost"
NotContains y CNotContains se refieren a una colección de valores y son verdaderos cuando la colección no contiene ningún elemento que coincida exactamente con el valor especificado. Si la entrada es un solo objeto, PowerShell la convierte en una colección de un objeto.
Este parámetro se introdujo en Windows PowerShell 3.0.
Tipo: | SwitchParameter |
Posición: | Nombre |
Valor por defecto: | Ninguna |
Acepta la entrada de la tubería: | False |
Aceptar caracteres comodín: | False |
Indica que este cmdlet obtiene objetos si el valor de la propiedad no coincide exactamente con el valor especificado. Esta operación distingue entre mayúsculas y minúsculas.
Por ejemplo: Get-Process | where -Value "svchost" -CNotIn -Property ProcessName
Los operadores NotIn y CNotIn se parecen a NotContains y CNotContains, excepto que las posiciones de la propiedad y del valor se invierten. Por ejemplo, las siguientes afirmaciones son verdaderas.
"abc", "def" -CNotContains "Abc"
"abc" -CNotIn "Abc", "def"
Tipo: | SwitchParameter |
Nombrado | |
Valor por defecto: | Nada |
False | |
Aceptar caracteres comodín: | False |
Indica que este cmdlet obtiene objetos si el valor de la propiedad no coincide con un valor que incluya caracteres comodín. Esta operación distingue entre mayúsculas y minúsculas.
Por ejemplo: Get-Process | where ProcessName -CNotLike "*host"
Este parámetro se introdujo en Windows PowerShell 3.0.
Tipo: | SwitchParameter |
Posición: | Nombre |
Valor por defecto: | Ninguna |
Acepta la entrada de la tubería: | False |
Aceptar caracteres comodín: | False |
Indica que este cmdlet obtiene objetos si el valor de la propiedad no coincide con la expresión reguladora especificada. Esta operación distingue entre mayúsculas y minúsculas. Cuando la entrada es escalar, el valor coincidente se guarda en $Matches
variable automática.
Por ejemplo: Get-Process | where ProcessName -CNotMatch "Shell"
Este parámetro se introdujo en Windows PowerShell 3.0.
Tipo: | SwitchParameter |
Posición: | Nombre |
Valor por defecto: | Ninguna |
Acepta la entrada de la tubería: | False |
Acepta caracteres comodín: | False |
Indica que este cmdlet obtiene objetos si cualquier elemento del valor de la propiedad del objeto es una coincidencia exacta del valor especificado.
Por ejemplo: Get-Process | where ProcessName -Contains "Svchost"
Si el valor de la propiedad contiene un solo objeto, PowerShell lo convierte en una colección de un objeto.
Este parámetro se introdujo en Windows PowerShell 3.0.
Tipo: | SwitchParameter |
Aliases: | IContiene |
Posición: | Nombrado |
Valor por defecto: | Nada |
False | |
Acepta caracteres comodín: | False |
Indica que este cmdlet obtiene objetos si el valor de la propiedad es el mismo que el valor especificado.
Este parámetro se introdujo en Windows PowerShell 3.0.
Tipo: | SwitchParameter |
Aliases: | IEQ |
Posición: | Nombrado |
Valor por defecto: | Nada |
Falso | |
Acepta caracteres comodín: | Falso |
Especifica el bloque de script que se utiliza para filtrar los objetos. Encierre el bloque de script entre llaves({}
).
El nombre del parámetro, FilterScript, es opcional.
Tipo: | BloqueScript |
Posición: | 0 |
Valor por defecto: | Ninguna |
Acepta la entrada de la tubería: | False |
Acepta caracteres comodín: | False |
Indica que este cmdlet obtiene objetos si el valor de la propiedad es mayor o igual al valor especificado.
Este parámetro se introdujo en Windows PowerShell 3.0.
Tipo: | SwitchParameter |
Aliases: | IGE |
Posición: | Nombrado |
Valor por defecto: | Nada |
False | |
Acepta caracteres comodín: | False |
Indica que este cmdlet obtiene objetos si el valor de la propiedad es mayor que el valor especificado.
Este parámetro se introdujo en Windows PowerShell 3.0.
Tipo: | SwitchParameter |
Aliases: | IGT |
Posición: | Nombrado |
Valor por defecto: | Nada |
False | |
Aceptar caracteres comodín: | False |
Indica que este cmdlet obtiene objetos si el valor de la propiedad coincide con alguno de los valores especificados.Por ejemplo:
Get-Process | where -Property ProcessName -in -Value "Svchost", "TaskHost", "WsmProvHost"
Si el valor del parámetro Value es un solo objeto, PowerShell lo convierte en una colección de un objeto.
Si el valor de la propiedad de un objeto es una matriz, PowerShell utiliza la igualdad de referencias para determinar una coincidencia. Where-Object
Devuelve el objeto sólo si el valor del parámetro Property y anyvalue de Value son la misma instancia de un objeto.
Este parámetro se introdujo en Windows PowerShell 3.0.
Tipo: | SwitchParameter |
Aliases: | IIn |
Posición: | Nombre |
Valor por defecto: | Ninguna |
Acepta la entrada de la tubería: | Falso |
Acepta caracteres comodín: | Falso |
Especifica los objetos a filtrar. También puede canalizar los objetos a Where-Object
.
Cuando se utiliza el parámetro InputObject con Where-Object
, en lugar de canalizar los resultados del comando aWhere-Object
, el valor de InputObject se trata como un solo objeto. Esto es cierto incluso si el valor es una colección que es el resultado de un comando, como -InputObject (Get-Process)
. Dado que InputObject no puede devolver propiedades individuales de una matriz o colección de objetos, recomendamos que, si utiliza Where-Object
para filtrar una colección de objetos para aquellos objetos que tengan valores específicos en propiedades definidas, utilice Where-Object
en la canalización, como se muestra en los ejemplos de este tema.
Tipo: | PSObject |
Posición: | Nombre |
Valor por defecto: | Ninguna |
Acepta la entrada de la tubería: | True |
Acepta caracteres comodín: | False |
Indica que este cmdlet obtiene objetos si el valor de la propiedad es una instancia del tipo .NETtype. Encierre el nombre del tipo entre corchetes.
Por ejemplo, Get-Process | where StartTime -Is
Este parámetro se introdujo en Windows PowerShell 3.0.
Tipo: | SwitchParameter |
Posición: | Nombre |
Valor por defecto: | Ninguna |
Acepta la entrada de la tubería: | False |
Aceptar caracteres comodín: | False |
Indica que este cmdlet obtiene objetos si el valor de la propiedad no es una instancia del tipo especificado.NET.
Por ejemplo, Get-Process | where StartTime -IsNot
Este parámetro se introdujo en Windows PowerShell 3.0.
Tipo: | SwitchParameter |
Posición: | Nombre |
Valor por defecto: | Ninguna |
Acepta la entrada de la tubería: | False |
Acepta caracteres comodín: | False |
Indica que este cmdlet obtiene objetos si el valor de la propiedad es menor o igual que el valor especificado.
Este parámetro se introdujo en Windows PowerShell 3.0.
Tipo: | SwitchParameter |
Aliases: | ILE |
Posición: | Nombrado |
Valor por defecto: | Nada |
Falso | |
Aceptar caracteres comodín: | Falso |
Indica que este cmdlet obtiene objetos si el valor de la propiedad coincide con un valor que incluye caracteres comodín.
Por ejemplo: Get-Process | where ProcessName -Like "*host"
Este parámetro se introdujo en Windows PowerShell 3.0.
Tipo: | SwitchParameter |
Aliases: | ILike |
Posición: | Nombrado |
Valor por defecto: | Nada |
False | |
Acepta caracteres comodín: | False |
Indica que este cmdlet obtiene objetos si el valor de la propiedad es menor que el valor especificado.
Este parámetro se introdujo en Windows PowerShell 3.0.
Tipo: | SwitchParameter |
Aliases: | ILT |
Posición: | Nombrado |
Valor por defecto: | Nada |
False | |
Acepta caracteres comodín: | False |
Indica que este cmdlet obtiene objetos si el valor de la propiedad coincide con la expresión reguladora especificada. Cuando la entrada es escalar, el valor coincidente se guarda en $Matches
variable automática.
Por ejemplo: Get-Process | where ProcessName -Match "shell"
Este parámetro se introdujo en Windows PowerShell 3.0.
Tipo: | SwitchParameter |
Aliases: | IMatch |
Posición: | Nombrado |
Valor por defecto: | Nada |
False | |
Acepta caracteres comodín: | False |
Indica que este cmdlet obtiene objetos si el valor de la propiedad es diferente del valor especificado.
Este parámetro se introdujo en Windows PowerShell 3.0.
Tipo: | SwitchParameter |
Aliases: | INE |
Posición: | Nombre |
Valor por defecto: | Nada |
False | |
Acepta caracteres comodín: | False |
Indica que este cmdlet obtiene objetos si la propiedad no existe o tiene un valor null ofalse.
Por ejemplo: Get-Service | where -Not "DependentServices"
Este parámetro se introdujo en Windows PowerShell 6.1.
Tipo: | SwitchParameter |
Posición: | Nombre |
Valor por defecto: | Ninguna |
Acepta la entrada de la tubería: | Falso |
Acepta caracteres comodín: | Falso |
Indica que este cmdlet obtiene objetos si ninguno de los elementos del valor de la propiedad es una coincidencia exacta para el valor especificado.
Por ejemplo: Get-Process | where ProcessName -NotContains "Svchost"
NotContains se refiere a una colección de valores y es verdadero si la colección no contiene ningún elemento que coincida exactamente con el valor especificado. Si la entrada es un solo objeto, PowerShell lo convierte en una colección de un objeto.
Este parámetro se introdujo en Windows PowerShell 3.0.
Tipo: | SwitchParameter |
Aliases: | INotContains |
Nombrado | |
Valor por defecto: | Nada |
False | |
Aceptar caracteres comodín: | False |
Indica que este cmdlet obtiene objetos si el valor de la propiedad no es una coincidencia exacta para cualquiera de los valores especificados.
Por ejemplo: Get-Process | where -Value "svchost" -NotIn -Property ProcessName
Si el valor de Value es un solo objeto, PowerShell lo convierte en una colección de un objeto.
Si el valor de la propiedad de un objeto es una matriz, PowerShell utiliza la igualdad de referencias para determinar una coincidencia. Where-Object
Devuelve el objeto sólo si el valor de Property y cualquier valor deValue no son la misma instancia de un objeto.
Este parámetro se introdujo en Windows PowerShell 3.0.
Tipo: | SwitchParameter |
Aliases: | INotIn |
Posición: | Nombrado |
Valor por defecto: | Nada |
Falso | |
Aceptar caracteres comodín: | Falso |
Indica que este cmdlet obtiene objetos si el valor de la propiedad no coincide con un valor que incluya caracteres comodín.
Por ejemplo: Get-Process | where ProcessName -NotLike "*host"
Este parámetro se introdujo en Windows PowerShell 3.0.
Tipo: | SwitchParameter |
Aliases: | INotLike |
Nombrado | |
Valor por defecto: | Nada |
False | |
Aceptar caracteres comodín: | False |
Indica que este cmdlet obtiene objetos cuando el valor de la propiedad no coincide con la expresión reguladora especificada. Cuando la entrada es escalar, el valor coincidente se guarda en $Matches
variable automática.
Por ejemplo: Get-Process | where ProcessName -NotMatch "PowerShell"
Este parámetro se introdujo en Windows PowerShell 3.0.
Tipo: | SwitchParameter |
Aliases: | INotMatch |
Position: | Named |
Valor por defecto: | Ninguno |
Acepta entrada de tuberías: | Falso |
Acepta caracteres comodín: | Falso |
Especifica el nombre de una propiedad del objeto. El nombre del parámetro, Property, es opcional.
Este parámetro se introdujo en Windows PowerShell 3.0.
Tipo: | Cadena |
Posición: | 0 |
Valor por defecto: | Ninguna |
Acepta la entrada de la tubería: | Falso |
Acepta caracteres comodín: | Falso |
Especifica un valor de propiedad. El nombre del parámetro, Value, es opcional. Este parámetro acepta caracteres comodín cuando se utiliza con los siguientes parámetros de comparación:
- CLike
- CNotLike
- Like
- NotLike
Este parámetro se introdujo en Windows PowerShell 3.0.
Tipo: | Objeto |
Posición: | 1 |
Valor por defecto: | Ninguna |
Acepta la entrada de la tubería: | Falso |
Acepta caracteres comodín: | Verdadero |
Entradas
PSObject
Puede canalizar los objetos a este cmdlet.
Salidas
Objeto
Este cmdlet devuelve los elementos seleccionados del conjunto de objetos de entrada.
Notas
A partir de Windows PowerShell 4.0, se añadieron los métodos Where
y ForEach
para su uso con colecciones.
Puede leer más sobre estos nuevos métodos aquí about_arrays
- Compare-Object
- ForEach-Object
- Group-Objeto
- Medir-Objeto
- Nuevo-Objeto
- Seleccionar-Objeto
- Organizar-Objeto
- Tener-Objeto