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

说明
-----------
此命令为通过管道传递给 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) 中搜索有关 at 符号 (@) 用法的信息。

为了指示路径，此命令使用 $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 cmdlet 在 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"

说明
-----------
此示例在事件查看器的应用程序日志的 100 个最新事件中搜索字符串“failed”。

第一条命令使用 Get-EventLog cmdlet 从应用程序事件日志中获取 100 个最新事件。然后，它将事件存储在 $events 变量中。

第二条命令使用管道运算符 (|) 将 $events 变量中的对象发送到 Select-String。它使用 InputObject 参数代表来自 $events 变量的输入。InputObject 参数的值是每个通过管道传递的对象的 Message 属性。当前对象由 $_ 符号表示。

当每个事件到达管道中时，Select-String 会在它的 Message 属性值中搜索“failed”字符串，然后显示包含匹配项的所有行。

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

说明
-----------
此命令检查 C:\Windows\System32 子目录中所有扩展名为 .txt 的文件，并搜索字符串“Microsoft”。CaseSensitive 参数指明“Microsoft”中的“M”必须大写，其余字符必须小写，以便 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。

第三条命令显示第一个 MatchInfo 对象的 Context 属性中存储的行。它使用数组表示法指明第一个匹配项（在从零开始的数组中为匹配项 0），然后使用 Format-List cmdlet 以列表形式显示 Context 属性的值。

输出内容包括两个 MatchInfo 对象，每个检测到的匹配项一个。上下文行存储在 MatchInfo 对象的 Context 属性中。

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

说明
-----------
此示例说明 Select-String 的 AllMatches 参数的作用。AllMatches 会查找一行中的所有模式匹配，而不是只查找每行中的第一个匹配项。

该示例中的第一条命令在 Windows PowerShell 概念性帮助文件（“about”帮助）中搜索单词“transcript”。第二条命令与之相同，只不过它使用 AllMatches 参数。

第一条命令的输出保存在 $a 变量中，第二条命令的输出保存在 $b 变量中。

当您显示变量的值时，默认显示是相同的，如输出示例中所示。

但是，第五条和第六条命令会显示每个对象的 Matches 属性的值。第一条命令的 Matches 属性只包含一个匹配项（也就是一个 System.Text.RegularExpressions.Match 对象），而第二条命令的 Matches 属性包含该行中两个匹配项的对象。