Select-String

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

Select-String
    [-Pattern] <String[]>
    -InputObject <PSObject>
    -Raw
    [-Culture <String>]
    [-SimpleMatch]
    [-CaseSensitive]
    [-List]
    [-NoEmphasis]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-NotMatch]
    [-AllMatches]
    [-Encoding <Encoding>]
    [-Context <Int32[]>]
    [<CommonParameters>]

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

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

Select-String
    [-Pattern] <String[]>
    -LiteralPath <String[]>
    -Raw
    [-Culture <String>]
    [-SimpleMatch]
    [-CaseSensitive]
    [-List]
    [-NoEmphasis]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-NotMatch]
    [-AllMatches]
    [-Encoding <Encoding>]
    [-Context <Int32[]>]
    [<CommonParameters>]

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

Командлет Select-String использует сопоставление регулярных выражений для поиска текстовых шаблонов в входных строках и файлах. Вы можете использовать Select-String аналогичные grep функции в Unix или findstr.exe Windows.

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

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

Вы также можете указать, что Select-String следует ожидать кодировки определенного символа, например, при поиске файлов с текстом Юникода. Select-String использует метку байтового порядка (BOM) для обнаружения формата кодирования файла. Если файл не имеет BOM, предполагается, что кодировка — UTF8.

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

'Hello', 'HELLO' | Select-String -Pattern 'HELLO' -CaseSensitive -SimpleMatch

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

Эта команда выполняет поиск во всех файлах с расширением .txt имени в текущем каталоге. На выходе отображаются строки в тех файлах, которые содержат указанную строку.

Get-Alias | Out-File -FilePath .\Alias.txt
Get-Command | Out-File -FilePath .\Command.txt
Select-String -Path .\*.txt -Pattern 'Get-'

Alias.txt:8:Alias            cat -> Get-Content
Alias.txt:28:Alias           dir -> Get-ChildItem
Alias.txt:43:Alias           gal -> Get-Alias
Command.txt:966:Cmdlet       Get-Acl
Command.txt:967:Cmdlet       Get-Alias

В этом примере Get-Alias и Get-Command используются с Out-File командлетом для создания двух текстовых файлов в текущем каталоге, Alias.txt и Command.txt.

Select-String использует параметр Path с подстановочным знаком asterisk(*) для поиска всех файлов в текущем каталоге с расширением .txtимени файла . Параметр Pattern указывает текст, соответствующий Get-. Select-String отображает выходные данные в консоли PowerShell. Имя файла и номер строки предшествуют каждой строке содержимого, содержащей совпадение для параметра Pattern .

В этом примере выполняется поиск нескольких файлов для поиска совпадений для указанного шаблона. В шаблоне используется квантификатор регулярных выражений. Дополнительные сведения см. в about_Regular_Expressions.

Select-String -Path "$PSHOME\en-US\*.txt" -Pattern '\?'

C:\Program Files\PowerShell\6\en-US\default.help.txt:27:    beginning at https://go.microsoft.com/fwlink/?LinkID=108518.
C:\Program Files\PowerShell\6\en-US\default.help.txt:50:    or go to: https://go.microsoft.com/fwlink/?LinkID=210614

Командлет Select-String использует два параметра: Path и Pattern. Параметр Path использует переменную$PSHOME, указывающую каталог PowerShell. Остальная часть пути включает в себя подкаталог en-US и указывает каждый *.txt файл в каталоге. Параметр Pattern указывает на соответствие вопросительному знаку (?) в каждом файле. Обратная косая черта (\) используется в качестве escape-символа и необходима, поскольку вопросительный знак (?) является квантором регулярного выражения. Select-String отображает выходные данные в консоли PowerShell. Имя файла и номер строки предшествуют каждой строке содержимого, содержащей совпадение для параметра Pattern .

В этом примере создается функция для поиска шаблона в файлах справки PowerShell. В этом примере функция существует только в сеансе PowerShell. Когда сеанс PowerShell закрывается, функция удаляется. Дополнительные сведения см. в about_Functions.

function Search-Help
{
    $PSHelp = "$PSHOME\en-US\*.txt"
    Select-String -Path $PSHelp -Pattern 'About_'
}

Search-Help

C:\Program Files\PowerShell\7\en-US\default.help.txt:67:    The titles of conceptual topics begin with "About_".
C:\Program Files\PowerShell\7\en-US\default.help.txt:70:    Get-Help About_<topic-name>
C:\Program Files\PowerShell\7\en-US\default.help.txt:93:    Get-Help About_Modules : Displays help about PowerShell modules.
C:\Program Files\PowerShell\7\en-US\default.help.txt:97:    about_Updatable_Help

Функция создается в командной строке PowerShell. Ключевое function слово использует имя Search-Help. Нажмите клавишу Enter, чтобы начать добавление операторов в функцию. В запросе >> добавьте каждую инструкцию и нажмите клавишу ВВОД, как показано в примере. После добавления закрывающей скобки вы вернетесь к командной строке PowerShell.

Функция содержит две команды. В $PSHelp переменной хранится путь к файлам справки PowerShell. $PSHOME — это каталог установки PowerShell с подкаталогом en-US , который указывает каждый *.txt файл в каталоге.

Команда Select-String в функции использует параметры Path и Pattern . Параметр Path использует $PSHelp переменную для получения пути. Параметр Pattern использует строку About_ в качестве критерия поиска.

Чтобы запустить функцию, введите Search-Help. Команда функции Select-String отображает выходные данные в консоли PowerShell.

В этом примере выполняется поиск строки в журнале событий Windows. Переменная $_ представляет текущий объект в конвейере. Дополнительные сведения см. в разделе about_Automatic_Variables.

$Events = Get-WinEvent -LogName Application -MaxEvents 50
$Events | Select-String -InputObject {$_.Message} -Pattern 'Failed'

Командлет Get-WinEvent использует параметр LogName для указания журнала приложения. Параметр MaxEvents получает 50 самых последних событий из журнала. Содержимое журнала хранится в переменной с именем $Events.

Переменная $Events отправляется по конвейеру командлету Select-String. Select-String использует параметр InputObject . Переменная $_ представляет текущий объект и Message является свойством события. Параметр Pattern указывает строку failed и выполняет поиск совпадений в $_.Message. Select-String отображает выходные данные в консоли PowerShell.

В этом примере выполняется поиск определенной текстовой строки в каталоге и всех его подкаталогах.

Get-ChildItem -Path C:\Windows\System32\*.txt -Recurse |
    Select-String -Pattern 'Microsoft' -CaseSensitive

Get-ChildItem использует параметр Path для указания C:\Windows\System32*.txt. Параметр Recurse включает в себя поддиректории. Объекты отправляются по конвейеру в Select-String.

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

В этом примере показано, как исключить строки данных, которые не соответствуют шаблону.

Get-Command | Out-File -FilePath .\Command.txt
Select-String -Path .\Command.txt -Pattern 'Get', 'Set'  -NotMatch

Командлет Get-Command отправляет объекты вниз по конвейеру Out-File для создания файлаCommand.txt в текущем каталоге. Select-String использует параметр Path для указания файлаCommand.txt . Параметр Pattern указывает Get и Set в качестве шаблона поиска. Параметр NotMatch исключает Get и Set из результатов. Select-String отображает выходные данные в консоли PowerShell, которые не включают команды Get или Set.

В этом примере показано, как получить линии до и после совпадающего шаблона.

Get-Command | Out-File -FilePath .\Command.txt
Select-String -Path .\Command.txt -Pattern 'Get-Computer' -Context 2, 3

  Command.txt:986:Cmdlet          Get-CmsMessage           6.1.0.0    Microsoft.PowerShell.Security
  Command.txt:987:Cmdlet          Get-Command              6.1.2.0    Microsoft.PowerShell.Core
> Command.txt:988:Cmdlet          Get-ComputerInfo         6.1.0.0    Microsoft.PowerShell.Management
  Command.txt:990:Cmdlet          Get-Content              6.1.0.0    Microsoft.PowerShell.Management
  Command.txt:991:Cmdlet          Get-ControlPanelItem     3.1.0.0    Microsoft.PowerShell.Management
  Command.txt:992:Cmdlet          Get-Credential           6.1.0.0    Microsoft.PowerShell.Security

Командлет Get-Command отправляет объекты вниз по конвейеру Out-File для создания файлаCommand.txt в текущем каталоге. Select-String использует параметр Path для указания файлаCommand.txt . Параметр Pattern указывает Get-Computer в качестве шаблона поиска. Параметр Context использует два значения, до и после, и помечает совпадения шаблона в выходных данных угловой скобкой (>). Параметр Context выводит две строки до первого совпадения с шаблоном и три строки после последнего совпадения с шаблоном.

В этом примере показано, как параметр AllMatches находит каждое совпадение с шаблоном в строке текста. По умолчанию Select-String находит только первое вхождение шаблона в строке текста. В этом примере используются свойства объекта, найденные с помощью Get-Member командлета.

$A = Get-ChildItem -Path "$PSHOME\en-US\*.txt" | Select-String -Pattern 'PowerShell'
$A

C:\Program Files\PowerShell\7\en-US\default.help.txt:3:    PowerShell Help System
C:\Program Files\PowerShell\7\en-US\default.help.txt:6:    Displays help about PowerShell cmdlets and concepts.
C:\Program Files\PowerShell\7\en-US\default.help.txt:9:    PowerShell Help describes PowerShell cmdlets

$A.Matches

Groups   : {0}
Success  : True
Name     : 0
Captures : {0}
Index    : 4
Length   : 10
Value    : PowerShell

$A.Matches.Length

8

$B = Get-ChildItem -Path "$PSHOME\en-US\*.txt" | Select-String -Pattern 'PowerShell' -AllMatches
$B.Matches.Length

9

Командлет Get-ChildItem использует параметр Path . Параметр Path использует переменную$PSHOME, указывающую каталог PowerShell. Остальная часть пути включает в себя подкаталог en-US и указывает каждый *.txt файл в каталоге. Объекты Get-ChildItem хранятся в $A переменной. Переменная $A отправляется по конвейеру командлету Select-String. Select-String использует параметр Pattern для поиска строки PowerShell в каждом файле.

Из командной строки $A PowerShell отображается содержимое переменной. Есть строка, содержащая два вхождения строки PowerShell.

В $A.Matches свойстве указывается первое вхождение шаблона PowerShell в каждой строке.

Свойство $A.Matches.Length подсчитывает первое вхождение шаблона PowerShell в каждой строке.

Переменная $B использует то же самое Get-ChildItem и Select-String cmdlets, но добавляет параметр AllMatches . AllMatches находит каждое вхождение шаблона PowerShell в каждой строке. Объекты, хранящиеся в переменных and $A$B , идентичны.

Свойство $B.Matches.Length увеличивается, так как для каждой строки учитывается каждое вхождение шаблона PowerShell .

Результат ToString() конвейерного объекта не совпадает с форматированным строковым представлением, созданным системой форматирования PowerShell. Таким образом, сначала может потребоваться передать объекты Out-String .

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

PS> $hash = @{
    Name = 'foo'
    Category = 'bar'
}

# !! NO output, due to .ToString() conversion
$hash | Select-String -Pattern 'foo'

# Out-String converts the output to a single multi-line string object
PS> $hash | Out-String | Select-String -Pattern 'foo'

Name                           Value
----                           -----
Name                           foo
Category                       bar

# Out-String -Stream converts the output to a multiple single-line string objects
PS> $hash | Out-String -Stream | Select-String -Pattern 'foo'

Name                           foo

Пилинг для Out-String -Stream преобразования отформатированных выходных данных в несколько однострочных строковых объектов. Это означает, что при Select-String поиске совпадения он выводит только соответствующую строку.

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Вы можете передать любой объект с методом ToString() в этот командлет.

По умолчанию этот командлет возвращает объект MatchInfo для каждого найденного совпадения.

При использовании параметра Quiet этот командлет возвращает логическое значение, указывающее, найден ли шаблон.

При использовании необработанного параметра этот командлет возвращает набор объектов String , которые соответствуют шаблону.

PowerShell включает следующие псевдонимы для Select-String:

• Все платформы:
  • sls

Select-String похож на grep Unix или findstr.exe в Windows.

Псевдоним sls командлета Select-String был представлен в PowerShell 3.0.

При отправке объектов в Select-String:

• Объекты FileInfo рассматриваются как путь к файлу. Если указаны пути к файлам, Select-String выполняется поиск содержимого файла, а не ToString() представление объекта.
• Результат ToString() конвейерного объекта не совпадает с форматированным строковым представлением, созданным системой форматирования PowerShell. Таким образом, сначала может потребоваться передать объекты Out-String . Дополнительные сведения см. в разделе Пример 10.

Чтобы использовать Select-String, введите текст, который вы хотите найти, в качестве значения параметра Pattern . Чтобы указать текст для поиска, используйте следующие критерии:

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

По умолчанию Select-String интерпретирует значение параметра Pattern как регулярное выражение. Дополнительные сведения см. в about_Regular_Expressions. Параметр SimpleMatch можно использовать для переопределения сопоставления регулярных выражений. Параметр SimpleMatch находит экземпляры значения параметра Pattern во входных данных.

Выходными данными по Select-String умолчанию является объект MatchInfo , который содержит подробную информацию о матчах. Информация в объекте полезна при поиске текста в файлах, так как объекты MatchInfo имеют такие свойства, как Filename и Line. Если входные данные не из файла, значением этих параметров является InputStream.

Если вам не нужна информация в объекте MatchInfo , используйте параметр Quiet . Параметр Quiet возвращает логическое значение (True или False), указывающее, найдено ли совпадение, а не объект MatchInfo.

При сопоставлении фраз используется текущий язык и региональные параметры, Select-String заданные для системы. Чтобы найти текущий язык и региональные Get-Culture параметры, используйте командлет.

Чтобы найти свойства объекта MatchInfo , введите следующую команду:

Select-String -Path test.txt -Pattern 'test' | Get-Member | Format-List -Property *