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

Descrição
-----------
Esse comando executa uma correspondência com diferenciação de maiúsculas e minúsculas do texto que foi canalizado para o comando Select-String. 

Como resultado, o Select-String só localiza "HELLO", porque "HELLO" não corresponde.

Como cada uma das cadeias de caracteres entre aspas é tratada como uma linha, sem o parâmetro CaseSensitive, Select-String reconhece as duas cadeias de caracteres como correspondências.

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

Descrição
-----------
Esse comando pesquisa em todos os arquivos com a extensão de nome de arquivo .xml no diretório atual e exibe as linhas desses arquivos que incluem a cadeia de caracteres "the the".

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

Descrição
-----------
Esse comando pesquisa os arquivos da Ajuda conceitual do Windows PowerShell (about_*.txt) para obter informações sobre o uso do sinal (@). 

Para indicar o caminho, esse comando usa o valor da variável automática $pshome que armazena o caminho para o diretório de instalação do Windows PowerShell. Neste exemplo, o comando pesquisa o subdiretório en_US, que contém os arquivos da Ajuda do idioma inglês (EUA) do Windows PowerShell.

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

Descrição
-----------
Essa função simples usa o cmdlet Select-String para pesquisar os arquivos da Ajuda do Windows PowerShell por uma cadeia de caracteres específica. Neste exemplo, a função pesquisa o subdiretório "en-US" dos arquivos do idioma inglês (EUA).

Para usar a função para localizar uma cadeia de caracteres, como "psdrive", digite "search-help psdrive".

Para usar essa função em qualquer console do Windows PowerShell, altere o caminho para apontar para os arquivos da Ajuda do Windows PowerShell do sistema e cole a função em seu perfil do Windows PowerShell.

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

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

Descrição
-----------
Esse exemplo pesquisa a cadeia de caracteres "failed" nos 100 eventos mais recentes no log Aplicativo do Visualizador de Eventos.

O primeiro comando usa o cmdlet Get-EventLog para obter os 100 eventos mais recentes do log de eventos do Aplicativo. Em seguida, ele armazena os eventos na variável $events. 

O segundo comando usa um operador de pipeline (|) para enviar os eventos na variável $events para o Select-String. Ele usa o parâmetro InputObject para representar a entrada da variável $events. O valor do parâmetro InputObject é a propriedade Message de cada objeto enquanto ele é transmitido pelo pipeline. O objeto atual é representado pelo símbolo $_.

À medida que cada evento chega no pipeline, o Select-String pesquisa o valor de sua propriedade Message para a cadeia de caracteres "failed" e exibe todas as linhas que incluem uma correspondência.

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

Descrição
-----------
Esse comando examina todos os arquivos nos subdiretórios de C:\Windows\System32 com a extensão de nome de arquivo .txt e pesquisa a cadeia de caracteres "Microsoft". O parâmetro CaseSensitive indica que o "M" de "Microsoft" deve estar em letra maiúscula e o restante dos caracteres deve estar em letras minúsculas para que Select-String localize uma correspondência.

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

Descrição
-----------
Esse comando localiza linhas de texto no arquivo Process.txt que não incluem as palavras "idle" ou "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

Descrição
-----------
O primeiro comando pesquisa a frase "logon failed" no arquivo Audit.Log. Ele usa o parâmetro Context para capturar duas linhas antes da correspondência e três linhas depois da correspondência. 

O segundo comando usa a propriedade Count de matrizes de objetos para exibir o número de correspondências localizado; nesse caso, duas. 

O terceiro comando exibe as linhas armazenadas na propriedade Context do primeiro objeto MatchInfo. Ele usa notação de matriz para indicar a primeira correspondência (correspondência 0 em uma matriz baseada em 0) e usa o cmdlet Format-List para exibir o valor da propriedade Context como uma lista.

A saída consiste em dois objetos MatchInfo, um para cada correspondência detectada. As linhas do contexto são armazenadas na propriedade Context do 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

Descrição
-----------
Esse exemplo demonstra o efeito do parâmetro AllMatches de Select-String. AllMatches localiza todas as correspondências padrão em uma linha, em vez de localizar apenas a primeira correspondência em cada linha.

O primeiro comando do exemplo pesquisa os arquivos da Ajuda conceitual do Windows PowerShell ("about" Help) para obter instâncias da palavra "transcript". O segundo comando é idêntico, com a exceção de que ele usa o parâmetro AllMatches.

A saída do primeiro comando é salva na variável $a. A saída do segundo comando é salva na variável $b. 

Quando você exibe o valor das variáveis, a exibição padrão é idêntica, conforme mostrado na saída do exemplo.

No entanto, o quinto e o sexto comandos exibem o valor da propriedade Matches de cada objeto. A propriedade Matches do primeiro comando contém apenas uma correspondência (isto é, um objeto System.Text.RegularExpressions.Match), enquanto que a propriedade Matches do segundo comando contém objetos das duas correspondências da linha.