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.