共用方式為

Select-String

  • 參考
模組:
Microsoft.PowerShell.Utility

尋找字串和檔案中的文字。

Syntax

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

Description

Cmdlet 會 Select-String 搜尋輸入字串和檔案中的文字和文字模式。 您可以在 Select-String UNIX 中使用類似 grep ，或在 Windows 中使用 findstr.exe 。

Select-String 是以文字行為基礎。 根據預設， Select-String 會在每一行中尋找第一個相符專案，而且針對每個相符專案，它會在包含相符專案的行中顯示檔名、行號和所有文字。 您可以直接 Select-String 尋找每行的多個相符項目、顯示比對前後的文字，或顯示布爾值 (True 或 False) ，指出是否找到相符專案。

Select-String 會使用正則表示式比對，但也可以執行比對，以搜尋您指定的文字。

Select-String 可以在每個輸入檔的第一個相符項目之後顯示所有文字相符專案或停止。 Select-String 可用來顯示不符合指定模式的所有文字。

您也可以指定應該 Select-String 預期特定的字元編碼，例如當您搜尋 Unicode 文字的檔案時。 Select-String 會使用位元組順序標記 (BOM) 來偵測檔案的編碼格式。 如果檔案沒有 BOM，則會假設編碼方式為 UTF8。

範例

範例 1：尋找區分大小寫的相符專案

此範例會執行區分大小寫的文字比對，該文字會向下傳送至 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 。

範例 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

在這裡範例中Out-File，Get-Alias和 Get-Command 會與 Cmdlet 搭配使用，在目前目錄中建立兩個文字檔， 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。

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

PS> Search-Help

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

函式會在PowerShell命令行上建立。 此命令Function會使用名稱 搜尋-Help。 按 Enter 開始將語句新增至函式。 >>從提示字元中，新增每個語句，然後按 Enter，如範例所示。 在新增右括弧之後，您會回到PowerShell提示字元。

函式包含兩個命令。 變數 $PSHelp 會儲存PowerShell說明檔的路徑。 $PSHOME 是具有 子目錄 en-US 的 PowerShell 安裝目錄，指定目錄中的每個 *.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 會在不包含 Get 或 Set 的 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 只會在一行文字中尋找第一個出現的模式。 這個範例會使用 Cmdlet 找到 Get-Member 的物件屬性。

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

PS> $A

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

PS> $A.Matches

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

PS> $A.Matches.Length

8

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

PS> $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 模式。 儲存在和 $B 變數中的$A物件完全相同。

屬性 $B.Matches.Length 會隨著每一行而增加，因此會計算每次出現的 PowerShell 模式。

參數

-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-StringSelect-String命令時，接收的命令只會搜尋相符行中的文字。 相符行是 MatchInfo 物件的 Line 屬性值，而不是內容行中的文字。 因此， Context 參數在接收 Select-String 命令上無效。

當內容包含相符專案時，每個相符專案的 MatchInfo 物件都會包含所有內容行，但重疊的行只會出現在顯示中一次。

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

-Encoding

指定目標檔案的編碼類型。 預設值是 utf8NoBOM。

此參數可接受的值如下所示：

  • ascii：使用 ASCII (7 位) 字元集的編碼方式。
  • bigendianunicode：使用大位元組位元組順序以UTF-16格式編碼。
  • oem：使用 MS-DOS 和控制台程式的預設編碼方式。
  • unicode：使用小位元節順序以UTF-16格式編碼。
  • utf7：以 UTF-7 格式編碼。
  • utf8：以 UTF-8 格式編碼。
  • utf8BOM：使用位元節順序標記 (BOM) ，以 UTF-8 格式編碼
  • utf8NoBOM：以 UTF-8 格式編碼，不含位元組順序標記 (BOM)
  • utf32：以 UTF-32 格式編碼。

從 PowerShell 6.2 開始， Encoding 參數也允許已註冊代碼頁的數值標識符， (例如 -Encoding 1251) 或已註冊代碼頁的字串名稱 (，例如 -Encoding "windows-1251") 。 如需詳細資訊，請參閱 Encoding.CodePage 的 .NET 檔。

Type:Encoding
Accepted values:ASCII, BigEndianUnicode, 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 如果字串在任何字串中尋找搜尋文字，則會以單位傳回字串。

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

-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

-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 or System.Boolean

根據預設，輸出是一組 MatchInfo 物件，每個相符專案都有一個。 如果您使用 Quiet 參數，則輸出是布爾值，指出是否已找到模式。

備註

Select-String 類似於 UNIX 中的 grep ，或在 Windows 中 findstr.exe 。

Cmdlet 的 Select-Stringsls 別名是在 PowerShell 3.0 中引進。

注意

根據 PowerShell 命令的核准動詞，Cmdlet 的官方別名前置 Select-* 詞是 sc，而不是 sl。 因此，的適當別名 Select-String 應該是 scs，而不是 sls。 這是此規則的例外狀況。

若要使用 Select-String，請輸入您想要尋找的文字做為 Pattern 參數的值。 若要指定要搜尋的文字，請使用下列準則：

  • 在引號字串中輸入文字，然後將它傳送至 Select-String。
  • 將文字字串儲存在變數中，然後將變數指定為 InputObject 參數的值。
  • 如果文字儲存在檔案中，請使用 Path 參數來指定檔案的路徑。

根據預設， Select-String將 Pattern 參數的值解譯為正則表示式。 如需詳細資訊，請參閱 about_Regular_Expressions。 您可以使用 SimpleMatch 參數來覆寫正規表示式比對。 SimpleMatch 參數會尋找輸入中 Pattern 參數值的實例。

的預設輸出 Select-String 是 MatchInfo 物件，其中包含相符專案的詳細資訊。 當您在檔案中搜尋文字時，對象中的資訊很有用，因為 MatchInfo 物件具有 檔名 和 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 *