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