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

Description
-----------
Cette commande effectue une mise en correspondance respectant la casse du texte dirigé vers la commande Select-String. 

En conséquence, Select-String recherche uniquement « HELLO », car « Hello » ne correspond pas.

Étant donné que chaque chaîne entre guillemets est traitée comme une ligne, sans le paramètre CaseSensitive, Select-String reconnaîtrait les deux chaînes comme des correspondances.

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

Description
-----------
Cette commande effectue une recherche dans tous les fichiers portant l'extension .xml du répertoire actif et affiche les lignes de ces fichiers qui incluent la chaîne « the the ».

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

Description
-----------
Cette commande recherche des d'informations sur l'utilisation de l'arobase (@) dans les fichiers d'aide conceptuelle de Windows PowerShell (about_*.txt). 

Pour indiquer le chemin d'accès, cette commande utilise la valeur de la variable automatique $pshome, qui stocke le chemin d'accès au répertoire d'installation de Windows PowerShell. Dans cet exemple, la commande effectue une recherche dans le sous-répertoire en-US, qui contient les fichiers d'aide en langue anglaise (US) de 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]
}

Description
-----------
Cette fonction simple utilise l'applet de commande Select-String pour rechercher une chaîne particulière dans les fichiers d'aide de Windows PowerShell. Dans cet exemple, la fonction recherche des fichiers de langue Anglais-États-Unis dans le sous-répertoire « en-US ».

Pour utiliser la fonction afin de rechercher une chaîne, telle que « psdrive », tapez « search-help psdrive ».

Pour utiliser cette fonction dans n'importe quelle console Windows PowerShell, modifiez le chemin d'accès afin de pointer vers les fichiers d'aide de Windows PowerShell sur votre système, puis collez la fonction dans votre profil Windows PowerShell.

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

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

Description
-----------
Cet exemple recherche la chaîne « failed » dans les 100 événements les plus récents du journal des applications de l'observateur d'événements.

La première commande utilise l'applet de commande Get-EventLog pour obtenir les 100 événements les plus récents du journal d'événements d'applications. Elle les enregistre ensuite dans la variable $events. 

La deuxième commande utilise un opérateur de pipeline (|) pour envoyer les objets de la variable $events à l'applet de commande Select-String. Elle utilise le paramètre InputObject pour représenter l'entrée à partir de la variable $events. La valeur du paramètre InputObject est la propriété Message de chaque objet qui traverse le pipeline. L'objet actuel est représenté par le symbole $_.

Lorsqu'un événement arrive dans le pipeline, Select-String recherche la chaîne « failed » dans la valeur de sa propriété Message, puis affiche toutes les lignes incluant une correspondance.

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

Description
-----------
Cette commande examine tous les fichiers des sous-répertoires de C:\Windows\System32 comportant l'extension .txt et recherche la chaîne « Microsoft ». Le paramètre CaseSensitive indique que le « M » de « Microsoft » doit être en majuscule et que les autres caractères doivent être en minuscules pour que Select-String trouve une correspondance.

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

Description
-----------
Cette commande recherche les lignes de texte du fichier Process.txt qui n'incluent pas les mots « idle » ou « 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

Description
-----------
La première commande recherche l'expression « logon failed » dans le fichier Audit.Log. Elle utilise le paramètre Context pour capturer 2 lignes avant la correspondance et 3 lignes après. 

La deuxième commande utilise la propriété Count des tableaux d'objets pour afficher le nombre de correspondances trouvées (2 dans le cas présent). 

La troisième commande affiche les lignes stockées dans la propriété Context du premier objet MatchInfo. Elle utilise la notation sous forme de tableau pour indiquer la première correspondance (correspondance 0 dans un tableau de base zéro) et utilise l'applet de commande Format-List pour afficher la valeur de la propriété Context sous forme de liste.

La sortie consiste en deux objets MatchInfo, un pour chaque correspondance détectée. Les lignes de contexte sont stockées dans la propriété Context de l'objet 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

Description
-----------
Cet exemple illustre l'effet du paramètre AllMatches de Select-String. AllMatches recherche toutes les correspondances de modèles d'une ligne, au lieu de rechercher uniquement la première correspondance de chaque ligne.

La première commande de l'exemple recherche des instances du mot « transcript » dans les fichiers d'aide conceptuelle de Windows PowerShell (aide « à propos de »). La deuxième commande est identique, sauf qu'elle utilise le paramètre AllMatches.

La sortie de la première commande est enregistrée dans la variable $a. La sortie de la deuxième commande est enregistrée dans la variable $b. 

Lorsque vous affichez la valeur des variables, l'affichage par défaut est identique, comme indiqué dans la sortie d'exemple.

Cependant, la cinquième et la sixième commandes affichent la valeur de la propriété Matches de chaque objet. La propriété Matches de la première commande contient une seule correspondance (autrement dit, un objet System.Text.RegularExpressions.Match), alors que la propriété Matches de la deuxième commande contient des objets pour les deux correspondances de la ligne.