Select-String

Select-String [-Path] <string[]> [-Pattern] <string[]> [-AllMatches] [-CaseSensitive] [-Context <Int32[]>] [-Encoding <string>] [-Exclude <string[]>] [-Include <string[]>] [-List] [-NotMatch] [-Quiet] [-SimpleMatch] [<CommonParameters>]

Select-String -InputObject <psobject> [-Pattern] <string[]> [-AllMatches] [-CaseSensitive] [-Context <Int32[]>] [-Encoding <string>] [-Exclude <string[]>] [-Include <string[]>] [-List] [-NotMatch] [-Quiet] [-SimpleMatch] [<CommonParameters>]

C:\PS>"Hello","HELLO" | select-string -pattern "HELLO" -casesensitive

Descripción
-----------
Este comando busca coincidencias con distinción entre minúsculas y mayúsculas del texto que se canalizó al comando Select-String. 

Como resultado, Select-String solo encuentra "HELLO" porque "Hello" no coincide.

Dado que cada una de las cadenas entrecomilladas se trata como una línea, sin el parámetro CaseSensitive, Select-String reconocería ambas cadenas como coincidencias.

C:\PS>select-string -path *.xml -pattern "the the"

Descripción
-----------
Este comando busca en todos los archivos con la extensión .xml del directorio actual y muestra las líneas de esos archivos que contienen la cadena "the the".

C:\PS>select-string -path $pshome\en-US\*.txt -pattern "@"

Descripción
-----------
Este comando busca en los archivos de Ayuda conceptual (about_*.txt) de Windows PowerShell información sobre el uso del signo arroba (@). 

Para indicar la ruta de acceso, este comando usa el valor de la variable automática $pshome, que almacena la ruta de acceso al directorio de instalación de Windows PowerShell. En este ejemplo, el comando busca en el subdirectorio en-US, que contiene los archivos de Ayuda de Windows PowerShell en inglés (EE. UU.).

C:\PS>function search-help
{
    $pshelp = "$pshome\es\about_*.txt", "$pshome\en-US\*dll-help.xml"
    select-string -path $pshelp -pattern $args[0]
}

Descripción
-----------
Esta función simple utiliza el cmdlet Select-String para buscar una cadena concreta en los archivos de Ayuda de Windows PowerShell. En este ejemplo, la función busca en el subdirectorio "en-US" los archivos de Ayuda en inglés de Estados Unidos.

Si desea usar la función para buscar una cadena como "psdrive", escriba "search-help psdrive".

Para utilizar esta función en cualquier consola de Windows PowerShell, cambie la ruta de acceso de modo que apunte a los archivos de Ayuda de Windows PowerShell en su sistema y, a continuación, pegue la función en su perfil de Windows PowerShell.

C:\PS>$events = get-eventlog -logname application -newest 100

C:\PS> $events | select-string -inputobject {$_.message} -pattern "failed"

Descripción
-----------
En este ejemplo, se busca la cadena "failed" en los 100 eventos más recientes del registro de aplicaciones en el Visor de eventos.

El primer comando utiliza el cmdlet Get-EventLog para obtener los 100 eventos más recientes del registro de eventos de aplicación. A continuación, los almacena en la variable $events. 

El segundo comando usa un operador de canalización (|) para enviar los objetos almacenados en la variable $events a Select-String. Utiliza el parámetro InputObject para representar la entrada de la variable $events. El valor del parámetro InputObject es la propiedad Message de cada objeto cuando pasa a través de la canalización. El objeto actual viene representado por el símbolo $_.

Cuando cada uno de los eventos llega a la canalización, Select-String busca en el valor de su propiedad Message la cadena "failed" y, a continuación, muestra las líneas que incluyen una coincidencia.

C:\PS>get-childitem c:\windows\system32\* -include *.txt -recurse |
select-string -pattern "Microsoft" -casesensitive

Descripción
-----------
Este comando examina todos los archivos de los subdirectorios de C:\Windows\System32 que tienen la extensión .txt y busca la cadena "Microsoft". El parámetro CaseSensitive indica que la "M" de "Microsoft" debe estar en mayúsculas y el resto de los caracteres en minúsculas para que Select-String encuentre una coincidencia.

C:\PS>select-string -path process.txt -pattern idle, svchost -notmatch

Descripción
-----------
Este comando busca en el archivo Process.txt las líneas de texto que no incluyan la palabra "idle" o "svchost".

C:\PS>$f = select-string -path audit.log -pattern "logon failed" -context 2, 3

C:\PS> $f.count

C:\PS> ($f)[0].context | format-list

Descripción
-----------
El primer comando busca en el archivo Audit.Log la cadena "logon failed". Utiliza el parámetro Context para capturar 2 líneas antes de la coincidencia y 3 líneas después de la coincidencia. 

El segundo comando usa la propiedad Count de las matrices de objetos para mostrar el número de coincidencias encontradas; en este caso, son 2. 

El tercer comando muestra las líneas almacenadas en la propiedad Context del primer objeto MatchInfo. Utiliza la notación de matriz para indicar la primera coincidencia (coincidencia 0 en una matriz de base cero) y usa el cmdlet Format-List para mostrar el valor de la propiedad Context como una lista.

El resultado se compone de dos objetos MatchInfo, uno por cada coincidencia detectada. Las líneas de contexto se almacenan en la propiedad Context del objeto MatchInfo.

C:\PS>$a = get-childitem $pshome\en-us\about*.help.txt | select-string -pattern transcript


C:\PS> $b = get-childitem $pshome\en-us\about*.help.txt | select-string -pattern transcript -allmatches

C:\PS> $a
C:\Windows\system32\WindowsPowerShell\v1.0\en-us\about_Pssnapins.help.txt:39:       Start-Transcript and Stop-Transcript.

C:\PS> $b
C:\Windows\system32\WindowsPowerShell\v1.0\en-us\about_Pssnapins.help.txt:39:       Start-Transcript and Stop-Transcript.


C:\PS>> $a.matches
Groups   : {Transcript}
Success  : True
Captures : {Transcript}
Index    : 13
Length   : 10
Value    : Transcript


C:\PS> $b.matches
Groups   : {Transcript}
Success  : True
Captures : {Transcript}
Index    : 13
Length   : 10
Value    : Transcript

Groups   : {Transcript}
Success  : True
Captures : {Transcript}
Index    : 33
Length   : 10
Value    : Transcript

Descripción
-----------
En este ejemplo, se muestra el efecto del parámetro AllMatches de Select-String. AllMatches busca todas las coincidencias de patrón en una línea en lugar de buscar simplemente la primera coincidencia en cada línea.

El primer comando del ejemplo busca en los archivos de Ayuda conceptual (Ayuda "about") de Windows PowerShell instancias de la palabra "transcript". El segundo comando es idéntico, salvo en que utiliza el parámetro AllMatches.

El resultado del primer comando se guarda en la variable $a. El resultado del segundo comando se guarda en la variable $b. 

De forma predeterminada, las variables tienen valores idénticos, tal y como se muestra en el resultado de ejemplo.

Sin embargo, el quinto y el sexto comando muestran el valor de la propiedad Matches de cada objeto. La propiedad Matches del primer comando contiene solo una coincidencia (es decir, un objeto System.Text.RegularExpressions.Match), mientras que la propiedad Matches del segundo comando contiene objetos para ambas coincidencias en la línea.