Section courante

A propos

Section administrative du site

Add-Content

Ajout du contenu
PowerShell

Syntaxe

Add-Content [-Path] string[] [-Value] Object[] [-PassThru] [-Filter string] [-Include string[]] [-Exclude string[]] [-Force] [-Credential pscredential] [-WhatIf] [-Confirm] [-NoNewline] [-Encoding Encoding] [-AsByteStream] [-Stream string] [CommonParameters]
Add-Content [-Value] Object[] -LiteralPath string[] [-PassThru] [-Filter string] [-Include string[]] [-Exclude string[]] [-Force] [-Credential pscredential] [-WhatIf] [-Confirm] [-NoNewline] [-Encoding Encoding] [-AsByteStream] [-Stream string] [CommonParameters]

Description

Cette commande permet d'ajouter le contenu aux éléments spécifiés, tels que l'ajout de mots à un fichier.

Paramètres

Nom Description
-AsByteStream Ce paramètre permet d'indiquer que le contenu doit être lu comme un flux de données d'octets. Ce paramètre a été introduit dans PowerShell 6.0. Un avertissement se produit lorsque vous utilisez le paramètre AsByteStream avec le paramètre Encoding. Le paramètre AsByteStream ignore tout encodage et la sortie est renvoyée sous la forme d'un flux d'octets.
-Confirm Ce paramètre permet d'indiquer un prompt de confirmation avant d'exécuter la commandlette.
-Credential Ce paramètre permet d'indiquer un compte d'utilisateur disposant des droits d'accès pour effectuer cette action. Ce paramètre n'est pris en charge par aucun fournisseur installé avec PowerShell. Pour emprunter l'identité d'un autre utilisateur ou élever vos informations d'identification lors de l'exécution de cette commandlette, utilisez Invoke-Command.
-Encoding Ce paramètre permet d'indiquer le type de codage pour le fichier cible. La valeur par défaut est utf8NoBOM.
-Exclude Ce paramètre permet d'indiquer, sous forme de tableau de chaînes de caractères, un élément ou des éléments que cette commandlette exclut de l'opération. La valeur de ce paramètre qualifie le paramètre Path. Entrez un élément ou un modèle de chemin, tel que *.txt. Les caractères génériques sont autorisés. Le paramètre Exclude est efficace uniquement lorsque la commande inclut le contenu d'un élément, tel que C:\Windows\*, où le caractère générique spécifie le contenu du répertoire C:\Windows.
-Filter Ce paramètre permet d'indiquer un filtre pour qualifier le paramètre Path. Le fournisseur FileSystem est le seul fournisseur PowerShell installé prenant en charge l'utilisation de filtres. Les filtres sont plus efficaces que les autres paramètres, car le fournisseur les applique lorsque la commandlette obtient les objets plutôt que de laisser PowerShell filtrer les objets après leur récupération.
-Force Ce paramètre permet de remplacer l'attribut en lecture seulement, vous permettant d'ajouter du contenu à un fichier en lecture seulement. Par exemple, Force remplacera l'attribut en lecture seulement ou créera des répertoires pour compléter un chemin de fichier, mais il ne tentera pas de modifier les autorisations de fichier.
-Include Ce paramètre permet d'indiquer, sous forme de tableau de chaînes de caractères, un ou plusieurs éléments que cette commandlette inclut dans l'opération. La valeur de ce paramètre qualifie le paramètre Path. Entrez un élément de chemin ou un modèle, tel que "*.txt". Les caractères génériques sont autorisés. Le paramètre Inclure n'est efficace que lorsque la commande inclut le contenu d'un élément, tel que C:\Windows\*, où le caractère générique spécifie le contenu du répertoire C:\Windows.
-LiteralPath Ce paramètre permet d'indiquer un chemin vers un ou plusieurs emplacements. La valeur de LiteralPath est utilisée exactement telle qu'elle est tapée. Aucun caractère n'est interprété comme des caractères génériques. 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.
-NoNewline Ce paramètre permet d'indiquer que cette commandlette n'ajoute pas de nouvelle ligne ou de retour chariot au contenu. 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.
-PassThru Ce paramètre permet de retourner un objet représentant le contenu ajouté. Par défaut, cette commandlette ne génère aucune sortie.
-Path Ce paramètre permet d'indiquer le chemin d'accès aux éléments recevant le contenu supplémentaire. Les caractères génériques sont autorisés. Les chemins doivent être des chemins vers des éléments et non vers des conteneurs. Par exemple, vous devez spécifier un chemin vers un ou plusieurs fichiers, pas un chemin vers un répertoire. Si vous spécifiez plusieurs chemins, utilisez des virgules pour séparer les chemins.
-Stream Ce paramètre permet d'indiquer un flux de données alternatif pour le contenu. Si le flux n'existe pas, cette commandlette le crée. Les caractères génériques ne sont pas pris en charge.
-Value Ce paramètre permet d'indiquer le contenu à ajouter. Tapez une chaîne de caractères entre guillemets, telle que les données This sont à usage interne uniquement, ou spécifiez un objet contenant du contenu, tel que l'objet DateTime généré par Get-Date.
-WhatIf Ce paramètre permet de montrer ce qui se passerait si la commandlette s'exécute. Toutefois, la commandlette n'est pas exécutée.


Dernière mise à jour : Mardi, le 12 Janvier 2021