Select-String

參考

模組:: Microsoft.PowerShell.Utility

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

Syntax

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>]

Description

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

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

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。

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 是具有 子目錄 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 的物件屬性。

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

屬性 $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-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

-Culture

指定要符合指定模式的文化特性名稱。 Culture 參數必須與 SimpleMatch 參數搭配使用。默認行為會使用目前 PowerShell Runspace (工作階段) 的文化特性。

若要取得所有支援文化特性的清單，請使用 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。

Culture 參數是在 PowerShell 7 中引進的。

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：使用大位元組位元組順序以UTF-16格式編碼。
bigendianutf32：使用大位元組位元組順序以UTF-32格式編碼。
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 檔。

注意

不再建議使用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() 方法的任何物件傳送至這個 Cmdlet。

輸出

MatchInfo

根據預設，此 Cmdlet 會針對找到的每個相符項目傳回 MatchInfo 物件。

Boolean

當您使用 Quiet 參數時，這個 Cmdlet 會傳回布爾值，指出是否已找到模式。

String

當您使用 Raw 參數時，此 Cmdlet 會傳回一組符合模式的 String 物件。

備註

PowerShell 包含下列的 Select-String別名：

所有平台：
- sls

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

Cmdlet sls 的 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 物件具有檔名和 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 *

共用方式為

Select-String

Syntax

Description

範例

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

輸入

輸出

備註

其他資源

共用方式為

Select-String

Syntax

Description

範例

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

輸入

輸出

備註

相關連結

其他資源