Partager via


Tee-Object

Enregistre la sortie de la commande dans un fichier ou une variable, puis l'affiche dans la console.

Syntaxe

Tee-Object [-FilePath] <string> [-InputObject <psobject>] [<CommonParameters>]

Tee-Object -Variable <string> [-InputObject <psobject>] [<CommonParameters>]

Description

L'applet de commande Tee-Object envoie la sortie d'une commande dans deux directions (comme la lettre « T »). Elle stocke la sortie dans un fichier ou une variable, et l'envoie également à travers le pipeline. Si Tee-Object est la dernière commande du pipeline, la sortie de commande est affichée dans la console.

Paramètres

-FilePath <string>

Spécifie le fichier où l'applet de commande stocke l'objet. Accepte des caractères génériques qui résolvent en un fichier unique.

Obligatoire ?

true

Position ?

1

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-InputObject <psobject>

Spécifie l'entrée d'objet à l'applet de commande. Entrez une variable contenant les objets ou tapez une commande ou une expression qui obtient les objets.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

true (ByValue)

Accepter les caractères génériques ?

false

-Variable <string>

Assigne une référence aux objets d'entrée à la variable spécifiée.

Obligatoire ?

true

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.

Entrées et sorties

Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.

Entrées

System.Management.Automation.PSObject

Vous pouvez diriger les objets à rediriger vers Tee-Object.

Sorties

System.Management.Automation.PSObject

Tee-Object retourne l'objet qu'elle a redirigé.

Remarques

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

Tee-Object utilise l'encodage Unicode lorsqu'il écrit dans les fichiers. Par conséquent, la sortie peut ne pas être mise en forme correctement dans les fichiers possédant un encodage différent. Pour spécifier l'encodage, utilisez l'applet de commande Out-File.

Exemple 1

C:\PS>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
...

Description
-----------
Cette commande obtient une liste des processus qui s'exécutent sur l'ordinateur et envoie le résultat à un fichier. Étant donné qu'un deuxième chemin d'accès n'est pas spécifié, le résultat sera affiché dans la console.





Exemple 2

C:\PS>get-process notepad | tee-object -variable proc | select-object processname,handles 

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

Description
-----------
Cette commande obtient la liste des processus en cours d'exécution sur l'ordinateur et envoie le résultat à une procédure nommée « proc ». Elle dirige ensuite les objets résultants vers Select-Object, qui sélectionne les propriétés ProcessName et Handles. Notez que la variable $proc inclut les informations par défaut retournées par Get-Process.





Voir aussi

Concepts

about_Redirection
Select-Object