Add-Content
Ajoute le contenu aux éléments spécifiés (ajout de mots à un fichier, par exemple).
Syntaxe
Add-Content [-LiteralPath] <string[]> [-Value] <Object[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]
Add-Content [-Path] <string[]> [-Value] <Object[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]
Description
L'applet de commande Add-Content ajoute le contenu à un élément ou un fichier spécifié. Vous pouvez spécifier le contenu en le tapant dans la commande ou en spécifiant un objet renfermant le contenu.
Paramètres
-Credential <PSCredential>
Spécifie un compte d'utilisateur qui a l'autorisation d'exécuter cette action. La valeur par défaut est l'utilisateur actuel.
Tapez un nom d'utilisateur, tel que « User01 » ou « Domain01\User01 », ou entrez un objet PSCredential, tel que celui généré par l'applet de commande Get-Credential. Si vous tapez un nom d'utilisateur, vous êtes invité à entrer un mot de passe.
Ce paramètre n'est pas pris en charge par les fournisseurs installés avec Windows PowerShell.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
true (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-Exclude <string[]>
Omet les éléments spécifiés. La valeur de ce paramètre qualifie le paramètre Path. Entrez un élément ou un modèle de chemin d'accès, tel que « *.txt ». Les caractères génériques sont autorisés.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Filter <string>
Spécifie un filtre dans le format ou le langage du fournisseur. La valeur de ce paramètre qualifie le paramètre Path. La syntaxe du filtre, notamment l'utilisation de caractères génériques, dépend du fournisseur. Les filtres sont plus efficaces que les autres paramètres, car le fournisseur les applique lors de la récupération des objets, plutôt que de laisser le soin à Windows PowerShell de filtrer les objets une fois qu'ils ont été récupérés.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Force
Remplace l'attribut de lecture seule pour que vous puissiez ajouter le contenu à un fichier en lecture seule.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Include <string[]>
Ajoute uniquement les éléments spécifiés. La valeur de ce paramètre qualifie le paramètre Path. Entrez un élément ou un modèle de chemin d'accès, tel que « *.txt ». Les caractères génériques sont autorisés.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-LiteralPath <string[]>
Spécifie le chemin d'accès aux éléments recevant le contenu supplémentaire. Contrairement à Path, la valeur de LiteralPath est utilisée exactement telle que vous la tapez. Aucun caractère n'est interprété en tant que caractère générique. Si le chemin d'accès inclut des caractères d'échappement, mettez-le entre des guillemets simples. Les guillemets simples indiquent à Windows PowerShell qu'aucun caractère ne doit être interprété en tant que séquence d'échappement.
Obligatoire ? |
true |
Position ? |
1 |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
true (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-PassThru
Retourne un objet qui représente le contenu ajouté. Par défaut, cette applet de commande ne génère aucune sortie.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Path <string[]>
Spécifie le chemin d'accès aux éléments recevant le contenu supplémentaire. Les caractères génériques sont autorisés. Si vous spécifiez plusieurs chemins d'accès, séparez-les à l'aide de virgules.
Obligatoire ? |
true |
Position ? |
1 |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
true (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-Value <Object[]>
Spécifie le contenu à ajouter. Tapez une chaîne entre guillemets (« Ces données sont réservées à un usage interne. », par exemple) ou spécifiez un objet qui comporte le contenu (objet DateTime généré par Get-Date, par exemple).
Vous ne pouvez pas spécifier le contenu d'un fichier en tapant son chemin d'accès (un chemin d'accès est une simple chaîne), mais vous pouvez obtenir le contenu à l'aide d'une commande Get-Content et le passer au paramètre Value.
Obligatoire ? |
true |
Position ? |
2 |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
true (ByValue, ByPropertyName) |
Accepter les caractères génériques ? |
false |
-Confirm
Vous invite à confirmer l'exécution de la commande.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-WhatIf
Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-UseTransaction
Inclut la commande dans la transaction active. Ce paramètre est valide uniquement lorsqu'une transaction est en cours. Pour plus d'informations, consultez about_Transactions.
Obligatoire ? |
false |
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.Object Vous pouvez également diriger les objets à ajouter (Value) vers Add-Content. |
Sorties |
Aucun ou System.String Lorsque vous utilisez le paramètre PassThru, Add-Content génère un objet System.String qui représente le contenu. Sinon, cette applet de commande ne génère aucune sortie. |
Remarques
Lorsque vous dirigez un objet vers Add-Content, l'objet est converti en chaîne avant d'être ajouté à l'élément. Le type d'objet détermine le format de la chaîne, mais le format peut être différent de l'affichage par défaut de l'objet. Pour contrôler le format de la chaîne, utilisez les paramètres de formatage de l'applet de commande d'envoi.
Vous pouvez également faire référence à Add-Content par son alias intégré, « ac ». Pour plus d'informations, consultez about_Aliases.
L'applet de commande Add-Content est conçue pour utiliser les données exposées par n'importe quel fournisseur. Pour répertorier les fournisseurs disponibles dans votre session, tapez « Get-PsProvider ». Pour plus d'informations, consultez about_Providers.
Exemple 1
C:\PS>add-content -path *.txt -exclude help* -value "END"
Description
-----------
Cette commande ajoute « END » à tous les fichiers texte figurant dans le répertoire actif, à l'exception des fichiers dont le nom commence par « help ».
Exemple 2
C:\PS>add-content -Path file1.log, file2.log -Value (get-date) -passthru
Description
-----------
Cette commande ajoute la date à la fin des fichiers File1.log et File2.log, puis affiche la date à la ligne de commande. La commande utilise l'applet de commande Get-Date pour obtenir la date et le paramètre Value pour passer la date à Add-Content. Le paramètre PassThru passe un objet représentant le contenu ajouté à travers le pipeline. Dans la mesure où aucune autre applet de commande n'est en mesure de recevoir l'objet passé, il est affiché à la ligne de commande.
Exemple 3
C:\PS>add-content -path monthly.txt -value (get-content c:\rec1\weekly.txt)
Description
-----------
Cette commande ajoute le contenu du fichier Weekly.txt à la fin du fichier Monthly.txt. Elle utilise l'applet de commande Get-Content pour obtenir le contenu du fichier Weekly.txt et le paramètre Value pour passer ce contenu à Add-Content. Les parenthèses font en sorte que la commande Get-Content soit terminée avant que la commande Add-Content ne commence.
Vous pouvez également copier le contenu du fichier Weekly.txt dans une variable, telle que $w, puis utiliser le paramètre Value pour passer la variable à Add-Content. Dans ce cas, la commande est « add-content -path monthly.txt -value $w ».
Exemple 4
C:\PS>add-content -value (get-content test.log) -path C:\tests\test134\logs\test134.log
Description
-----------
Cette commande crée un répertoire et un fichier, puis copie le contenu d'un fichier existant dans le fichier qui vient d'être créé.
Cette commande utilise l'applet de commande Add-Content pour ajouter le contenu. La valeur du paramètre Value est une commande Get-Content qui obtient le contenu à partir d'un fichier existant (Test.log).
La valeur du paramètre path est un chemin d'accès qui n'existe pas lors de l'exécution de la commande. Dans cet exemple, seuls les répertoires C:\Tests existent. La commande crée les répertoires restants et le fichier Test134.log.
Le paramètre Force n'est pas obligatoire pour cette commande. Add-Content crée des répertoires pour compléter un chemin d'accès sans avoir à l'utiliser.
Voir aussi
Concepts
about_Providers
Get-Content
Set-Content
Clear-Content
Get-Item