RUBRIQUE
about_Redirection
DESCRIPTION COURTE
Décrit comment rediriger la sortie de Windows PowerShell vers des
fichiers texte.
DESCRIPTION LONGUE
Par défaut, Windows PowerShell envoie sa sortie de commande vers
la console Windows PowerShell. Toutefois, vous pouvez diriger la
sortie vers un fichier texte et rediriger la sortie d'erreur vers
le flux de sortie ordinaire.
Vous pouvez utiliser les méthodes suivantes pour rediriger la sortie :
- Utilisez l'applet de commande Out-File, qui envoie la sortie de
commande à un fichier texte. En général, vous utilisez l'applet
de commande Out-File lorsque vous devez utiliser ses paramètres,
par exemple Encoding, Force, Width ou NoClobber.
- Utilisez l'applet de commande Tee-Object, qui envoie la
sortie de commande à un fichier texte, puis au pipeline.
- Utilisez les opérateurs de redirection Windows PowerShell.
Les opérateurs de redirection Windows PowerShell se présentent
comme suit.
Opérateur Description Exemple
-------- ---------------------- ------------------------------
> Envoie la sortie au get-process > process.txt
fichier spécifié.
>> Ajoute la sortie au dir *.ps1 >> scripts.txt
contenu du fichier
spécifié.
2> Envoie des erreurs au get-process none 2> errors.txt
fichier spécifié.
2>> Ajoute les erreurs au get-process none 2>> save-errors.txt
contenu du fichier
spécifié.
2>&1 Envoie des erreurs au get-process none, powershell 2>&1
flux de sortie de
réussite.
La syntaxe des opérateurs de redirection se présente comme suit :
<entrée> <opérateur> [<chemin>\]<fichier>
Si le fichier spécifié existe déjà, les opérateurs de redirection qui
n'ajoutent pas les données (> et 2>) remplacent le contenu actuel du
fichier sans avertissement. Toutefois, si le fichier est un fichier
en lecture seule, masqué ou système, la redirection échoue. Les
opérateurs de redirection d'ajout (>> et 2>>) n'écrivent pas dans
un fichier en lecture seule, mais ils ajoutent le contenu à un
fichier système ou masqué.
Pour forcer la redirection de contenu vers un fichier en lecture
seule, masqué ou système, utilisez l'applet de commande Out-File
avec son paramètre Force. Lorsque vous écrivez dans les fichiers,
les opérateurs de redirection utilisent l'encodage Unicode.
Si le fichier a un encodage différent, la mise en forme de la
sortie peut être incorrecte. Pour rediriger le contenu vers des
fichiers non-Unicode, utilisez l'applet de commande Out-File
avec son paramètre Encoding.
VOIR AUSSI
Out-File
Tee-Object
about_Operators
about_Command_Syntax
about_Path_Syntax