Envoie la sortie vers un fichier.
Syntaxe
Description
Le Out-File applet de commande envoie la sortie vers un fichier. Il utilise implicitement le système de formatage de PowerShell pour écrire au fichier. Le fichier reçoit la même représentation d’affichage que le terminal. Cela signifie que la sortie peut ne pas être idéale pour le traitement programmatique à moins que tous les objets d’entrée ne soient des chaînes.,Lorsque vous devez spécifier des paramètres pour la sortie, utilisez Out-File plutôt que le redirectionoperator (>). Pour plus d’informations sur la redirection, voir about_Redirection.
Exemples
Exemple 1: Envoyer une sortie et créer un fichier
Cet exemple montre comment envoyer une liste des processus de l’ordinateur local à un fichier. Si le fichier n’existe pas, Out-File crée le fichier dans le chemin spécifié.
Get-Process cmdlet obtient la liste des processus en cours d’exécution sur l’ordinateur local., Les objets Processobjects sont envoyés dans le pipeline vers l’applet de commande Out-File. Out-File utilise le FilePathparameter et crée un fichier dans le répertoire courant nommé Processus.txt. La commandeGet-Contentrécupère le contenu du fichier et l’affiche dans la console PowerShell.
Exemple 2: Prévenir un fichier existant d’être écrasé
Cet exemple, empêche un fichier existant d’être écrasé. Par défaut, Out-File écrase les fichiers existants.,
Get-Process cmdlet obtient la liste des processus en cours d’exécution sur l’ordinateur local. Les objets Processobjects sont envoyés dans le pipeline vers l’applet de commande Out-File. Out-File utilise le FilePathparameter et tente d’écrire dans un fichier du répertoire courant nommé Process.txt. Le paramètre TheNoClobber empêche l’écrasement du fichier et affiche un message indiquant que le fichier existe déjà.
Exemple 3: Envoyer une sortie dans un fichier au format ASCII
Cet exemple montre comment encoder une sortie avec un type d’encodage spécifique.,
$Procs = Get-ProcessOut-File -FilePath .\Process.txt -InputObject $Procs -Encoding ASCII -Width 50Le Get-Process applet de commande permet d’obtenir la liste des processus en cours d’exécution sur l’ordinateur local. Les objets de processus sont stockés dans la variable $Procs. Out-File utilise le paramètre FilePath et crée un fichier dans le répertoire courant nommé Process.txt. Le paramètre InputObject transmet les objets process dans $Procs au processus de fichier.txt. Le paramètre Encoding convertit la sortie au format ASCII. Le paramètre Width limite chaque ligne du fichier à 50 caractères si certaines données peuvent être tronquées.,
Exemple 4: Utiliser un fournisseur et envoyer la sortie à un fichier
Cet exemple montre comment utiliser l’applet de commandeOut-File lorsque vous n’êtes pas dans un système de fichiers providerdrive. Utilisez l’applet de commande Get-PSProvider pour afficher les fournisseurs sur votre ordinateur local. Pour plus d’informations, voir about_Providers.
Le Set-Location commande utilise le paramètre de Chemin d’accès pour définir l’emplacement actuel de la registryprovider Alias:. L’applet de commande Get-Location affiche le chemin complet pour Alias:.,Get-ChildItem envoie des objets dans le pipeline à l’applet de commande Out-File. Out-File utilise le paramètre Filepath pour spécifier le chemin complet et le nom de fichier de la sortie,C:\TestDir\AliasNames.txt. L’applet de commande Get-Content utilise le paramètre Path et affiche le contenu du fichier dans la console PowerShell.
Paramètres
Ajoute le résultat à la fin d’un fichier existant.,
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Prompts you for confirmation before running the cmdlet.,
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the type of encoding for the target file. The default value is utf8NoBOM.,
Les valeurs acceptables pour ce paramètre sont les suivantes:
-
ascii: Utilise l’encodage du jeu de caractères ASCII (7 bits). -
bigendianunicode: Code au format UTF-16 en utilisant l’ordre des octets big-endian. -
bigendianutf32: Code au format UTF-32 en utilisant l’ordre des octets big-endian. -
oem: Utilise l’encodage par défaut pour les programmes MS-DOS et console. -
unicode: Code au format UTF-16 en utilisant l’ordre des octets little-endian., -
utf7: Code au format UTF-7. -
utf8: Code au format UTF-8. -
utf8BOM: Encode au format UTF-8 avec la Marque d’Ordre des Octets (BOM) -
utf8NoBOM: Encode au format UTF-8 sans Marque d’Ordre des Octets (BOM) -
utf32: Encode en UTF-32 format.
Commençant par PowerShell 6.,2, le paramètre Encoding autorise également les identifiants numériques des pages de codes enregistrées (comme -Encoding 1251) ou les noms de chaîne des pages de codes enregistrées (comme-Encoding "windows-1251"). Pour plus d’informations, consultez la documentation.NET forEncoding.Page de code.
Remarque
L’utilisation de l’UTF-7* n’est plus recommandée. Dans PowerShell 7.1, un avertissement est écrit si youspecify utf7 pour le paramètre Encoding.,
| Type: | Encoding |
| Accepted values: | ASCII, BigEndianUnicode, BigEndianUTF32, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32 |
| Position: | 1 |
| Default value: | UTF8NoBOM |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the path to the output file.,
| Type: | String |
| Aliases: | Path |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Overrides the read-only attribute and overwrites an existing read-only file. The Force parameterdoes not override security restrictions.,
| Type: | SwitchParameter |
| Poste: | Nom |
| valeur par Défaut: | Aucun |
| Accepter pipeline d’entrée: | False |
| Accepter les caractères génériques: | False |
Spécifie les objets à être écrite dans le fichier. Entrez une variable qui contient les objets ou typeune commande ou une expression qui obtient les objets.,
| Type: | PSObject |
| Poste: | Nom |
| valeur par Défaut: | Aucun |
| Accepter pipeline d’entrée: | True |
| Accepter les caractères génériques: | False |
Spécifie 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, entourez-le de repères de simple quotation., Les guillemets simples indiquent à PowerShell de ne pas interpréter les caractères comme des escapesequences. Pour plus d’informations, voir about_Quoting_Rules.,
| Type: | String |
| Aliases: | PSPath, LP |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
NoClobber prevents an existing file from being overwritten and displays a message that the filealready exists., Par défaut, si un fichier existe dans le chemin spécifié, Out-File écrase le fichier sans avertissement.,
| Type: | SwitchParameter |
| Alias: | NoOverwrite |
| Poste: | Nom |
| valeur par Défaut: | Aucun |
| Accepter pipeline d’entrée: | False |
| Accepter les caractères génériques: | False |
Spécifie que le contenu écrit dans le fichier ne se termine pas par un caractère de saut de ligne. Les stringrepresentations des objets d’entrée sont concaténées pour former la sortie., Aucun espace ou saut de ligne n’est inséré entre les chaînes de sortie. Aucune nouvelle ligne n’est ajoutée après la dernière chaîne de sortie.
| Type: | SwitchParameter |
| Poste: | Nom |
| valeur par Défaut: | Aucun |
| Accepter pipeline d’entrée: | False |
| Accepter les caractères génériques: | False |
Montre ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.,
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the number of characters in each line of output. Any additional characters are truncated,not wrapped., 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 pour la console PowerShell est de 80 caractères.
| Type: | Int32 |
| Poste: | Nom |
| valeur par Défaut: | Aucun |
| Accepter pipeline d’entrée: | False |
| Accepter les caractères génériques: | False |
les Entrées
PSObject
Vous pouvez transférer n’importe quel objet de Out-File.,
Sorties
Aucun
Out-File ne génère aucune sortie.
Notes
Les objets d’entrée sont automatiquement formatés comme ils le seraient dans le terminal, mais vous pouvez utiliser une applet de commandeFormat-* pour contrôler explicitement le formatage de la sortie dans le fichier. Par exemple,Get-Date | Format-List | Out-File out.txt
Pour envoyer la sortie d’une commande PowerShell à l’applet de commande Out-File, utilisez le pipeline. Vous pouvez également stocker des données dans une variable et utiliser le paramètre InputObject pour transmettre des données à l’applet de commande Out-File.,
Out-File enregistre les données dans un fichier mais ne produit aucun objet de sortie dans le pipeline.
- about_Providers
- about_Quoting_Rules
- Sortie-par Défaut
- Out-Host
- Out-Null
- Hors-Chaîne
- Tee-Objet
Laisser un commentaire