Select-String

参考

模块:: Microsoft.PowerShell.Utility

在字符串和文件中查找文本。

语法

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

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

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

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

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

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

说明

cmdlet Select-String 使用正则表达式匹配在输入字符串和文件中搜索文本模式。可以在 Select-String UNIX 或 findstr.exe Windows 中使用类似的 grep 。

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

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

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

示例

示例 1：查找区分大小写的匹配项

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

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

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

示例 2：在文本文件中查找匹配项

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

Select-String 使用带星号的 Path 参数 (*) 通配符搜索当前目录中文件扩展名 .txt为的所有文件。 Pattern 参数指定要与 Get-匹配的文本。 Select-String 在 PowerShell 控制台中显示输出。文件名和行号位于包含 Pattern 参数匹配项的每个内容行之前。

示例 3：查找模式匹配项

在此示例中，搜索多个文件以查找指定模式的匹配项。模式使用正则表达式限定符。有关详细信息，请参阅 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

cmdlet Select-String 使用两个参数： Path 和 Pattern。 Path 参数使用指定 PowerShell 目录的变量$PSHOME。路径的其余部分包括子目录 en-US ，并指定目录中的每个 *.txt 文件。 Pattern 参数指定匹配每个文件中的问号 (?) 。反斜杠 (\) 用作转义字符，并且是必需的，因为) (? 问号是正则表达式限定符。 Select-String 在 PowerShell 控制台中显示输出。文件名和行号位于包含 Pattern 参数匹配项的每个内容行之前。

示例 4：在函数中使用 Select-String

此示例创建一个函数，用于在 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 安装目录，其子目录 en-US 指定目录中的每个 *.txt 文件。

Select-String函数中的命令使用 Path 和 Pattern 参数。 Path 参数使用 $PSHelp 变量来获取路径。 Pattern 参数使用字符串About_作为搜索条件。

若要运行函数，请键入 Search-Help。函数的 Select-String 命令在 PowerShell 控制台中显示输出。

示例 5：windows 事件日志中字符串的搜索

此示例在 Windows 事件日志中搜索字符串。变量 $_ 表示管道中的当前对象。有关详细信息，请参阅 about_Automatic_Variables。

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

cmdlet Get-WinEvent 使用 LogName 参数指定应用程序日志。 MaxEvents 参数从日志中获取 50 个最新事件。日志内容存储在名为的 $Events变量中。

变量 $Events 在管道中向下发送到 Select-String cmdlet。 Select-String 使用 InputObject 参数。变量 $_ 表示当前对象，是 message 事件的属性。 Pattern 参数对字符串“失败”进行种种，并在中$_.message搜索匹配项。 Select-String 在 PowerShell 控制台中显示输出。

示例 6：在子目录中查找字符串

此示例在目录及其所有子目录中搜索特定文本字符串。

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 控制台中显示输出。

注意

根据你的权限，你可能会在输出中看到 “拒绝访问” 消息。

示例 7：查找与模式不匹配的字符串

此示例演示如何排除与模式不匹配的数据行。

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

cmdlet Get-Command 将对象向下发送到管道， Out-File 以在当前目录中创建 Command.txt 文件。 Select-String 使用 Path 参数指定 Command.txt 文件。 Pattern 参数将 Get 和 Set 指定为搜索模式。 NotMatch 参数从结果中排除 Get 和 Set。 Select-String 在 PowerShell 控制台中显示不包含 “获取” 或 “设置”的输出。

示例 8：查找匹配项前后的线条

此示例演示如何获取匹配模式前后的线条。

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

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

示例 9：查找所有模式匹配项

此示例演示 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

cmdlet Get-ChildItem 使用 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 的每次出现次数。

示例 10 - 使用“Out-String”将管道对象转换为字符串

管道 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 ，它仅输出匹配行。

参数

-AllMatches

指示 cmdlet 在每行文本中搜索多个匹配项。如果没有此参数， Select-String 则仅查找每行文本中的第一个匹配项。

在一行文本中找到多个匹配项时 Select-String ，它仍然只为该行发出一个 MatchInfo 对象，但对象的 Matchs 属性包含所有匹配项。

注意

与 SimpleMatch 参数结合使用时，将忽略此参数。如果要返回所有匹配项，并且要搜索的模式包含正则表达式字符，则必须转义这些字符，而不是使用 SimpleMatch。有关转义正则表达式的详细信息，请参阅about_Regular_Expressions 。

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CaseSensitive

指示 cmdlet 匹配项区分大小写。默认情况下，匹配项不区分大小写。

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Context

捕获与模式匹配的行之前和之后的指定行数。

如果你输入一个数字作为此参数的值，则该数字将确定捕获的匹配项前后的行数。如果你输入两个数字作为此参数的值，则第一个数字将确定该匹配项前面的行数，第二个数字将确定该匹配项后面的行数。例如 -Context 2,3。

在默认显示中，带有匹配项的行由直尖括号 (>) (显示的第一列中的 ASCII 62) 指示。无标记行是上下文。

Context 参数不会更改生成的Select-String对象数。 Select-String 为每个匹配生成一个 MatchInfo 对象。上下文作为字符串数组存储在对象的 Context 属性中。

当命令 Select-String 的输出沿管道发送到另一个 Select-String 命令时，接收命令仅搜索匹配行中的文本。匹配行是 MatchInfo 对象的 Line 属性的值，而不是上下文行中的文本。因此， Context 参数在接收 Select-String 命令上无效。

当上下文包含匹配项时，每个匹配项的 MatchInfo 对象包括所有上下文行，但重叠的线条在显示中只显示一次。

Type:	Int32[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Culture

指定与指定模式匹配的区域性名称。 Culture 参数必须与 SimpleMatch 参数一起使用。默认行为使用当前 PowerShell 运行空间的区域性 (会话) 。

若要获取所有受支持的区域性的列表，请使用 Get-Culture -ListAvailable 命令。

此外，此参数接受以下参数：

CurrentCulture，默认值为;
序号，即非语言二进制比较;
固定，即与区域性无关的比较。

使用 Select-String -Culture Ordinal -CaseSensitive -SimpleMatch 命令，可以获得最快的二进制比较。

Culture 参数使用 Tab 补全功能滚动浏览指定可用区域性的参数列表。若要列出所有可用参数，请使用以下命令：

(Get-Command Select-String).Parameters.Culture.Attributes.ValidValues

有关 .NET CultureInfo.Name 属性的详细信息，请参阅 CultureInfo.Name。

PowerShell 7 中引入了 Culture 参数。

Type:	String
Position:	Named
Default value:	Culture of the current PowerShell session
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Encoding

指定目标文件的编码类型。默认值为 utf8NoBOM。

此参数的可接受值如下所示：

ascii：使用 ASCII (7 位) 字符集的编码。
bigendianunicode：使用 big-endian 字节顺序以 UTF-16 格式进行编码。
bigendianutf32：使用 big-endian 字节顺序以 UTF-32 格式进行编码。
oem：使用 MS-DOS 和控制台程序的默认编码。
unicode：使用 little-endian 字节顺序以 UTF-16 格式进行编码。
utf7：以 UTF-7 格式进行编码。
utf8：以 UTF-8 格式进行编码。
utf8BOM：使用字节顺序标记 (BOM) 以 UTF-8 格式进行编码
utf8NoBOM：以 UTF-8 格式编码，不带字节顺序标记 (BOM)
utf32：以 UTF-32 格式进行编码。

从 PowerShell 6.2 开始， Encoding 参数还允许使用已注册代码页的数字 ID (如 -Encoding 1251) 或已注册代码页的字符串名称 () -Encoding "windows-1251" 。有关详细信息，请参阅 Encoding.CodePage 的 .NET 文档。

注意

不再建议使用 UTF-7*。从 PowerShell 7.1 起，如果为 Encoding 参数指定utf7，则会写入警告。

Type:	Encoding
Accepted values:	ASCII, BigEndianUnicode, BigEndianUTF32, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32
Position:	Named
Default value:	UTF8NoBOM
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Exclude

排除指定项。此参数值使 Path 参数有效。请输入路径元素或模式，例如 *.txt。允许使用通配符。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-Include

包括指定项。此参数值使 Path 参数有效。请输入路径元素或模式，例如 *.txt。允许使用通配符。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-InputObject

指定要搜索的文本。输入一个包含该文本的变量，或键入可获取该文本的命令或表达式。

使用 InputObject 参数与将字符串向下发送到管道 Select-String不同。

通过管道将多个字符串传递给 Select-String cmdlet 时，它会在每个字符串中搜索指定的文本，并返回包含搜索文本的每个字符串。

使用 InputObject 参数提交字符串集合时， Select-String 将集合视为单个组合字符串。 Select-String 如果字符串在任何字符串中找到搜索文本，则返回作为一个单位的字符串。

FileInfo 对象被视为文件的路径。指定文件路径时， Select-String 搜索文件的内容，而不是 ToString() 对象的表示形式。

Type:	PSObject
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-List

仅从每个输入文件返回匹配文本的第一个实例。这是检索内容与正则表达式匹配的文件列表的最有效方法。

默认情况下， Select-String 为找到的每个匹配项返回一个 MatchInfo 对象。

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LiteralPath

指定要搜索的文件的路径。 LiteralPath 参数的值与键入时完全相同。不会将任何字符解释为通配符。如果路径包括转义符，请将其括在单引号中。单引号告知 PowerShell 不要将任何字符解释为转义序列。有关详细信息，请参阅 about_Quoting_Rules。

Type:	String[]
Aliases:	PSPath, LP
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-NoEmphasis

默认情况下， Select-String 突出显示与使用 Pattern 参数搜索的模式匹配的字符串。 NoEmphasis 参数禁用突出显示。

强调使用基于 PowerShell 背景和文本颜色的负色。例如，如果 PowerShell 颜色是带白色文本的黑色背景。重点为带黑色文本的白色背景。

此参数是在 PowerShell 7 中引入的。

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NotMatch

NotMatch 参数查找与指定模式不匹配的文本。

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

指定要搜索的文件的路径。允许使用通配符。默认位置为本地目录。

指定目录中的文件，例如 log1.txt、 *.doc或 *.*。如果仅指定一个目录，则该命令将失败。

Type:	String[]
Position:	1
Default value:	Local directory
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	True

-Pattern

指定要在每行上查找的文本。模式值被视为正则表达式。

若要了解正则表达式，请参阅 about_Regular_Expressions。

Type:	String[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Quiet

指示 cmdlet 返回一个布尔值 (True 或 False) ，而不是 MatchInfo 对象。如果找到模式，则值为 True;否则，值为 False。

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Raw

使 cmdlet 仅输出匹配的字符串，而不是 MatchInfo 对象。这是最类似于 Unix grep 或 Windows findstr.exe 命令的行为的结果。

此参数是在 PowerShell 7 中引入的。

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-SimpleMatch

指示 cmdlet 使用简单匹配而不是正则表达式匹配。在简单匹配中， Select-String 在 Pattern 参数中搜索输入的文本。它不会将 Pattern 参数的值解释为正则表达式语句。

此外，使用 SimpleMatch 时，返回的 MatchInfo 对象的 Matchs 属性为空。

注意

当此参数与 AllMatches 参数一起使用时，将忽略 AllMatches 。

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

输入

PSObject

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

输出

Microsoft.PowerShell.Commands.MatchInfo, System.Boolean, System.String

默认情况下，输出是一组 MatchInfo 对象，每个匹配项都有一个。如果使用 Quiet 参数，则输出是一个布尔值，指示是否已找到该模式。如果使用 Raw 参数，则输出是一组与模式匹配的 String 对象。

备注

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

sls cmdlet 的Select-String别名是在 PowerShell 3.0 中引入的。

注意

根据 PowerShell 命令的已批准谓词，cmdlet 的官方别名前缀 Select-* 为 sc，而不是 sl。因此，的正确 Select-String 别名应为 scs，而不是 sls。这是此规则的例外。

将对象管道连接到 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 *

Share via

Select-String

语法

说明

示例

示例 1：查找区分大小写的匹配项

示例 2：在文本文件中查找匹配项

示例 3：查找模式匹配项

示例 4：在函数中使用 Select-String

示例 5：windows 事件日志中字符串的搜索

示例 6：在子目录中查找字符串

示例 7：查找与模式不匹配的字符串

示例 8：查找匹配项前后的线条

示例 9：查找所有模式匹配项

示例 10 - 使用“Out-String”将管道对象转换为字符串

参数

-AllMatches

-CaseSensitive

-Context

-Culture

-Encoding

-Exclude

-Include

-InputObject

-List

-LiteralPath

-NoEmphasis

-NotMatch

-Path

-Pattern

-Quiet

-Raw

-SimpleMatch

输入

输出

备注

其他资源

Share via

Select-String

语法

说明

示例

示例 1：查找区分大小写的匹配项

示例 2：在文本文件中查找匹配项

示例 3：查找模式匹配项

示例 4：在函数中使用 Select-String

示例 5：windows 事件日志中字符串的搜索

示例 6：在子目录中查找字符串

示例 7：查找与模式不匹配的字符串

示例 8：查找匹配项前后的线条

示例 9：查找所有模式匹配项

示例 10 - 使用“Out-String”将管道对象转换为字符串

参数

-AllMatches

-CaseSensitive

-Context

-Culture

-Encoding

-Exclude

-Include

-InputObject

-List

-LiteralPath

-NoEmphasis

-NotMatch

-Path

-Pattern

-Quiet

-Raw

-SimpleMatch

输入

输出

备注

相关链接

其他资源