Select-String

Select-String [-Path] <string[]> [-Шаблон] <string[]> [-AllMatches] [-CaseSensitive] [-Context <Int32[]>] [-Кодирование <string>] [-Exclude <string[]>] [-Include <string[]>] [-List] [-NotMatch] [-Quiet] [-SimpleMatch] [<CommonParameters>]

Select-String -InputObject <psobject> [-Pattern] <string[]> [-AllMatches] [-CaseSensitive] [-Context <Int32[]>] [-Кодирование <string>] [-Exclude <string[]>] [-Include <string[]>] [-List] [-NotMatch] [-Quiet] [-SimpleMatch] [<CommonParameters>]

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

Описание
-----------
Эта команда выполняет поиск с учетом регистра в тексте, переданном в команду Select-String по конвейеру. 

В результате Select-String находит только строку "HELLO", поскольку "Hello" не является совпадением.

Поскольку каждый из заключенных в кавычки фрагментов считается отдельной строкой, без параметра -CaseSensitive командлет Select-String распознал бы в качестве совпадений оба фрагмента.

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

Описание
-----------
Эта команда ищет во всех XML-файлах в текущем каталоге строки, включающие слова "the the", и отображает их.

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

Описание
-----------
Эта команда ищет в файлах концептуальной справки Windows PowerShell (about_*.txt) сведения об использовании символа (@). 

Для указания пути в этой команде используется значение автоматической переменной $pshome, в которой хранится путь к каталогу установки Windows PowerShell. В данном примере команда осуществляет поиск по каталогу en-US, в котором содержатся файлы справки 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]
}

Описание
-----------
Эта простая функция использует командлет Select-String для поиска заданной строки в файлах справки Windows PowerShell. В данном примере функция осуществляет поиск по каталогу en-US, в котором содержатся файлы справки на английском (США) языке.

Чтобы найти с помощью этой функции строку, например "psdrive", введите "search-help psdrive".

Чтобы использовать эту функцию в произвольной консоли Windows PowerShell, замените путь на расположение файлов справки Windows PowerShell в конкретной системе, а затем скопируйте функцию в профиль Windows PowerShell.

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

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

Описание
-----------
В этом примере осуществляется поиск строки "failed" в 100 последних событиях журнала "Приложение" средства "Просмотр событий".

Первая команда с помощью командлета Get-EventLog получает 100 последних записей из журнала событий "Приложение". После этого она сохраняет события в переменной $events. 

Вторая команда с помощью оператора конвейера (|) передает объекты из переменной $events в командлет Select-String. Для представления входных данных в переменной $events она использует параметр InputObject. Значение параметра InputObject равно значению свойства Message каждого передаваемого по конвейеру объекта. Текущий объект представляется символом $_.

Когда событие поступает в конвейер, командлет Select-String ищет строку "failed" в свойстве Message этого события и отображает строки, содержащие совпадение.

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

Описание
-----------
Эта команда ищет во всех TXT-файлах, хранящихся в подкаталогах каталога C:\Windows\System32, строку "Microsoft". Параметр CaseSensitive указывает, что буква "M" в слове "Microsoft" должна быть прописной, а остальные буквы — строчными, чтобы командлет Select-String обнаружил совпадение.

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

Описание
-----------
Эта команда находит в файле Process.txt строки, не содержащие слов "idle" и "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

Описание
-----------
Первая команда ищет в файле Audit.Log фразу "logon failed". Она использует параметр Context, чтобы вывести 2 строки до совпадения и 3 строки после него. 

Вторая команда использует свойство Count массивов объектов для отображения количества найденных совпадений (в данном случае оно равно 2). 

Третья команда отображает строки, хранящиеся в свойстве Context объекта MatchInfo. Для указания первого совпадения (0 в массиве с отсчетом от нуля) используются квадратные скобки, а для отображения значения свойства Context в виде списка — командлет Format-List.

Вывод состоит из двух объектов MatchInfo — по одному на каждое совпадение. Строки контекста сохраняются в свойстве Context объекта 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

Описание
-----------
В этом примере показано действие параметра AllMatches командлета Select-String. Параметр AllMatches позволяет находить все совпадения в строке, а не по одному совпадению.

Первая команда в этом примере ищет вхождения слова "transcript" в файлах концептуальной справки Windows PowerShell (справка "about"). Вторая команда идентична первой за исключением того, что в ней используется параметр AllMatches.

Вывод первой команды сохраняется в переменной $a. Вывод второй команды сохраняется в переменной $b. 

При выводе значений переменных по умолчанию они отображаются одинаково, как показано в примере вывода.

Однако пятая и шестая команда отображают значение свойства Matches каждого из объектов. Свойство Matches для первой команды содержит только одно совпадение (т. е. один объект System.Text.RegularExpressions.Match), в то время как свойство Matches второй команды содержит объекты для обоих совпадений в строке.