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 cmdlet 使用正则表达式匹配来搜索输入字符串和文件中的文本模式。 可以使用类似于 Unix 中的 Select-String 或 Windows 中的 grepfindstr.exe。

Select-String 基于文本行。 默认情况下，Select-String 在每个行中查找第一个匹配项，并且对于每个匹配项，它显示包含匹配项的行中的文件名、行号和所有文本。 可以指示 Select-String 查找每行的多个匹配项、在匹配前后显示文本，或显示指示是否找到匹配项的布尔值（True 或 False）。

Select-String 可以在每个输入文件中的第一个匹配项之后显示所有文本匹配项或停止。 Select-String 可用于显示与指定模式不匹配的所有文本。

还可以指定 Select-String 应需要特定的字符编码，例如在搜索 Unicode 文本的文件时。 Select-String 使用字节顺序标记（BOM）来检测文件的编码格式。 如果文件没有 BOM，则假定编码为 UTF8。

此示例对将管道发送到 Select-String cmdlet 的文本执行区分大小写的匹配。

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

Hello 和 HELLO 的文本字符串将向下发送到 Select-String cmdlet。 Select-String 使用 Pattern 参数来指定 HELLO。 CaseSensitive 参数指定大小写必须仅匹配大写模式。 SimpleMatch 是一个可选参数，指定模式中的字符串不会解释为正则表达式。 Select-String PowerShell 控制台中显示 HELLO。

此命令搜索当前目录中具有 .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 cmdlet 一起使用，在当前目录中创建两个文本文件，Alias.txt 和 Command.txt。

Select-String 使用带星号（）通配符的 * 参数搜索当前目录中具有文件扩展名 .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 cmdlet 使用两个参数：Path 和 Pattern。 Path 参数使用指定 PowerShell 目录的变量 $PSHOME。 路径的其余部分包括子目录 en-US，并指定目录中的每个 *.txt 文件。 Pattern 参数指定在每个文件中匹配问号（?）。 反斜杠（\）用作转义字符，这是必要的，因为问号（?）是正则表达式限定符。 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 开始向函数添加语句。 在 >> 提示符下，添加每个语句，然后按 Enter，如示例中所示。 添加右括号后，将返回到 PowerShell 提示符。

该函数包含两个命令。 $PSHelp 变量存储 PowerShell 帮助文件的路径。 $PSHOME 是 PowerShell 安装目录，其中包含指定目录中每个 文件的子目录 *.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 cmdlet 使用 LogName 参数来指定应用程序日志。 MaxEvents 参数从日志中获取 50 个最新事件。 日志内容存储在名为 $Events的变量中。

$Events 变量将管道向下发送到 Select-String cmdlet。 Select-String 使用 InputObject 参数。 $_ 变量表示当前对象，Message 是事件的一个属性。 Pattern 参数指定字符串 失败 并在 $_.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 cmdlet 将对象向下发送到 Out-File，以在当前目录中创建 Command.txt 文件。 Select-String 使用 Path 参数指定 Command.txt 文件。 Pattern 参数将 获取 和 设置为搜索模式。 NotMatch 参数从结果中排除 获取 和 集。 Select-String 在 PowerShell 控制台中显示不包含 获取 或 设置的输出。

此示例演示如何在匹配模式前后获取行。

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 cmdlet 将对象向下发送到 Out-File，以在当前目录中创建 Command.txt 文件。 Select-String 使用 Path 参数指定 Command.txt 文件。 Pattern 参数将 Get-Computer 指定为搜索模式。 Context 参数使用两个值，前后使用尖括号（>）标记输出中的模式匹配项。 Context 参数输出第一个模式匹配之前的两行，最后一个模式匹配后的三行。

此示例演示如何 AllMatches 参数查找文本行中的每个模式匹配项。 默认情况下，Select-String 仅在文本行中找到模式的第一个匹配项。 此示例使用通过 Get-Member cmdlet 找到的对象属性。

$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 cmdlet 使用 Path 参数。 Path 参数使用指定 PowerShell 目录的变量 $PSHOME。 路径的其余部分包括子目录 en-US，并指定目录中的每个 *.txt 文件。 Get-ChildItem 对象存储在 $A 变量中。 $A 变量将管道向下发送到 Select-String cmdlet。 Select-String 使用 Pattern 参数在 PowerShell 搜索字符串的每个文件。

从 PowerShell 命令行显示 $A 变量内容。 有一行包含两个字符串的匹配项，PowerShell。

$A.Matches 属性列出了每个行上第一个模式 PowerShell 匹配项。

$A.Matches.Length 属性计算每行上第一个模式 PowerShell 匹配项。

$B 变量使用相同的 Get-ChildItem 和 Select-String cmdlet，但添加 AllMatches 参数。 AllMatches 在每个行中查找每个模式 PowerShell。 存储在 $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 找到匹配项时，它只输出匹配行。

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

可以通过管道将具有 ToString() 方法的任何对象传递给此 cmdlet。

默认情况下，此 cmdlet 为每个找到的匹配项返回 MatchInfo 对象。

使用 Quiet 参数时，此 cmdlet 返回一个 布尔 值，该值指示是否已找到模式。

使用 Raw 参数时，此 cmdlet 将返回一组与模式匹配的 字符串 对象。

PowerShell 包含以下与 Select-String相关的别名：

• 所有平台：
  • sls

Select-String 类似于 Unix 中的 grep 或在 Windows 中 findstr.exe。

sls cmdlet 的 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 cmdlet。

若要查找 MatchInfo 对象的属性，请键入以下命令：

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