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) 以找出 @ 符號用法的相關資訊。

為了包含路徑，這個命令使用 $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 屬性則包含行中兩個相符項目的物件。