Select-String

Moduł:

Microsoft.PowerShell.Utility

Znajduje tekst w ciągach i plikach.

Składnia

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

Opis

Polecenie Select-String cmdlet wyszukuje wzorce tekstowe i tekstowe w ciągach wejściowych i plikach. Możesz użyć podobnego Select-String do grep w systemie UNIX lub findstr.exe w systemie Windows.

Select-String jest oparta na wierszach tekstu. Domyślnie Select-String znajduje pierwsze dopasowanie w każdym wierszu, a dla każdego dopasowania wyświetla nazwę pliku, numer wiersza i cały tekst w wierszu zawierającym dopasowanie. Możesz bezpośrednio Select-String znaleźć wiele dopasowań na wiersz, wyświetlić tekst przed dopasowaniem lub wyświetlić wartość logiczną (prawda lub fałsz), która wskazuje, czy znaleziono dopasowanie.

Select-String używa dopasowania wyrażeń regularnych, ale może również wykonywać dopasowanie, które wyszukuje dane wejściowe dla określonego tekstu.

Select-String może wyświetlać wszystkie dopasowania tekstowe lub zatrzymywać się po pierwszym dopasowaniu w każdym pliku wejściowym. Select-String może służyć do wyświetlania całego tekstu, który nie jest zgodny z określonym wzorcem.

Można również określić, że Select-String powinno się spodziewać określonego kodowania znaków, na przykład podczas wyszukiwania plików tekstu Unicode. Select-String używa znaku byte-order-mark (BOM) do wykrywania formatu kodowania pliku. Jeśli plik nie ma modelu BOM, przyjmuje się, że kodowanie to UTF8.

Przykłady

Przykład 1. Znajdowanie dopasowania uwzględniającego wielkość liter

W tym przykładzie jest uwzględniana wielkość liter dopasowania tekstu, który został wysłany w dół potoku Select-String do polecenia cmdlet.

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

Ciągi tekstowe Hello i HELLO są wysyłane w dół potoku Select-String do polecenia cmdlet. Select-String używa parametru Pattern w celu określenia funkcji HELLO. Parametr CaseSensitive określa, że wielkość liter musi być zgodna tylko ze wzorcem wielkie litery. SimpleMatch jest opcjonalnym parametrem i określa, że ciąg w wzorcu nie jest interpretowany jako wyrażenie regularne. Select-String wyświetla wartość HELLO w konsoli programu PowerShell.

Przykład 2. Znajdowanie dopasowań w plikach tekstowych

To polecenie wyszukuje wszystkie pliki z .txt rozszerzeniem nazwy pliku w bieżącym katalogu. Dane wyjściowe wyświetlają wiersze w tych plikach, które zawierają określony ciąg.

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

W tym przykładzie Get-AliasOut-File i Get-Command są używane z poleceniem cmdlet do tworzenia dwóch plików tekstowych w bieżącym katalogu, Alias.txt i Command.txt.

Select-String używa parametru Path z symbolem wieloznacznymi gwiazdki (*), aby przeszukać wszystkie pliki w bieżącym katalogu z rozszerzeniem .txtnazwy pliku . Parametr Pattern określa tekst zgodny z poleceniem Get-. Select-String wyświetla dane wyjściowe w konsoli programu PowerShell. Nazwa pliku i numer wiersza poprzedzają każdy wiersz zawartości, który zawiera dopasowanie parametru Pattern .

Przykład 3. Znajdowanie dopasowania wzorca

W tym przykładzie przeszukano wiele plików, aby znaleźć dopasowania dla określonego wzorca. Wzorzec używa kwantyfikatora wyrażenia regularnego. Aby uzyskać więcej informacji, zobacz 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

Polecenie Select-String cmdlet używa dwóch parametrów: Path (Ścieżka ) i Pattern (Wzorzec). Parametr Path używa zmiennej $PSHOME , która określa katalog programu PowerShell. Pozostała część ścieżki zawiera podkatalog en-US i określa każdy *.txt plik w katalogu. Parametr Pattern określa, aby pasować do znaku zapytania (?) w każdym pliku. Ukośnik odwrotny (\) jest używany jako znak ucieczki i jest niezbędny, ponieważ znak zapytania (?) jest kwantyfikatorem wyrażenia regularnego. Select-String wyświetla dane wyjściowe w konsoli programu PowerShell. Nazwa pliku i numer wiersza poprzedzają każdy wiersz zawartości, który zawiera dopasowanie parametru Pattern .

Przykład 4. Używanie Select-String w funkcji

W tym przykładzie tworzona jest funkcja do wyszukiwania wzorca w plikach pomocy programu PowerShell. W tym przykładzie funkcja istnieje tylko w sesji programu PowerShell. Po zamknięciu sesji programu PowerShell funkcja zostanie usunięta. Aby uzyskać więcej informacji, zobacz 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.

Funkcja jest tworzona w wierszu polecenia programu PowerShell. Polecenie Function używa nazwy Search-Help. Naciśnij klawisz Enter, aby rozpocząć dodawanie instrukcji do funkcji. W wierszu polecenia dodaj każdą instrukcję >> i naciśnij klawisz Enter , jak pokazano w przykładzie. Po dodaniu nawiasu zamykającego następuje powrót do wiersza polecenia programu PowerShell.

Funkcja zawiera dwa polecenia. Zmienna $PSHelp przechowuje ścieżkę do plików pomocy programu PowerShell. $PSHOME to katalog instalacyjny programu PowerShell z podkatalogiem en-US , który określa każdy *.txt plik w katalogu.

Polecenie Select-String w funkcji używa parametrów Ścieżka i Wzorzec . Parametr Path używa zmiennej $PSHelp do pobrania ścieżki. Parametr Pattern używa ciągu About_ jako kryteriów wyszukiwania.

Aby uruchomić funkcję, wpisz Search-Help. Polecenie funkcji Select-String wyświetla dane wyjściowe w konsoli programu PowerShell.

Przykład 5: Search dla ciągu w dzienniku zdarzeń systemu Windows

W tym przykładzie wyszukiwany jest ciąg w dzienniku zdarzeń systemu Windows. Zmienna $_ reprezentuje bieżący obiekt w potoku. Aby uzyskać więcej informacji, zobacz about_Automatic_Variables.

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

Polecenie Get-WinEvent cmdlet używa parametru LogName do określenia dziennika aplikacji. Parametr MaxEvents pobiera 50 najnowszych zdarzeń z dziennika. Zawartość dziennika jest przechowywana w zmiennej o nazwie $Events.

Zmienna $Events jest wysyłana w dół potoku Select-String do polecenia cmdlet. Select-String używa parametru InputObject . Zmienna $_ reprezentuje bieżący obiekt i message jest właściwością zdarzenia. Parametr Pattern gatunków ciąg Nie powiodło się i wyszukuje dopasowania w elemecie $_.message. Select-String wyświetla dane wyjściowe w konsoli programu PowerShell.

Przykład 6. Znajdowanie ciągu w podkatalogach

W tym przykładzie przeszukuje katalog i wszystkie jego podkatalogi dla określonego ciągu tekstowego.

Get-ChildItem -Path C:\Windows\System32\*.txt -Recurse | Select-String -Pattern 'Microsoft' -CaseSensitive

Get-ChildItem używa parametru Ścieżka , aby określić C:\Windows\System32*.txt. Parametr Recurse zawiera podkatalogi . Obiekty są wysyłane w dół potoku do Select-String.

Select-String używa parametru Pattern i określa ciąg Microsoft. Parametr CaseSensitive jest używany do dopasowania dokładnego przypadku ciągu. Select-String wyświetla dane wyjściowe w konsoli programu PowerShell.

Uwaga

W danych wyjściowych mogą pojawić się komunikaty odmowy dostępu .

Przykład 7. Znajdowanie ciągów, które nie pasują do wzorca

W tym przykładzie pokazano, jak wykluczyć wiersze danych, które nie pasują do wzorca.

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

Polecenie Get-Command cmdlet wysyła obiekty w dół potoku do Out-File obiektu , aby utworzyć plik Command.txt w bieżącym katalogu. Select-String używa parametru Ścieżka , aby określić plik Command.txt . Parametr Wzorzec określa polecenie Get i Set jako wzorzec wyszukiwania. Parametr NotMatch wyklucza polecenie Get i Set z wyników. Select-String wyświetla dane wyjściowe w konsoli programu PowerShell, która nie zawiera polecenia Pobierz lub Ustaw.

Przykład 8. Znajdowanie wierszy przed dopasowaniem i po nim

W tym przykładzie pokazano, jak uzyskać wiersze przed i po dopasowanym wzorcu.

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

Polecenie Get-Command cmdlet wysyła obiekty w dół potoku do Out-File obiektu , aby utworzyć plik Command.txt w bieżącym katalogu. Select-String używa parametru Ścieżka , aby określić plik Command.txt . Parametr Pattern określa Get-Computer jako wzorzec wyszukiwania. Parametr Context używa dwóch wartości przed i po, a wzorzec oznacza dopasowanie w danych wyjściowych z nawiasem kątowym (>). Parametr Context zwraca dwa wiersze przed pierwszym dopasowaniem wzorca i trzema wierszami po dopasowaniu ostatniego wzorca.

Przykład 9. Znajdowanie wszystkich dopasowań wzorca

W tym przykładzie pokazano, jak parametr AllMatches znajduje każdy wzorzec pasuje do wiersza tekstu. Domyślnie Select-String znajduje tylko pierwsze wystąpienie wzorca w wierszu tekstu. W tym przykładzie użyto właściwości obiektu znalezionych za pomocą Get-Member polecenia 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

Polecenie Get-ChildItem cmdlet używa parametru Ścieżka . Parametr Path używa zmiennej $PSHOME , która określa katalog programu PowerShell. Pozostała część ścieżki zawiera podkatalog en-US i określa każdy *.txt plik w katalogu. Obiekty Get-ChildItem są przechowywane w zmiennej $A . Zmienna $A jest wysyłana w dół potoku Select-String do polecenia cmdlet. Select-String używa parametru Pattern do wyszukiwania każdego pliku dla ciągu programu PowerShell.

W wierszu polecenia programu PowerShell wyświetlana jest zawartość zmiennej $A . Istnieje wiersz zawierający dwa wystąpienia ciągu programu PowerShell.

Właściwość $A.Matches zawiera listę pierwszego wystąpienia wzorca programu PowerShell w każdym wierszu.

Właściwość $A.Matches.Length zlicza pierwsze wystąpienie wzorca programu PowerShell w każdym wierszu.

Zmienna $B używa tych samych Get-ChildItem poleceń cmdlet i Select-String , ale dodaje parametr AllMatches . Element AllMatches znajduje każde wystąpienie wzorca programu PowerShell w każdym wierszu. Obiekty przechowywane w zmiennych $A i $B są identyczne.

Właściwość $B.Matches.Length zwiększa się, ponieważ dla każdego wiersza każde wystąpienie wzorca programu PowerShell jest liczone.

Parametry

-AllMatches

Wskazuje, że polecenie cmdlet wyszukuje więcej niż jedno dopasowanie w każdym wierszu tekstu. Bez tego parametru Select-String znajduje tylko pierwsze dopasowanie w każdym wierszu tekstu.

W Select-String przypadku znalezienia więcej niż jednego dopasowania w wierszu tekstu nadal emituje tylko jeden obiekt MatchInfo dla wiersza, ale właściwość MatchInfo obiektu zawiera wszystkie dopasowania.

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

-CaseSensitive

Wskazuje, że dopasowanie polecenia cmdlet jest uwzględniane w wielkości liter. Domyślnie dopasowania nie są uwzględniane wielkości liter.

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

-Context

Przechwytuje określoną liczbę wierszy przed i po wierszu zgodnym ze wzorcem.

Jeśli wprowadzisz jedną liczbę jako wartość tego parametru, ta liczba określa liczbę wierszy przechwyconych przed dopasowaniem i po nim. Jeśli wprowadzisz dwie liczby jako wartość, pierwsza liczba określa liczbę wierszy przed dopasowaniem, a druga liczba określa liczbę wierszy po dopasowaniu. Na przykład -Context 2,3.

Na ekranie domyślnym linie z dopasowaniem są oznaczone nawiasem prawym kątem (>) (ASCII 62) w pierwszej kolumnie ekranu. Nieoznaczone wiersze są kontekstem.

Parametr Context nie zmienia liczby obiektów generowanych przez Select-Stringelement . Select-String generuje jeden obiekt MatchInfo dla każdego dopasowania. Kontekst jest przechowywany jako tablica ciągów we właściwości Context obiektu.

Gdy dane wyjściowe Select-String polecenia są wysyłane w dół potoku do innego Select-String polecenia, odbierające polecenie wyszukuje tylko tekst w dopasowanym wierszu. Dopasowany wiersz jest wartością właściwości Line obiektu MatchInfo , a nie tekstem w wierszach kontekstu. W związku z tym parametr Kontekstu nie jest prawidłowy w poleceniu odbierania Select-String .

Gdy kontekst zawiera dopasowanie, obiekt MatchInfo dla każdego dopasowania zawiera wszystkie wiersze kontekstu, ale nakładające się wiersze są wyświetlane tylko raz na ekranie.

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

-Encoding

Określa typ kodowania dla pliku docelowego. Wartość domyślna to Domyślna.

Dopuszczalne wartości tego parametru są następujące:

• ASCII Używa zestawu znaków ASCII (7-bitowego).
• Bigendianunicode Używa utF-16 z kolejnością bajtów big-endian.
• Domyślny Używa kodowania odpowiadającego aktywnej stronie kodu systemu (zwykle ANSI).
• OEM Używa kodowania odpowiadającego bieżącej stronie kodu OEM systemu.
• Unicode Używa utF-16 z małą kolejnością bajtów endian.
• UTF7 Używa protokołu UTF-7.
• UTF8 Używa protokołu UTF-8.
• UTF32 Używa utF-32 z małą kolejnością bajtów.

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

Wyklucz określone elementy. Wartość tego parametru kwalifikuje parametr Path . Wprowadź element ścieżki lub wzorzec, taki jak *.txt. Dozwolone są symbole wieloznaczne.

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

-Include

Zawiera określone elementy. Wartość tego parametru kwalifikuje parametr Path . Wprowadź element ścieżki lub wzorzec, taki jak *.txt. Dozwolone są symbole wieloznaczne.

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

-InputObject

Określa tekst, który ma zostać przeszukany. Wprowadź zmienną zawierającą tekst lub wpisz polecenie lub wyrażenie, które pobiera tekst.

Użycie parametru InputObject nie jest takie samo jak wysyłanie ciągów w dół potoku do Select-String.

Gdy potokujesz więcej niż jeden ciąg do Select-String polecenia cmdlet, wyszukuje określony tekst w każdym ciągu i zwraca każdy ciąg zawierający tekst wyszukiwania.

Gdy używasz parametru InputObject do przesyłania kolekcji ciągów, Select-String traktuje kolekcję jako pojedynczy połączony ciąg. Select-String zwraca ciągi jako jednostkę, jeśli znajdzie tekst wyszukiwania w dowolnym ciągu.

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

-List

Tylko pierwsze wystąpienie pasującego tekstu jest zwracane z każdego pliku wejściowego. Jest to najbardziej wydajny sposób pobierania plików listy, które mają zawartość zgodną z wyrażeniem regularnym.

Domyślnie Select-String zwraca obiekt MatchInfo dla każdego znalezionego dopasowania.

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

-LiteralPath

Określa ścieżkę do przeszukiwanych plików. Wartość parametru LiteralPath jest używana dokładnie tak, jak jest typowana. Znaki nie są interpretowane jako symbole wieloznaczne. Jeśli ścieżka zawiera znaki ucieczki, należy je ująć w pojedynczy cudzysłów. Znaki pojedynczego cudzysłowu informują program PowerShell, aby nie interpretował żadnych znaków jako sekwencji ucieczki. Aby uzyskać więcej informacji, zobacz about_Quoting_Rules.

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

-NotMatch

Parametr NotMatch znajduje tekst, który nie jest zgodny z określonym wzorcem.

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

-Path

Określa ścieżkę do plików do wyszukiwania. Dozwolone są symbole wieloznaczne. Domyślną lokalizacją jest katalog lokalny.

Określ pliki w katalogu, takie jak log1.txt, *.doclub *.*. Jeśli określisz tylko katalog, polecenie zakończy się niepowodzeniem.

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

-Pattern

Określa tekst do znalezienia w każdym wierszu. Wpisz ciąg lub wyrażenie regularne. Jeśli wpiszesz ciąg, użyj parametru SimpleMatch .

Aby dowiedzieć się więcej o wyrażeniach regularnych, zobacz about_Regular_Expressions.

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

-Quiet

Wskazuje, że polecenie cmdlet zwraca wartość logiczną (Prawda lub Fałsz), zamiast obiektu MatchInfo . Wartość ma wartość True, jeśli wzorzec zostanie znaleziony; w przeciwnym razie wartość to False.

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

-SimpleMatch

Wskazuje, że polecenie cmdlet używa prostego dopasowania, a nie dopasowania wyrażenia regularnego. W prostym dopasowaniu Select-String wyszukuje tekst w parametrze Pattern . Nie interpretuje wartości parametru Pattern jako instrukcji wyrażenia regularnego.

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

Dane wejściowe

PSObject

Możesz potokować dowolny obiekt, który ma metodę ToString do Select-String.

Dane wyjściowe

Microsoft.PowerShell.Commands.MatchInfo or System.Boolean

Domyślnie dane wyjściowe są zestawem obiektów MatchInfo z jednym dla każdego znalezionego dopasowania. Jeśli używasz parametru Quiet , dane wyjściowe są wartością logiczną wskazującą, czy wzorzec został znaleziony.

Uwagi

Select-String jest podobny do grep w systemie UNIX lub findstr.exe w systemie Windows.

Alias sls dla Select-String polecenia cmdlet został wprowadzony w programie PowerShell 3.0.

Uwaga

Zgodnie z zatwierdzonymi czasownikami poleceń programu PowerShell oficjalny prefiks aliasu dla Select-* poleceń cmdlet to sc, a nie sl. W związku z tym odpowiedni alias dla Select-String elementu powinien mieć wartość scs, a nie sls. Jest to wyjątek dla tej reguły.

Aby użyć Select-Stringmetody , wpisz tekst, który chcesz znaleźć jako wartość parametru Pattern . Aby określić tekst do wyszukania, użyj następujących kryteriów:

• Wpisz tekst w ciągu cytowanym, a następnie przejmij go do Select-String.
• Zapisz ciąg tekstowy w zmiennej, a następnie określ zmienną jako wartość parametru InputObject .
• Jeśli tekst jest przechowywany w plikach, użyj parametru Ścieżka , aby określić ścieżkę do plików.

Domyślnie Select-String interpretuje wartość parametru Pattern jako wyrażenie regularne. (Aby uzyskać więcej informacji, zobacz about_Regular_Expressions. Możesz użyć parametru SimpleMatch , aby zastąpić dopasowanie wyrażenia regularnego. Parametr SimpleMatch znajduje wystąpienia wartości parametru Pattern w danych wejściowych.

Domyślne dane wyjściowe to Select-String obiekt MatchInfo , który zawiera szczegółowe informacje o dopasowaniach. Informacje w obiekcie są przydatne podczas wyszukiwania tekstu w plikach, ponieważ obiekty MatchInfo mają właściwości, takie jak Nazwa pliku i Linia. Gdy dane wejściowe nie pochodzą z pliku, wartość tych parametrów to InputStream.

Jeśli nie potrzebujesz informacji w obiekcie MatchInfo , użyj parametru Quiet . Parametr Quiet zwraca wartość logiczną (Prawda lub Fałsz), aby wskazać, czy znaleziono dopasowanie, zamiast obiektu MatchInfo .

Podczas dopasowywania fraz Select-String używa bieżącej kultury ustawionej dla systemu. Aby znaleźć bieżącą kulturę, użyj polecenia cmdlet Get-Culture.

Aby znaleźć właściwości obiektu MatchInfo , wpisz następujące polecenie:

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

Linki powiązane

• about_Automatic_Variables
• about_Comparison_Operators
• about_Functions
• about_Quoting_Rules
• about_Regular_Expressions
• Get-Alias
• Get-ChildItem
• Get-Command
• Get-Member
• Get-WinEvent
• Out-File