共用方式為

Select-String

  • 參考
模組:
Microsoft.PowerShell.Utility

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

Syntax

Select-String
      [-Pattern] <string[]>
      [-Path] <string[]>
      [-SimpleMatch]
      [-CaseSensitive]
      [-Quiet]
      [-List]
      [-Include <string[]>]
      [-Exclude <string[]>]
      [-NotMatch]
      [-AllMatches]
      [-Encoding <string>]
      [-Context <Int32[]>]
      [<CommonParameters>]
Select-String
      [-Pattern] <string[]>
      -InputObject <psobject>
      [-SimpleMatch]
      [-CaseSensitive]
      [-Quiet]
      [-List]
      [-Include <string[]>]
      [-Exclude <string[]>]
      [-NotMatch]
      [-AllMatches]
      [-Encoding <string>]
      [-Context <Int32[]>]
      [<CommonParameters>]
Select-String
      [-Pattern] <string[]>
      -LiteralPath <string[]>
      [-SimpleMatch]
      [-CaseSensitive]
      [-Quiet]
      [-List]
      [-Include <string[]>]
      [-Exclude <string[]>]
      [-NotMatch]
      [-AllMatches]
      [-Encoding <string>]
      [-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 會向下傳送至 Cmdlet。Select-String 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。

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

PS> Search-Help

C:\Windows\System32\WindowsPowerShell\v1.0\en-US\about_ActivityCommonParameters.help.txt:2:   about_ActivityCommonParameters
C:\Windows\System32\WindowsPowerShell\v1.0\en-US\about_ActivityCommonParameters.help.txt:31:  see about_WorkflowCommonParameters.
C:\Windows\System32\WindowsPowerShell\v1.0\en-US\about_ActivityCommonParameters.help.txt:33:  about_CommonParameters.

函式會在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 會向下傳送至 Cmdlet 的 Select-String 管線。 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:1186:Cmdlet          Get-CmsMessage            3.0.0.0    Microsoft.PowerShell.Security
  Command.txt:1187:Cmdlet          Get-Command               3.0.0.0    Microsoft.PowerShell.Core
> Command.txt:1188:Cmdlet          Get-ComputerInfo          3.1.0.0    Microsoft.PowerShell.Management
> Command.txt:1189:Cmdlet          Get-ComputerRestorePoint  3.1.0.0    Microsoft.PowerShell.Management
  Command.txt:1190:Cmdlet          Get-Content               3.1.0.0    Microsoft.PowerShell.Management
  Command.txt:1191:Cmdlet          Get-ControlPanelItem      3.1.0.0    Microsoft.PowerShell.Management
  Command.txt:1192:Cmdlet          Get-Counter               3.0.0.0    Microsoft.PowerShell.Diagnostics

Cmdlet 會將 Get-Command 物件向下傳送至 Out-File 管線，以在目前目錄中建立 Command.txt 檔案。 Select-String 會使用 Path 參數來指定 Command.txt 檔案。 Pattern 參數會將 Get-Computer 指定為搜尋模式。 Context 參數會使用兩個值，在前後使用角括弧 () > 標記輸出中的模式比對。 Context 參數會輸出第一個模式比對之前的兩行，以及最後一個模式比對後的三行。

範例 9：尋找所有模式相符專案

此範例示範 AllMatches 參數如何在一行文字中尋找每個模式相符專案。 根據預設， Select-String 只會在一行文字中尋找第一個出現的圖樣。 此範例會使用搭配 Get-Member Cmdlet 找到的物件屬性。

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

PS> $A

C:\Windows\System32\WindowsPowerShell\v1.0\en-US\about_ActivityCommonParameters.help.txt:5:    Describes the parameters that Windows PowerShell
C:\Windows\System32\WindowsPowerShell\v1.0\en-US\about_ActivityCommonParameters.help.txt:9:    Windows PowerShell Workflow adds the activity common

PS> $A.Matches

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

PS> $A.Matches.Length

2073

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

PS> $B.Matches.Length

2200

Cmdlet 會 Get-ChildItem 使用 Path 參數。 Path 參數會使用指定 PowerShell 目錄的變數$PSHOME。 路徑的其餘部分包含子目錄 en-US ，並指定目錄中的每個 *.txt 檔案。 物件 Get-ChildItem 會儲存在變數中 $A 。 變數 $A 會向下傳送至 Cmdlet 的 Select-String 管線。 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 屬性包含所有相符專案。

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

-Encoding

指定目標檔案的編碼類型。 預設值為 Default。

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

  • Ascii 使用 ASCII (7 位) 字元集。
  • BigEndianUnicode 使用UTF-16搭配位元組位元組順序。
  • 預設 使用對應至系統使用中代碼頁的編碼， (通常是 ANSI) 。
  • Oem 使用對應至系統目前 OEM 代碼頁的編碼方式。
  • Unicode 使用UTF-16搭配位元組位元組順序。
  • UTF7 使用UTF-7。
  • UTF8 使用UTF-8。
  • UTF32 使用UTF-32搭配位元組位元組順序。
Type:String
Accepted values:ASCII, BigEndianUnicode, Default, OEM, Unicode, UTF7, UTF8, UTF32
Position:Named
Default value:Default
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
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

指定要在每個行上尋找的文字。 輸入字串或規則運算式。 如果您輸入字串，請使用 SimpleMatch 參數。

若要瞭解正則表達式，請參閱 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 參數的值解譯為正則表達式語句。

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 物件具有 Filename 和 Line 等屬性。 當輸入不是來自檔案時，這些參數的值會是 InputStream。

如果您不需要 MatchInfo 物件中的資訊，請使用 Quiet 參數。 Quiet 參數會傳回 Boolean 值， (True 或 False) ，指出它是否找到相符專案，而不是 MatchInfo 物件。

比對片語時， Select-String 會使用針對系統設定的目前文化特性。 若要尋找目前的文化特性，請使用 Get-Culture Cmdlet。

若要尋找 MatchInfo 物件的屬性，請輸入下列命令：

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