Select-String
Localiza texto em cadeias de caracteres e arquivos.
Sintaxe
File (Predefinição)
Select-String
[-Pattern] <string[]>
[-Path] <string[]>
[-SimpleMatch]
[-CaseSensitive]
[-Quiet]
[-List]
[-Include <string[]>]
[-Exclude <string[]>]
[-NotMatch]
[-AllMatches]
[-Encoding <string>]
[-Context <Int32[]>]
[<CommonParameters>]
Object
Select-String
[-Pattern] <string[]>
-InputObject <psobject>
[-SimpleMatch]
[-CaseSensitive]
[-Quiet]
[-List]
[-Include <string[]>]
[-Exclude <string[]>]
[-NotMatch]
[-AllMatches]
[-Encoding <string>]
[-Context <Int32[]>]
[<CommonParameters>]
LiteralFile
Select-String
[-Pattern] <string[]>
-LiteralPath <string[]>
[-SimpleMatch]
[-CaseSensitive]
[-Quiet]
[-List]
[-Include <string[]>]
[-Exclude <string[]>]
[-NotMatch]
[-AllMatches]
[-Encoding <string>]
[-Context <Int32[]>]
[<CommonParameters>]
Description
O Select-String cmdlet procura texto e padrões de texto em cadeias de caracteres e arquivos de entrada. Você pode usar Select-String semelhante ao grep no UNIX ou findstr.exe no Windows.
Select-String baseia-se em linhas de texto. Por padrão, Select-String localiza a primeira correspondência em cada linha e, para cada correspondência, exibe o nome do arquivo, o número da linha e todo o texto na linha que contém a correspondência. Você pode direcionar Select-String para encontrar várias correspondências por linha, exibir texto antes e depois da correspondência ou exibir um valor booleano (True ou False) que indica se uma correspondência foi encontrada.
Select-String usa a correspondência de expressão regular, mas também pode executar uma correspondência que pesquisa a entrada para o texto que você especificar.
Select-String pode exibir todas as correspondências de texto ou parar após a primeira correspondência em cada arquivo de entrada.
Select-String pode ser usado para exibir todo o texto que não corresponde ao padrão especificado.
Você também pode especificar que Select-String deve esperar uma codificação de caracteres específica, como quando você está pesquisando arquivos de texto Unicode.
Select-String usa a marca de ordem de bytes (BOM) para detetar o formato de codificação do arquivo. Se o arquivo não tiver BOM, ele assume que a codificação é UTF8.
Exemplos
Exemplo 1: Encontrar uma correspondência que diferencia maiúsculas de minúsculas
Este exemplo faz uma correspondência que diferencia maiúsculas de minúsculas do texto que foi enviado pelo pipeline para o cmdlet Select-String.
'Hello', 'HELLO' | Select-String -Pattern 'HELLO' -CaseSensitive -SimpleMatch
As cadeias de caracteres de texto Hello e HELLO são enviadas pelo pipeline para o cmdlet Select-String.
Select-String usa o parâmetro Pattern para especificar HELLO. O parâmetro CaseSensitive especifica que as maiúsculas e minúsculas devem corresponder apenas ao padrão maiúsculo.
SimpleMatch é um parâmetro opcional e especifica que a cadeia de caracteres no padrão não é interpretada como uma expressão regular.
Select-String exibe HELLO no console do PowerShell.
Exemplo 2: Localizar correspondências em ficheiros de texto
Este comando pesquisa todos os arquivos com a extensão de nome de arquivo .txt no diretório atual. A saída exibe as linhas nesses arquivos que incluem a cadeia de caracteres especificada.
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
Neste exemplo, Get-Alias e Get-Command são usados com o cmdlet Out-File para criar dois arquivos de texto no diretório atual, Alias.txt e Command.txt.
Select-String usa o parâmetro Path com o curinga asterisco (*) para pesquisar todos os arquivos no diretório atual com a extensão de nome de arquivo .txt. O parâmetro Pattern especifica o texto a ser correspondido Get-.
Select-String exibe a saída no console do PowerShell. O nome do arquivo e o número da linha precedem cada linha de conteúdo que contém uma correspondência para o parâmetro Pattern.
Exemplo 3: Encontrar uma correspondência de padrão
Neste exemplo, vários arquivos são pesquisados para encontrar correspondências para o padrão especificado. O padrão usa um quantificador de expressão regular. Para obter mais informações, consulte 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
O cmdlet Select-String usa dois parâmetros, Path e Pattern. O parâmetro Path usa a variável $PSHOME que especifica o diretório do PowerShell. O restante do caminho inclui o subdiretório en-US e especifica cada arquivo *.txt no diretório. O parâmetro Pattern especifica para corresponder a um ponto de interrogação (?) em cada arquivo. Uma barra invertida (\) é usada como um caractere de escape e é necessária porque o ponto de interrogação (?) é um quantificador de expressão regular.
Select-String exibe a saída no console do PowerShell. O nome do arquivo e o número da linha precedem cada linha de conteúdo que contém uma correspondência para o parâmetro Pattern.
Exemplo 4: Usar Select-String em uma função
Este exemplo cria uma função para procurar um padrão nos arquivos de ajuda do PowerShell. Neste exemplo, a função só existe na sessão do PowerShell. Quando a sessão do PowerShell é fechada, a função é excluída. Para obter mais informações, consulte 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.
A função é criada na linha de comando do PowerShell. O Function comando usa o nome Search-Help. Pressione Enter para começar a adicionar instruções à função. No prompt >>, adicione cada instrução e pressione Enter como mostrado no exemplo. Depois que o colchete de fechamento for adicionado, você retornará a um prompt do PowerShell.
A função contém dois comandos. A variável $PSHelp armazena o caminho para os arquivos de ajuda do PowerShell.
$PSHOME é o diretório de instalação do PowerShell com o subdiretório en-US que especifica cada arquivo de *.txt no diretório.
O comando Select-String na função usa os parâmetros Path e Pattern. O parâmetro Path usa a variável $PSHelp para obter o caminho. O parâmetro Pattern usa a cadeia de caracteres About_ como critério de pesquisa.
Para executar a função, digite Search-Help. O comando Select-String da função exibe a saída no console do PowerShell.
Exemplo 5: Procurar uma cadeia de caracteres num registo de eventos do Windows
Este exemplo procura uma cadeia de caracteres em um log de eventos do Windows. A variável $_ representa o objeto atual no pipeline. Para obter mais informações, consulte sobre_Variáveis_Automáticas.
$Events = Get-WinEvent -LogName Application -MaxEvents 50
$Events | Select-String -InputObject {$_.message} -Pattern 'Failed'
O cmdlet Get-WinEvent usa o parâmetro LogName para especificar o log do aplicativo. O parâmetro MaxEvents obtém os 50 eventos mais recentes do log. O conteúdo do log é armazenado na variável chamada $Events.
A variável $Events é enviada pelo pipeline para o cmdlet Select-String.
Select-String usa o parâmetro InputObject. A variável $_ representa o objeto atual e message é uma propriedade do evento. O parâmetro Pattern espécie a cadeia de caracteres Failed e procura correspondências em $_.message.
Select-String exibe a saída no console do PowerShell.
Exemplo 6: Localizar uma cadeia de caracteres em subdiretórios
Este exemplo pesquisa um diretório e todos os seus subdiretórios em busca de uma cadeia de caracteres de texto específica.
Get-ChildItem -Path C:\Windows\System32\*.txt -Recurse | Select-String -Pattern 'Microsoft' -CaseSensitive
Get-ChildItem usa o parâmetro Path para especificar C:\Windows\System32*.txt. O parâmetro Recurse inclui os subdiretórios. Os objetos são enviados pela canalização para Select-String.
Select-String usa o parâmetro Pattern e especifica a cadeia de caracteres Microsoft. O parâmetro CaseSensitive é usado para corresponder ao caso exato da cadeia de caracteres.
Select-String exibe a saída no console do PowerShell.
Observação
Dependendo de suas permissões, você pode ver acesso negado mensagens na saída.
Exemplo 7: Localizar cadeias de caracteres que não correspondem a um padrão
Este exemplo mostra como excluir linhas de dados que não correspondem a um padrão.
Get-Command | Out-File -FilePath .\Command.txt
Select-String -Path .\Command.txt -Pattern 'Get', 'Set' -NotMatch
O cmdlet Get-Command envia objetos pelo pipeline para o Out-File criar o arquivo Command.txt no diretório atual.
Select-String usa o parâmetro Path para especificar o arquivo Command.txt. O parâmetro Pattern especifica Get e set como o padrão de pesquisa. O parâmetro NotMatch exclui Get e set dos resultados.
Select-String exibe a saída no console do PowerShell que não inclui Get ou set.
Exemplo 8: Localizar linhas antes e depois de uma partida
Este exemplo mostra como obter as linhas antes e depois do padrão correspondente.
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
O cmdlet Get-Command envia objetos pelo pipeline para o Out-File criar o arquivo Command.txt no diretório atual.
Select-String usa o parâmetro Path para especificar o arquivo Command.txt. O parâmetro Pattern especifica Get-Computer como o padrão de pesquisa. O parâmetro Context usa dois valores, antes e depois, e marca correspondências de padrão na saída com um colchete angular (>). O parâmetro Context produz as duas linhas antes da primeira correspondência de padrão e três linhas após a última correspondência de padrão.
Exemplo 9: Localizar todas as correspondências de padrão
Este exemplo mostra como o parâmetro AllMatches localiza cada correspondência de padrão em uma linha de texto. Por padrão, Select-String só encontra a primeira ocorrência de um padrão em uma linha de texto. Este exemplo usa propriedades de objeto encontradas com o cmdlet Get-Member.
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
O cmdlet Get-ChildItem usa o parâmetro Path. O parâmetro Path usa a variável $PSHOME que especifica o diretório do PowerShell. O restante do caminho inclui o subdiretório en-US e especifica cada arquivo *.txt no diretório. Os objetos Get-ChildItem são armazenados na variável $A. A variável $A é enviada pelo pipeline para o cmdlet Select-String.
Select-String usa o parâmetro Pattern para pesquisar cada arquivo para a cadeia de caracteres PowerShell.
Na linha de comando do PowerShell, o conteúdo da variável $A é exibido. Há uma linha que contém duas ocorrências da cadeia de caracteres PowerShell.
A propriedade $A.Matches lista a primeira ocorrência do padrão PowerShell em cada linha.
A propriedade $A.Matches.Length conta a primeira ocorrência do padrão PowerShell em cada linha.
A variável $B usa os mesmos cmdlets Get-ChildItem e Select-String, mas adiciona o parâmetro AllMatches.
AllMatches localiza cada ocorrência do padrão PowerShell em cada linha. Os objetos armazenados nas variáveis $A e $B são idênticos.
A propriedade $B.Matches.Length aumenta porque, para cada linha, todas as ocorrências do padrão PowerShell são contadas.
Parâmetros
-AllMatches
Indica que o cmdlet procura mais de uma correspondência em cada linha de texto. Sem esse parâmetro, Select-String encontra apenas a primeira correspondência em cada linha de texto.
Quando Select-String encontra mais de uma correspondência em uma linha de texto, ele ainda emite apenas um objeto MatchInfo para a linha, mas a propriedade Matches do objeto contém todas as correspondências.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-CaseSensitive
Indica que as correspondências do cmdlet diferenciam maiúsculas de minúsculas. Por padrão, as correspondências não diferenciam maiúsculas de minúsculas.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Context
Captura o número especificado de linhas antes e depois da linha que corresponde ao padrão.
Se você inserir um número como o valor desse parâmetro, esse número determinará o número de linhas capturadas antes e depois da correspondência. Se introduzir dois números como valor, o primeiro número determina o número de linhas antes da correspondência e o segundo número determina o número de linhas após a correspondência. Por exemplo, -Context 2,3.
No visor predefinido, as linhas com uma correspondência são indicadas por um colchete angular reto (>) (ASCII 62) na primeira coluna do ecrã. Linhas não marcadas são o contexto.
O parâmetro Context não altera o número de objetos gerados por Select-String.
Select-String gera um objeto MatchInfo para cada correspondência. O contexto é armazenado como uma matriz de cadeias de caracteres na propriedade Context do objeto.
Quando a saída de um comando Select-String é enviada pelo pipeline para outro comando Select-String, o comando de recebimento pesquisa apenas o texto na linha correspondente. A linha correspondente é o valor da propriedade Line do objeto MatchInfo, não o texto nas linhas de contexto. Como resultado, o parâmetro Context não é válido no comando Select-String de recebimento.
Quando o contexto inclui uma correspondência, o objeto MatchInfo para cada correspondência inclui todas as linhas de contexto, mas as linhas sobrepostas aparecem apenas uma vez na exibição.
Propriedades dos parâmetros
| Tipo: | Int32[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Encoding
Especifica o tipo de codificação para o arquivo de destino. O valor padrão é Default.
Os valores aceitáveis para este parâmetro são os seguintes:
- ASCII usa o conjunto de caracteres ASCII (7 bits).
- BigEndianUnicode usa UTF-16 com a ordem de bytes big-endian.
- Default Usa a codificação que corresponde à página de código ativa do sistema (geralmente ANSI).
- OEM Usa a codificação que corresponde à página de código OEM atual do sistema.
- Unicode Usa UTF-16 com a ordem de bytes little-endian.
- UTF7 usa UTF-7.
- UTF8 usa UTF-8.
- UTF32 Usa UTF-32 com a ordem de bytes little-endian.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | Default |
| Valores aceites: | ASCII, BigEndianUnicode, Default, OEM, Unicode, UTF7, UTF8, UTF32 |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Exclude
Exclua os itens especificados. O valor desse parâmetro qualifica o parâmetro Path. Insira um elemento ou padrão de caminho, como *.txt. Curingas são permitidos.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | True |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Include
Inclui os itens especificados. O valor desse parâmetro qualifica o parâmetro Path. Insira um elemento ou padrão de caminho, como *.txt. Curingas são permitidos.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | True |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-InputObject
Especifica o texto a ser pesquisado. Insira uma variável que contenha o texto ou digite um comando ou expressão que obtenha o texto.
Usar o parâmetro InputObject não é o mesmo que enviar cadeias de caracteres pelo pipeline para Select-String.
Quando você canaliza mais de uma cadeia de caracteres para o cmdlet Select-String, ele procura o texto especificado em cada cadeia de caracteres e retorna cada cadeia de caracteres que contém o texto de pesquisa.
Quando você usa o parâmetro InputObject para enviar uma coleção de cadeias de caracteres, Select-String trata a coleção como uma única cadeia de caracteres combinada.
Select-String retorna as cadeias de caracteres como uma unidade se encontrar o texto de pesquisa em qualquer cadeia de caracteres.
Propriedades dos parâmetros
| Tipo: | PSObject |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
Object
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-List
Somente a primeira instância de texto correspondente é retornada de cada arquivo de entrada. Essa é a maneira mais eficiente de recuperar arquivos de lista com conteúdo correspondente à expressão regular.
Por padrão, Select-String retorna um objeto de MatchInfo para cada correspondência encontrada.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-LiteralPath
Especifica o caminho para os arquivos a serem pesquisados. O valor do parâmetro LiteralPath é usado exatamente como é digitado. Nenhum caractere é interpretado como carta curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples. Aspas simples indicam ao PowerShell para não interpretar quaisquer caracteres como sequências de escape. Para obter mais informações, consulte about_Quoting_Rules.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | PSPath |
Conjuntos de parâmetros
LiteralFile
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-NotMatch
O parâmetro NotMatch localiza o texto que não corresponde ao padrão especificado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Path
Especifica o caminho para os arquivos a serem pesquisados. Curingas são permitidos. O local padrão é o diretório local.
Especifique arquivos no diretório, como log1.txt, *.docou *.*. Se você especificar apenas um diretório, o comando falhará.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | Local directory |
| Suporta carateres universais: | True |
| NãoMostrar: | False |
Conjuntos de parâmetros
File
| Position: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Pattern
Especifica o texto a ser localizado em cada linha. Digite uma cadeia de caracteres ou expressão regular. Se você digitar uma cadeia de caracteres, use o parâmetro SimpleMatch .
Para saber mais sobre expressões regulares, consulte about_Regular_Expressions.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Quiet
Indica que o cmdlet retorna um valor booleano (True ou False), em vez de um objeto MatchInfo . O valor é True se o padrão for encontrado; caso contrário, o valor será False.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-SimpleMatch
Indica que o cmdlet usa uma correspondência simples em vez de uma correspondência de expressão regular. Em uma correspondência simples, Select-String pesquisa a entrada para o texto no parâmetro Pattern. Ele não interpreta o valor do parâmetro Pattern como uma instrução de expressão regular.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
PSObject
Você pode canalizar qualquer objeto que tenha um método ToString para Select-String.
Saídas
Microsoft.PowerShell.Commands.MatchInfo or System.Boolean
Por padrão, a saída é um conjunto de objetos MatchInfo com um para cada correspondência encontrada. Se você usar o parâmetro Quiet , a saída será um valor booleano que indica se o padrão foi encontrado.
Notas
Select-String é semelhante ao grep no UNIX ou findstr.exe no Windows.
O alias sls para o Select-String cmdlet foi introduzido no PowerShell 3.0.
Observação
De acordo com Approved Verbs for PowerShell Commands, o prefixo de alias oficial para cmdlets Select-* é sc, não sl. Portanto, o alias adequado para Select-String deve ser scs, não sls. Trata-se de uma exceção a esta regra.
Para usar Select-String, digite o texto que você deseja encontrar como o valor do parâmetro Padrão de. Para especificar o texto a ser pesquisado, use os seguintes critérios:
- Digite o texto em uma cadeia de caracteres entre aspas e, em seguida, canalize-o para
Select-String. - Armazene uma cadeia de caracteres de texto em uma variável e, em seguida, especifique a variável como o valor do parâmetro InputObject.
- Se o texto estiver armazenado em arquivos, use o parâmetro Path para especificar o caminho para os arquivos.
Por padrão, Select-String interpreta o valor do parâmetro Pattern como uma expressão regular. (Para obter mais informações, consulte about_Regular_Expressions.
Você pode usar o parâmetro SimpleMatch para substituir a correspondência de expressão regular. O parâmetro SimpleMatch localiza instâncias do valor do parâmetro Pattern na entrada.
A saída padrão do Select-String é um objeto MatchInfo, que inclui informações detalhadas sobre as correspondências. As informações no objeto são úteis quando você está procurando texto em arquivos, porque objetos MatchInfo têm propriedades como Filename e Line. Quando a entrada não é do arquivo, o valor desses parâmetros é InputStream.
Se você não precisar das informações no objeto MatchInfo, use o parâmetro Quiet. O parâmetro Quiet retorna um valor booleano (True ou False) para indicar se encontrou uma correspondência, em vez de um objeto MatchInfo.
Ao fazer a correspondência de frases, Select-String usa a cultura atual definida para o sistema. Para localizar a cultura atual, use o cmdlet Get-Culture.
Para localizar as propriedades de um objeto MatchInfo, digite o seguinte comando:
Select-String -Path test.txt -Pattern 'test' | Get-Member | Format-List -Property *