Select-String

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

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

C:\PS>"Hello","HELLO" | select-string -pattern "HELLO" -casesensitive

Descrizione
-----------
Questo comando cerca una corrispondenza con distinzione tra maiuscole e minuscole del testo reindirizzato al comando Select-String. 

Di conseguenza, Select-String trova solo "HELLO", perché "Hello" non corrisponde.

Poiché ciascuna delle stringhe tra virgolette viene trattata come riga, senza il parametro CaseSensitive, Select-String riconoscerebbe entrambe le stringhe come corrispondenze.

C:\PS>select-string -path *.xml -pattern "the the"

Descrizione
-----------
In questo comando vengono cercati tutti i file della directory corrente con estensione xml e vengono visualizzate le righe di tali file che includono la stringa "the the".

C:\PS>select-string -path $pshome\en-US\*.txt -pattern "@"

Descrizione
-----------
Questo comando cerca i file della Guida dedicati ai concetti di Windows PowerShell (about_*.txt) per informazioni sull'utilizzo del simbolo della a commerciale (@). 

Per indicare il percorso, questo comando utilizza il valore della variabile $pshome, in cui viene archiviato il percorso della directory di installazione di Windows PowerShell. In questo esempio, il comando cerca la sottodirectory en-US che contiene i file della Guida in lingua inglese (Stati Uniti) per Windows PowerShell.

C:\PS>function search-help
{
    $pshelp = "$pshome\es\about_*.txt", "$pshome\en-US\*dll-help.xml"
    select-string -path $pshelp -pattern $args[0]
}

Descrizione
-----------
Questa funzione semplice utilizza il cmdlet Select-String per cercare una determinata stringa nei file della Guida di Windows PowerShell. In questo esempio, la funzione cerca i file in lingua inglese (Stati Uniti) nella sottodirectory "en-US".

Per utilizzare la funzione per trovare una stringa, ad esempio "psdrive", digitare "search-help psdrive".

Per utilizzare questa funzione in qualsiasi console di Windows PowerShell, modificare il percorso affinché punti ai file della Guida di Windows PowerShell nel sistema, quindi incollare la funzione nel profilo di Windows Powershell.

C:\PS>$events = get-eventlog -logname application -newest 100

C:\PS> $events | select-string -inputobject {$_.message} -pattern "failed"

Descrizione
-----------
In questo esempio viene cercata la stringa "failed" nei 100 eventi più recenti del registro applicazioni del Visualizzatore eventi.

Il primo comando utilizza il cmdlet Get-EventLog per ottenere i 100 eventi più recenti dal registro eventi dell'applicazione. Archivia quindi gli eventi nella variabile $events. 

Nel secondo comando viene utilizzato un operatore pipeline (|) per inviare gli oggetti nella variabile $events a Select-String. Viene utilizzato il parametro InputObject per rappresentare l'input dalla variabile $events. Il valore del parametro InputObject è la proprietà Message di ogni oggetto che passa tramite la pipeline. L'oggetto corrente viene rappresentato dal simbolo $_.

Man mano che gli eventi arrivano nella pipeline, Select-String cerca la stringa "failed" nel valore della proprietà Message, quindi visualizza qualsiasi riga che contenga una corrispondenza.

C:\PS>get-childitem c:\windows\system32\* -include *.txt -recurse |
select-string -pattern "Microsoft" -casesensitive

Descrizione
-----------
In questo comando viene cercata la stringa "Microsoft" in tutti i file presenti nelle sottodirectory di C:\Windows\System32 con estensione txt. Il parametro CaseSensitive indica che la lettera "M" di "Microsoft" deve essere maiuscola, mentre gli altri caratteri devono essere minuscoli affinché Select-String individui una corrispondenza.

C:\PS>select-string -path process.txt -pattern idle, svchost -notmatch

Descrizione
-----------
Questo comando trova nel file Process.txt righe di testo che non includono le parole "idle" o "svchost".

C:\PS>$f = select-string -path audit.log -pattern "logon failed" -context 2, 3

C:\PS> $f.count

C:\PS> ($f)[0].context | format-list

Descrizione
-----------
Il primo comando cerca la frase "logon failed" nel file Audit.Log. Viene utilizzato il parametro Context per acquisire le 2 righe che precedono e le 3 righe che seguono la corrispondenza. 

Nel secondo comando viene utilizzata la proprietà Count delle matrici di oggetti per visualizzare il numero di corrispondenze trovate, in questo caso 2. 

Il terzo comando visualizza le righe archiviate nella proprietà Context del primo oggetto MatchInfo. Viene utilizzata una notazione di matrice per indicare la prima corrispondenza (corrispondenza 0 in una matrice in base zero) e viene utilizzato il cmdlet Format-List per visualizzare il valore della proprietà Context come elenco.

L'output è costituito da due oggetti MatchInfo, uno per ciascuna corrispondenza trovata. Le righe del contesto vengono archiviate nella proprietà Context dell'oggetto MatchInfo.

C:\PS>$a = get-childitem $pshome\en-us\about*.help.txt | select-string -pattern transcript


C:\PS> $b = get-childitem $pshome\en-us\about*.help.txt | select-string -pattern transcript -allmatches

C:\PS> $a
C:\Windows\system32\WindowsPowerShell\v1.0\en-us\about_Pssnapins.help.txt:39:       Start-Transcript and Stop-Transcript.

C:\PS> $b
C:\Windows\system32\WindowsPowerShell\v1.0\en-us\about_Pssnapins.help.txt:39:       Start-Transcript and Stop-Transcript.


C:\PS>> $a.matches
Groups   : {Transcript}
Success  : True
Captures : {Transcript}
Index    : 13
Length   : 10
Value    : Transcript


C:\PS> $b.matches
Groups   : {Transcript}
Success  : True
Captures : {Transcript}
Index    : 13
Length   : 10
Value    : Transcript

Groups   : {Transcript}
Success  : True
Captures : {Transcript}
Index    : 33
Length   : 10
Value    : Transcript

Descrizione
-----------
In questo esempio viene illustrato l'effetto del parametro AllMatches di Select-String. AllMatches trova tutte le corrispondenze del criterio in una riga anziché trovare solo la prima corrispondenza in ciascuna riga.

Nel primo comando dell'esempio vengono cercate le istanze della parola "transcript" nei file della Guida dedicati ai concetti di Windows PowerShell (Guida "about"). Il secondo comando è identico, con l'eccezione che utilizza il parametro AllMatches.

L'output del primo comando viene salvato nella variabile $a. L'output del secondo comando viene salvato nella variabile $b. 

Quando viene visualizzato il valore delle variabili, la visualizzazione predefinita è identica, come illustrato nell'output di esempio.

Tuttavia, con il quinto e il sesto comando viene visualizzato il valore della proprietà Matches di ciascun oggetto. La proprietà Matches del primo comando contiene solo una corrispondenza (ovvero un oggetto System.Text.RegularExpressions.Match), mentre quella del secondo comando contiene oggetti per entrambe le corrispondenze nella riga.