Tee-Object

Syntaxe

Tee-Object
   [-InputObject <PSObject>]
   [-FilePath] <String>
   [-Append]
   [[-Encoding] <Encoding>]
   [<CommonParameters>]

Tee-Object
   [-InputObject <PSObject>]
   -LiteralPath <String>
   [[-Encoding] <Encoding>]
   [<CommonParameters>]

Tee-Object
   [-InputObject <PSObject>]
   -Variable <String>
   [<CommonParameters>]

Description

L’applet Tee-Object de commande redirige la sortie, autrement dit, elle envoie la sortie d’une commande dans deux directions (comme la lettre T). Elle stocke la sortie dans un fichier ou dans une variable, puis l'envoie dans le pipeline. S’il Tee-Object s’agit de la dernière commande dans le pipeline, la sortie de la commande s’affiche à l’invite.

Exemples

Exemple 1 : Processus de sortie dans un fichier et dans la console

Cet exemple obtient une liste des processus en cours d’exécution sur l’ordinateur et envoie le résultat à un fichier. Étant donné qu'un deuxième chemin n'est pas spécifié, les processus sont également affichés dans la console.

Get-Process | Tee-Object -FilePath "C:\Test1\testfile2.txt"

Handles  NPM(K)    PM(K)      WS(K) VM(M)   CPU(s)    Id ProcessName
-------  ------    -----      ----- -----   ------    -- -----------
83       4     2300       4520    39     0.30    4032 00THotkey
272      6     1400       3944    34     0.06    3088 alg
81       3      804       3284    21     2.45     148 ApntEx
81       4     2008       5808    38     0.75    3684 Apoint
...

Exemple 2 : Processus de sortie vers une variable et « Select-Object »

Cet exemple montre comment obtenir la liste des processus en cours d’exécution sur l’ordinateur, les enregistrer dans la $proc variable et les diriger vers Select-Object.

Get-Process notepad | Tee-Object -Variable proc | Select-Object processname,handles

ProcessName                              Handles
-----------                              -------
notepad                                  43
notepad                                  37
notepad                                  38
notepad                                  38

L’applet Select-Object de commande sélectionne les propriétés ProcessName et Handles . Notez que la $proc variable inclut les informations par défaut retournées par Get-Process.

Exemple 3 : Sortie des fichiers système vers deux fichiers journaux

Cet exemple montre comment enregistrer une liste de fichiers système dans deux fichiers journaux, un fichier cumulatif et un fichier actif.

Get-ChildItem -Path D: -File -System -Recurse |
  Tee-Object -FilePath "c:\test\AllSystemFiles.txt" -Append |
    Out-File c:\test\NewSystemFiles.txt

La commande utilise l’applet Get-ChildItem de commande pour effectuer une recherche récursive des fichiers système sur le lecteur D : . Un opérateur de pipeline (|) envoie la liste Tee-Objectà , qui ajoute la liste au fichier AllSystemFiles.txt et transmet la liste au pipeline à l’applet Out-File de commande, qui enregistre la liste dans le NewSystemFiles.txt filefichier .

Exemple 4 : Imprimer la sortie dans la console et l’utiliser dans le pipeline

Cet exemple obtient les fichiers d’un dossier, les imprime dans la console, puis filtre les fichiers pour ceux qui ont un bloc de métadonnées front matter défini. Enfin, il répertorie les noms des articles qui ont de l’avant.

$consoleDevice = if ($IsWindows) {
    '\\.\CON'
} else {
    '/dev/tty'
}
$frontMatterPattern = '(?s)^---(?<FrontMatter>.+)---'

$articles = Get-ChildItem -Path .\reference\7.4\PSReadLine\About\ |
    Tee-Object -FilePath $consoleDevice |
    Where-Object {
        (Get-Content $_ -Raw) -match $frontMatterPattern
    }

$articles.Name

Directory: C:\code\docs\PowerShell-Docs\reference\7.4\PSReadLine\About

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a---          12/13/2022 11:37 AM            384 .markdownlint.yaml
-a---           4/25/2023 11:28 AM          40194 about_PSReadLine_Functions.md
-a---           4/25/2023 10:58 AM          10064 about_PSReadLine.md

about_PSReadLine_Functions.md
about_PSReadLine.md

L’exemple montre comment définir la $consoleDevice variable sur la valeur de l’appareil console du terminal actuel. Sur Windows, vous pouvez écrire sur l’appareil console actuel en redirigeant votre sortie vers le chemin de \\.\CON fichier. Sur les systèmes non-Windows, vous utilisez le chemin de /dev/tty fichier.

Ensuite, il définit la $frontMatterPattern variable sur une expression régulière qui correspond lorsqu’une chaîne commence par trois tirets (---) et a un contenu avant les trois autres tirets. Lorsque ce modèle correspond au contenu d’un article, l’article a un bloc de métadonnées front matter défini.

Ensuite, l’exemple utilise Get-ChildItem pour récupérer chaque fichier dans le About dossier. Tee-Object imprime les résultats redirigés dans la console à l’aide du paramètre FileName . Where-Object filtre les fichiers en obtenant leur contenu sous la forme d’une seule chaîne avec le paramètre Raw de Get-Content cette chaîne et en comparant cette chaîne à $frontMatterPattern.

Enfin, l’exemple imprime les noms des fichiers dans le dossier qui ont un bloc de métadonnées front matter défini.

Paramètres

-Append

-Encoding

-FilePath

-InputObject

-LiteralPath

-Variable

Entrées

PSObject

Vous pouvez diriger des objets vers cette applet de commande.

Sorties

PSObject

Cette applet de commande retourne l’objet qu’il redirige.

Notes

PowerShell inclut les alias suivants pour Tee-Object:

• Windows :
  • tee

Vous pouvez également utiliser l’applet Out-File de commande ou l’opérateur de redirection, qui enregistrent la sortie dans un fichier, mais ne l’envoient pas dans le pipeline.

À compter de PowerShell 6, Tee-Object utilise l’encodage UTF-8 sans boM lorsqu’il écrit dans des fichiers. Si vous avez besoin d’un autre encodage, utilisez l’applet Out-File de commande avec le paramètre Encodage .

Liens associés

• Compare-Object
• ForEach-Object
• Group-Object
• Measure-Object
• New-Object
• Select-Object
• Sort-Object
• Where-Object
• about_Redirection