Out-File |
Sortie de fichier |
|---|---|
| PowerShell | |
Syntaxe
| Out-File [-FilePath] string [[-Encoding] Encoding] [-Append] [-Force] [-NoClobber] [-Width int] [-NoNewline] [-InputObject psobject] [-WhatIf] [-Confirm] [CommonParameters] |
| Out-File [[-Encoding] Encoding] -LiteralPath string [-Append] [-Force] [-NoClobber] [-Width int] [-NoNewline] [-InputObject psobject] [-WhatIf] [-Confirm] [CommonParameters] |
Paramètres
| Nom | Description | |
|---|---|---|
| -Append | Ce paramètre permet d'ajouter la sortie à la fin d'un fichier existant. | |
| -Confirm | Ce paramètre permet d'indiquer un prompt de confirmation avant d'exécuter la commandlette. | |
| -Encoding | Ce paramètre permet d'indiquer le type de codage pour le fichier cible. La valeur par défaut est utf8NoBOM. Les valeurs acceptables pour ce paramètre sont les suivantes : | |
| Valeur | Description | |
| ascii | Cette valeur permet d'indiquer qu'il faut utiliser le codage pour l'ensemble de caractères ASCII (7 bits). | |
| bigendianunicode | Cette valeur permet d'indiquer l'encodage au format UTF-16 en utilisant l'ordre des octets grand boutiste. | |
| bigendianutf32 | Cette valeur permet d'indiquer l'encodage au format UTF-32 en utilisant l'ordre des octets grand boutiste. | |
| oem | Cette valeur permet d'indiquer qu'il faut utiliser le codage par défaut pour les programmes MS-DOS et la console. | |
| unicode | Cette valeur permet d'indiquer l'encodage au format UTF-16 en utilisant l'ordre des octets petit boutiste. | |
| utf7 | Cette valeur permet d'indiquer l'encodage au format UTF-7. | |
| utf8 | Cette valeur permet d'indiquer l'encodage au format UTF-8. | |
| utf8BOM | Cette valeur permet d'indiquer l'encodage au format UTF-8 avec BOM (Byte Order Mark). | |
| utf8NoBOM | Cette valeur permet d'encoder au format UTF-8 sans BOM (Byte Order Mark). | |
| utf32 | Cette valeur permet d'indiquer l'encodage au format UTF-32. | |
| -FilePath | Ce paramètre permet d'indiquer le chemin d'accès au fichier de sortie. | |
| -Force | Ce paramètre permet de remplacer l'attribut en lecture seulement et écrase un fichier en lecture seulement existant. Le paramètre -Force ne remplace pas les restrictions de sécurité. | |
| -InputObject | Ce paramètre permet d'indiquer les objets à écrire dans le fichier. Entrez une variable contenant les objets ou tapez une commande ou une expression récupérant les objets. | |
| -LiteralPath | Ce paramètre permet d'indiquer le chemin d'accès au fichier de sortie. Le paramètre LiteralPath est utilisé exactement tel qu'il est tapé. Les caractères génériques ne sont pas acceptés. Si le chemin comprend des caractères d'échappement, placez-le entre guillemets simples. Les guillemets simples indiquent à PowerShell de ne pas interpréter les caractères comme des séquences d'échappement. | |
| -NoClobber | Ce paramètre permet d'empêcher l'écrasement d'un fichier existant et d'afficher un message indiquant que le fichier existe déjà. Par défaut, si un fichier existe dans le chemin spécifié, le Out-File écrase le fichier sans avertissement. | |
| -NoNewline | Ce paramètre permet d'indiquer que le contenu écrit dans le fichier ne se termine pas par un caractère de nouvelle ligne. Les représentations sous forme de chaîne de caractères des objets d'entrée sont concaténées pour former la sortie. Aucun espace ou nouvelle ligne n'est inséré entre les chaînes de caractères de sortie. Aucune nouvelle ligne n'est ajoutée après la dernière chaîne de caractères de sortie. | |
| -WhatIf | Ce paramètre permet de montrer ce qui se passerait si la commandlette s'exécute. La commandlette n'est pas exécutée. | |
| -Width | Ce paramètre permet d'indiquer le nombre de caractères dans chaque ligne de sortie. Tous les caractères supplémentaires sont tronqués et non encapsulés. Si ce paramètre n'est pas utilisé, la largeur est déterminée par les caractéristiques de l'hôte. La valeur par défaut de la console PowerShell est de 80 caractères. | |
Description
Cette commande permet d'envoyer une sortie vers un fichier.
Exemple
L'exemple suivant permet de copier le contenu de la page d'accueil du site Web https://www.gladir.com dans le fichier c:\output.txt :
|
$webClient = New-Object System.Net.WebClient $string=$webClient.DownloadString('https://www.gladir.com') $string | Out-File c:\output.txt |
Dernière mise à jour : Mardi, le 12 Janvier 2021