Sdílet prostřednictvím

Select-String

Modul:
Microsoft.PowerShell.Utility Module

Najde text v řetězcích a souborech.

Syntax

File (Výchozí) 

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

ObjectRaw 

Select-String
    [-Pattern] <String[]>
    -InputObject <PSObject>
    -Raw
    [-Culture <String>]
    [-SimpleMatch]
    [-CaseSensitive]
    [-List]
    [-NoEmphasis]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-NotMatch]
    [-AllMatches]
    [-Encoding <Encoding>]
    [-Context <Int32[]>]
    [<CommonParameters>]

Object 

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

FileRaw 

Select-String
    [-Pattern] <String[]>
    [-Path] <String[]>
    -Raw
    [-Culture <String>]
    [-SimpleMatch]
    [-CaseSensitive]
    [-List]
    [-NoEmphasis]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-NotMatch]
    [-AllMatches]
    [-Encoding <Encoding>]
    [-Context <Int32[]>]
    [<CommonParameters>]

LiteralFileRaw 

Select-String
    [-Pattern] <String[]>
    -LiteralPath <String[]>
    -Raw
    [-Culture <String>]
    [-SimpleMatch]
    [-CaseSensitive]
    [-List]
    [-NoEmphasis]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-NotMatch]
    [-AllMatches]
    [-Encoding <Encoding>]
    [-Context <Int32[]>]
    [<CommonParameters>]

LiteralFile 

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

Description

Rutina Select-String používá k hledání vzorů textu ve vstupních řetězcích a souborech porovnávání regulárních výrazů. Můžete použít Select-String podobné grep v systémech UNIX nebo findstr.exe ve Windows.

Select-String je založen na řádcích textu. Ve výchozím nastavení Select-String najde první shodu v každém řádku a pro každou shodu zobrazí název souboru, číslo řádku a veškerý text na řádku obsahujícím shodu. Můžete přímo Select-String najít více shod na řádek, zobrazovat text před a za shodou nebo zobrazit logickou hodnotu (Pravda nebo Nepravda), která označuje, zda byla nalezena shoda.

Select-String může zobrazit všechny shody nebo zastavení textu po první shodě v každém vstupním souboru. Select-String lze použít k zobrazení veškerého textu, který neodpovídá zadanému vzoru.

Můžete také určit, že Select-String by měly očekávat konkrétní kódování znaků, například při vyhledávání souborů textu Unicode. Select-String pomocí značky bajtů (BOM) rozpozná formát kódování souboru. Pokud soubor neobsahuje boM, předpokládá se, že kódování je UTF8.

Příklady

Příklad 1: Vyhledání shody s rozlišováním velkých a malých písmen

V tomto příkladu se rozlišují malá a velká písmena textu odesílaného kanálu do rutiny Select-String.

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

Textové řetězce Hello a HELLO se odesílají do rutiny Select-String. Select-String používá parametr vzoru k určení HELLO . Parametr CaseSensitive určuje, že velikost písmen se musí shodovat pouze s velkými písmeny. SimpleMatch je volitelný parametr a určuje, že řetězec ve vzoru není interpretován jako regulární výraz. Select-String v konzole PowerShellu zobrazí HELLO.

Příklad 2: Hledání shod v textových souborech

Tento příkaz prohledá všechny soubory s příponou názvu souboru .txt v aktuálním adresáři. Výstup zobrazí řádky v těchto souborech, které obsahují zadaný řetězec.

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

V tomto příkladu se Get-Alias a Get-Command používají s rutinou Out-File k vytvoření dvou textových souborů v aktuálním adresáři, Alias.txt a Command.txt.

Select-String používá parametr Path se zástupným znakem hvězdička (*) k prohledání všech souborů v aktuálním adresáři s příponou názvu souboru .txt. Parametr vzoru určuje text, který se má shodovat s Get-. Select-String zobrazí výstup v konzole PowerShellu. Název souboru a číslo řádku předchází každému řádku obsahu, který obsahuje shodu pro parametr Pattern.

Příklad 3: Vyhledání shody vzorů

V tomto příkladu se prohledá více souborů, aby se vyhledaly shody zadaného vzoru. Vzor používá kvantifikátor regulárního výrazu. Další informace najdete v tématu 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

Rutina Select-String používá dva parametry, Path a Pattern. Parametr Path používá proměnnou $PSHOME, která určuje adresář PowerShellu. Zbytek cesty zahrnuje podadresář en-US a určuje každý *.txt soubor v adresáři. Parametr Pattern určuje, aby odpovídal otazníku (?) v každém souboru. Zpětné lomítko (\) se používá jako řídicí znak a je nezbytné, protože otazník (?) je kvantifikátor regulárního výrazu. Select-String zobrazí výstup v konzole PowerShellu. Název souboru a číslo řádku předchází každému řádku obsahu, který obsahuje shodu pro parametr Pattern.

Příklad 4: Použití Select-String ve funkci

Tento příklad vytvoří funkci, která vyhledá vzor v souborech nápovědy PowerShellu. V tomto příkladu funkce existuje pouze v relaci PowerShellu. Po zavření relace PowerShellu se funkce odstraní. Další informace najdete v tématu 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

Funkce se vytvoří na příkazovém řádku PowerShellu. Příkaz Function používá název Search-Help. Stisknutím klávesy Enter začněte do funkce přidávat příkazy. Na příkazovém řádku >> přidejte jednotlivé příkazy a stiskněte Enter, jak je znázorněno v příkladu. Po přidání koncové závorky se vrátíte do příkazového řádku PowerShellu.

Funkce obsahuje dva příkazy. Proměnná $PSHelp ukládá cestu k souborům nápovědy PowerShellu. $PSHOME je instalační adresář PowerShellu s podadresářem en-US, který určuje každý *.txt soubor v adresáři.

Příkaz Select-String ve funkci používá parametry Path a Pattern. Parametr Path používá k získání cesty proměnnou $PSHelp. Parametr vzoru používá jako kritéria hledání řetězec About_.

Chcete-li funkci spustit, zadejte Search-Help. Příkaz Select-String funkce zobrazí výstup v konzole PowerShellu.

Příklad 5: Vyhledání řetězce v protokolu událostí Systému Windows

Tento příklad vyhledá řetězec v protokolu událostí Systému Windows. Proměnná $_ představuje aktuální objekt v kanálu. Viz about_Automatic_Variablespro více informací.

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

Rutina Get-WinEvent používá k zadání protokolu aplikace parametr LogName. Parametr MaxEvents získá z protokolu 50 nejnovějších událostí. Obsah protokolu je uložen v proměnné s názvem $Events.

Proměnná $Events se odešle do kanálu do rutiny Select-String. Select-String používá parametr InputObject. Proměnná $_ představuje aktuální objekt a message je vlastnost události. Parametr Pattern je typ řetězce Failed a hledá shody v $_.message. Select-String zobrazí výstup v konzole PowerShellu.

Příklad 6: Vyhledání řetězce v podadresářích

Tento příklad prohledá adresář a všechny jeho podadresáře pro konkrétní textový řetězec.

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

Get-ChildItem používá parametr Path k určení C:\Windows\System32*.txt. Parametr Recurse zahrnuje podadresáře. Objekty se odesílají do kanálu Select-String.

Select-String používá parametr vzor a určuje řetězec Microsoft. Parametr CaseSensitive slouží k porovnání přesného případu řetězce. Select-String zobrazí výstup v konzole PowerShellu.

Poznámka:

V závislosti na vašich oprávněních se ve výstupu může zobrazit Odepření přístupu zpráv.

Příklad 7: Vyhledání řetězců, které neodpovídají vzoru

Tento příklad ukazuje, jak vyloučit řádky dat, které neodpovídají vzoru.

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

Rutina Get-Command odešle objekty dolů kanálu do Out-File a vytvoří Command.txt soubor v aktuálním adresáři. Select-String pomocí parametru Path určuje soubor Command.txt. Parametr vzoru určuje Get a Nastavit jako vzor hledání. Parametr NotMatch vyloučí z výsledků Get a Set. Select-String zobrazí výstup v konzole PowerShellu, která nezahrnuje Get nebo Set.

Příklad 8: Vyhledání řádků před a za shodou

Tento příklad ukazuje, jak získat řádky před a za odpovídajícím vzorem.

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

Rutina Get-Command odešle objekty dolů kanálu do Out-File a vytvoří Command.txt soubor v aktuálním adresáři. Select-String pomocí parametru Path určuje soubor Command.txt. Parametr vzoru určuje Get-Computer jako vzor hledání. Parametr Context používá dvě hodnoty, před a za a vzor značky ve výstupu pomocí úhlové závorky (>). Parametr Context vypíše dva řádky před první shodu vzorku a tři řádky za poslední shodu vzorku.

Příklad 9: Vyhledání všech shod vzorů

Tento příklad ukazuje, jak AllMatches parametr najde shodu jednotlivých vzorů v řádku textu. Ve výchozím nastavení Select-String najde pouze první výskyt vzoru v řádku textu. Tento příklad používá vlastnosti objektu nalezené pomocí rutiny 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

Rutina Get-ChildItem používá parametr Path. Parametr Path používá proměnnou $PSHOME, která určuje adresář PowerShellu. Zbytek cesty zahrnuje podadresář en-US a určuje každý *.txt soubor v adresáři. Objekty Get-ChildItem jsou uloženy v proměnné $A. Proměnná $A se odešle do kanálu do rutiny Select-String. Select-String používá parametr Pattern k vyhledání řetězce PowerShellu.

Z příkazového řádku PowerShellu se zobrazí obsah $A proměnných. Existuje řádek, který obsahuje dva výskyty řetězce PowerShellu.

Vlastnost $A.Matches obsahuje první výskyt vzoru powershellu na každém řádku.

Vlastnost $A.Matches.Length počítá první výskyt vzoru PowerShellu na každém řádku.

Proměnná $B používá stejné rutiny Get-ChildItem a Select-String, ale přidá parametr AllMatches. všechny výskyty vzorů najde PowerShellu na každém řádku. Objekty uložené v $A a proměnné $B jsou identické.

Vlastnost $B.Matches.Length se zvyšuje, protože pro každý řádek se počítá každý výskyt vzoru PowerShellu.

Příklad 10 – Převod objektů kanálu na řetězce pomocí out-string

Výsledek ToString() objektu s kanálem není stejná formátovaná řetězcová reprezentace vytvořená systémem formátování PowerShellu. Proto možná budete muset objekty nejprve převést na Out-String.

Piping to Out-String převede formátovaný výstup na jeden objekt víceřádkového řetězce. To znamená, že když Select-String najde shodu, vypíše celý víceřádkový řetězec.

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

Propojení na Out-String -Stream převede formátovaný výstup na více objektů řetězce s jedním řádkem. To znamená, že když Select-String najde shodu, zobrazí se pouze odpovídající řádek.

Parametry

-AllMatches

Označuje, že rutina hledá více než jednu shodu v každém řádku textu. Bez tohoto parametru Select-String najde pouze první shodu v každém řádku textu.

Pokud Select-String najde v řádku textu více než jednu shodu, přesto generuje pouze jeden MatchInfo objekt pro řádek, ale Match vlastnost objektu obsahuje všechny shody.

Poznámka:

Tento parametr je ignorován při použití v kombinaci s parametrem SimpleMatch. Pokud chcete vrátit všechny shody a vzor, který hledáte, obsahuje znaky regulárního výrazu, musíte tyto znaky místo použití SimpleMatch. Další informace o úniku regulárních výrazů najdete v about_Regular_Expressions.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-CaseSensitive

Označuje, že v rutině se rozlišují malá a velká písmena. Ve výchozím nastavení se shody nerozlišují malá a velká písmena.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Context

Zachytí zadaný počet řádků před a za čárou, která odpovídá vzoru.

Pokud jako hodnotu tohoto parametru zadáte jedno číslo, určuje toto číslo počet řádků zachycených před a za shodou. Pokud jako hodnotu zadáte dvě čísla, první číslo určuje počet řádků před shodou a druhé číslo určuje počet řádků za shodou. Například: -Context 2,3.

Ve výchozím zobrazení jsou čáry se shodou označené pravou závorkou (>) (ASCII 62) v prvním sloupci zobrazení. Neznačené řádky jsou kontextem.

Parametr Context nezmění počet objektů vygenerovaných Select-String. Select-String pro každou shodu vygeneruje jeden objekt MatchInfo. Kontext je uložen jako pole řetězců v Context vlastnost objektu.

Když se výstup příkazu Select-String odešle do kanálu do jiného příkazu Select-String, bude přijímající příkaz prohledávat pouze text na odpovídajícím řádku. Odpovídající řádek je hodnota Line vlastnost MatchInfo objektu, nikoli text v kontextových řádcích. Výsledkem je, že parametr Context není platný u přijímajícího příkazu Select-String.

Pokud kontext obsahuje shodu, MatchInfo objekt pro každou shodu zahrnuje všechny kontextové čáry, ale překrývající se čáry se zobrazí pouze jednou v zobrazení.

Vlastnosti parametru

Typ:

Int32[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Culture

Určuje název jazykové verze, který se má shodovat se zadaným vzorem. Parametr jazykové verze musí být použit s parametrem SimpleMatch. Výchozí chování používá jazykovou verzi aktuálního prostředí PowerShell runspace (relace).

Pokud chcete získat seznam všech podporovaných jazykových verzí, použijte příkaz Get-Culture -ListAvailable.

Kromě toho tento parametr přijímá následující argumenty:

  • CurrentCulture, to je výchozí;
  • Řadové, to je nejazyčné binární porovnání;
  • Invariantní, to je nezávislé porovnání jazykové verze.

S příkazem Select-String -Culture Ordinal -CaseSensitive -SimpleMatch získáte nejrychlejší binární porovnání.

Parametr Culture používá k procházení seznamu argumentů, které určují dostupné jazykové verze, dokončování tabulátoru. Pokud chcete zobrazit seznam všech dostupných argumentů, použijte následující příkaz:

(Get-Command Select-String).Parameters.Culture.Attributes.ValidValues

Další informace o vlastnosti .NET CultureInfo.Name naleznete v tématu CultureInfo.Name.

Parametr jazykové verze byl představen v PowerShellu 7.

Vlastnosti parametru

Typ:String
Default value:Culture of the current PowerShell session
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Encoding

Určuje typ kódování cílového souboru. Výchozí hodnota je utf8NoBOM.

Přijatelné hodnoty pro tento parametr jsou následující:

  • ascii: Používá kódování znakové sady ASCII (7bitová).
  • bigendianunicode: Kóduje ve formátu UTF-16 s použitím pořadí bajtů big-endian.
  • bigendianutf32: Kóduje ve formátu UTF-32 s použitím big-endian bajtového pořadí.
  • oem: Používá výchozí kódování pro MS-DOS a konzolové programy.
  • unicode: Kóduje ve formátu UTF-16 pomocí pořadí malých bajtů.
  • utf7: Kóduje ve formátu UTF-7.
  • utf8: Kóduje ve formátu UTF-8.
  • utf8BOM: Kódování ve formátu UTF-8 pomocí značky pořadí bajtů (BOM)
  • utf8NoBOM: Kódování ve formátu UTF-8 bez značky pořadí bajtů (BOM)
  • utf32: Kóduje ve formátu UTF-32.

Počínaje PowerShellem 6.2 umožňuje parametr Encoding také číselné ID registrovaných znakových stránek (například -Encoding 1251) nebo názvy řetězců registrovaných znakových stránek (například -Encoding "windows-1251"). Další informace naleznete v dokumentaci .NET pro Encoding.CodePage.

Poznámka:

UTF-7* se už nedoporučuje používat. Od PowerShellu 7.1 se zapíše upozornění, pokud pro parametr utf7 zadáte .

Vlastnosti parametru

Typ:Encoding
Default value:UTF8NoBOM
Přípustné hodnoty:ASCII, BigEndianUnicode, BigEndianUTF32, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Exclude

Vyloučí zadané položky. Hodnota tohoto parametru kvalifikuje parametr Path. Zadejte prvek cesty nebo vzor, například *.txt. Jsou povoleny zástupné symboly.

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:True
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Include

Zahrnuje zadané položky. Hodnota tohoto parametru kvalifikuje parametr Path. Zadejte prvek cesty nebo vzor, například *.txt. Jsou povoleny zástupné symboly.

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:True
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-InputObject

Určuje text, který se má prohledávat. Zadejte proměnnou, která obsahuje text, nebo zadejte příkaz nebo výraz, který získá text.

Použití parametru InputObject není totéž jako odesílání řetězců směrem dolů do kanálu do Select-String.

Když předáte více než jeden řetězec do rutiny Select-String, vyhledá zadaný text v každém řetězci a vrátí každý řetězec, který obsahuje hledaný text.

Když použijete parametr InputObject k odeslání kolekce řetězců, Select-String zachází s kolekcí jako s jedním kombinovaným řetězcem. Select-String vrátí řetězce jako jednotku, pokud najde hledaný text v libovolném řetězci.

FileInfo objekty jsou považovány za cestu k souboru. Při zadání cest k souborům Select-String prohledá obsah souboru, nikoli ToString() reprezentaci objektu.

Vlastnosti parametru

Typ:PSObject
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

Object
Position:Named
Povinné:True
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
ObjectRaw
Position:Named
Povinné:True
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-List

Z každého vstupního souboru se vrátí pouze první instance odpovídajícího textu. Toto je nejúčinnější způsob, jak načíst seznam souborů, které mají obsah odpovídající regulárnímu výrazu.

Ve výchozím nastavení Select-String vrátí MatchInfo objekt pro každou nalezenou shodu.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-LiteralPath

Určuje cestu k souborům, které se mají prohledávat. Hodnota parametru LiteralPath se používá přesně tak, jak je zadaný. Žádný znak není interpretován jako zástupný znak. Pokud cesta obsahuje únikové znaky, uzavřete ji do jednoduchých uvozovek. Jednoduché uvozovky říkají PowerShellu, aby žádné znaky neinterpretoval jako únikové sekvence. Další informace najdete v about_Quoting_Rules.

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:PSPath, PO

Sady parametrů

LiteralFileRaw
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False
LiteralFile
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-NoEmphasis

Ve výchozím nastavení Select-String zvýrazní řetězec, který odpovídá vzoru, který jste hledali, s parametrem pattern. Parametr NoEmphasis zakáže zvýraznění.

Důraz používá záporné barvy na základě pozadí PowerShellu a barev textu. Pokud jsou například barvy PowerShellu černé pozadí s bílým textem. Zvýraznění je bílé pozadí s černým textem.

Tento parametr byl představen v PowerShellu 7.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-NotMatch

Parametr NotMatch najde text, který neodpovídá zadanému vzoru.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Path

Určuje cestu k souborům, které se mají prohledávat. Jsou povoleny zástupné symboly. Výchozí umístění je místní adresář.

Zadejte soubory v adresáři, například log1.txt, *.docnebo *.*. Pokud zadáte jenom adresář, příkaz selže.

Vlastnosti parametru

Typ:

String[]

Default value:Local directory
Podporuje zástupné znaky:True
DontShow:False

Sady parametrů

File
Position:1
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False
FileRaw
Position:1
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Pattern

Určuje text, který se má najít na každém řádku. Hodnota vzoru se považuje za regulární výraz.

Informace o regulárních výrazech najdete v tématu about_Regular_Expressions.

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Quiet

Označuje, že rutina vrací logickou hodnotu (True nebo False) namísto objektu MatchInfo . Hodnota je True, pokud je vzor nalezen; v opačném případě je hodnota False.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

File
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
Object
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
LiteralFile
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Raw

Způsobí, že rutina vypíše pouze odpovídající řetězce, nikoli MatchInfo objekty. Výsledkem je chování, které je nejvíce podobné příkazům grep Unix nebo Windows findstr.exe.

Tento parametr byl představen v PowerShellu 7.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

ObjectRaw
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
FileRaw
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
LiteralFileRaw
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-SimpleMatch

Označuje, že rutina používá jednoduchou shodu místo shody regulárního výrazu. V jednoduché shodě Select-String prohledá vstup textu v parametru Pattern. Neinterpretuje hodnotu parametru Pattern jako příkaz regulárního výrazu.

Při použití SimpleMatch je vlastnost Match vráceného objektu MatchInfo prázdná.

Poznámka:

Při použití tohoto parametru s parametrem AllMatches se AllMatches ignoruje.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

PSObject

Do této rutiny můžete připojit libovolný objekt, který má ToString() metodu.

Výstupy

MatchInfo

Ve výchozím nastavení vrátí tato rutina MatchInfo objekt pro každou nalezenou shodu.

Boolean

Pokud použijete parametr Quiet, vrátí tato rutina logickou hodnotu označující, jestli byl vzor nalezen.

String

Pokud použijete parametr Raw, vrátí tato rutina sadu objektů String, které odpovídají vzoru.

Poznámky

PowerShell obsahuje následující aliasy pro Select-String:

  • Všechny platformy:
    • sls

Select-String se podobá grep v systému UNIX nebo findstr.exe ve Windows.

Alias sls pro rutinu Select-String byl zaveden v PowerShellu 3.0.

Poznámka:

Podle schválených příkazů PowerShelluje oficiální předpona aliasu pro rutiny Select-*sc, nikoli sl. Proto by měl být správný alias pro Select-Stringscs, nikoli sls. Toto pravidlo je výjimkou.

Při propojení objektů do Select-String:

  • FileInfo objekty jsou považovány za cestu k souboru. Při zadání cest k souborům Select-String prohledá obsah souboru, nikoli ToString() reprezentaci objektu.
  • Výsledek ToString() objektu s kanálem není stejná formátovaná řetězcová reprezentace vytvořená systémem formátování PowerShellu. Proto možná budete muset objekty nejprve převést na Out-String. Další informace naleznete v příkladu 10.

Pokud chcete použít Select-String, zadejte text, který chcete najít jako hodnotu parametru Pattern. Chcete-li zadat hledaný text, použijte následující kritéria:

  • Zadejte text do uvozovaného řetězce a potom ho vložte do Select-String.
  • Uložte textový řetězec do proměnné a pak zadejte proměnnou jako hodnotu InputObject parametru.
  • Pokud je text uložen v souborech, pomocí parametru Path určete cestu k souborům.

Ve výchozím nastavení Select-String interpretuje hodnotu parametru Pattern jako regulární výraz. Další informace najdete v tématu about_Regular_Expressions. K přepsání porovnávání regulárních výrazů můžete použít parametr SimpleMatch. Parametr SimpleMatch vyhledá instance hodnoty parametru Pattern ve vstupu.

Výchozí výstup Select-String je objekt MatchInfo, který obsahuje podrobné informace o shodách. Informace v objektu jsou užitečné při hledání textu v souborech, protože MatchInfo objekty mají vlastnosti, jako je Název souboru a řádek. Pokud vstup ze souboru není, hodnota těchto parametrů je InputStream.

Pokud nepotřebujete informace v objektu MatchInfo, použijte parametr Quiet. Parametr Quiet vrátí logickou hodnotu (True nebo False), která označuje, jestli našla shodu, a ne MatchInfo objektu.

Při porovnávání frází Select-String používá aktuální jazykovou verzi nastavenou pro systém. Pokud chcete najít aktuální jazykovou verzi, použijte rutinu Get-Culture.

Chcete-li najít vlastnosti MatchInfo objektu, zadejte následující příkaz:

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