Add-Content

Agrega contenido a los elementos especificados, como por ejemplo palabras a un archivo.

Sintaxis

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>]

Descripción

El cmdlet Add-Content anexa contenido a un elemento o archivo especificado. Puede especificar el contenido escribiéndolo directamente en el comando o especificando un objeto que contenga dicho contenido.

Parámetros

-Credential <PSCredential>

Especifica una cuenta de usuario con permiso para realizar esta acción. El valor predeterminado es el usuario actual.

Escriba un nombre de usuario, como "Usuario01" o "Dominio01\Usuario01", o bien, escriba un objeto PSCredential, como uno generado por el cmdlet Get-Credential. Si escribe un nombre de usuario se le pedirá una contraseña.

Este parámetro no es compatible con los proveedores que se instalan con Windows PowerShell.

-Exclude <string[]>

Omite los elementos especificados. El valor de este parámetro califica el parámetro Path. Escriba un patrón o un elemento de la ruta de acceso, como "*.txt". Se permite el uso de caracteres comodín.

-Filter <string>

Especifica un filtro en el formato o lenguaje del proveedor. El valor de este parámetro califica el parámetro Path. La sintaxis del filtro, incluido el uso de caracteres comodín, depende del proveedor. Los filtros son más eficaces que otros parámetros, ya que el proveedor los aplica al recuperar los objetos en lugar de hacer que Windows PowerShell filtre los objetos después de recuperarlos.

-Force

Invalida el atributo de solo lectura, permitiendo agregar contenido a un archivo de solo lectura.

-Include <string[]>

Agrega únicamente los elementos especificados. El valor de este parámetro califica el parámetro Path. Escriba un patrón o un elemento de la ruta de acceso, como "*.txt". Se permite el uso de caracteres comodín.

-LiteralPath <string[]>

Especifica la ruta a los elementos que reciben el contenido adicional. A diferencia de Path, el valor de LiteralPath se usa literalmente como se escribe. Ningún carácter se interpretará como un carácter comodín. Si la ruta incluye caracteres de escape, escríbala entre comillas simples. Las comillas simples indican a Windows PowerShell que no debe interpretar los caracteres como secuencias de escape.

-PassThru

Devuelve un objeto que representa el contenido agregado. De forma predeterminada, este cmdlet no genera resultados.

-Path <string[]>

Especifica la ruta a los elementos que reciben el contenido adicional. Se permite el uso de caracteres comodín. Si especifica varias rutas, debe separarlas con comas.

-Value <Object[]>

Especifica el contenido que se va a agregar. Escriba una cadena entre comillas, como "Estos datos solo son para uso interno", o especifique un objeto que incluya dicho contenido, como el objeto DateTime que el cmdlet Get-Date genera.

No se puede especificar el contenido de un archivo escribiendo su ruta de acceso, ya que esta es solamente una cadena, pero se puede usar un comando Get-Content para obtener el contenido y pasarlo al parámetro Value.

-Confirm

Solicita confirmación antes de ejecutar el comando.

-WhatIf

Describe lo que ocurriría si ejecutara el comando sin ejecutarlo realmente.

-UseTransaction

Incluye el comando en la transacción activa. Este parámetro sólo es válido cuando hay una transacción en curso. Para obtener más información, vea about_Transactions.

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.

Entradas y salidas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.

Notas

Cuando se canaliza un objeto a Add-Content, el objeto se convierte en una cadena antes de agregarse al elemento. El tipo de objeto determina el formato de cadena, pero el formato podría ser diferente de la presentación predeterminada del objeto. Para controlar el formato de cadena, utilice los parámetros de formato del cmdlet que realiza el envío.

También puede hacer referencia a Add-Content mediante su alias integrado, "ac". Para obtener más información, vea about_Aliases.

El cmdlet Add-Content está diseñado para funcionar con los datos expuestos por cualquier proveedor. Para mostrar los proveedores que están disponibles en la sesión, escriba "Get-PsProvider". Para obtener más información, vea about_Providers.

Ejemplo 1

C:\PS>add-content -path *.txt -exclude help* -value "END"

Descripción
-----------
Este comando agrega "END" a todos los archivos de texto del directorio actual, con la excepción de aquéllos cuyos nombres empiecen por "help".

Ejemplo 2

C:\PS>add-content -Path file1.log, file2.log -Value (get-date) -passthru

Descripción
-----------
Este comando agrega la fecha al final de los archivos File1.log y File2.log y después muestra la fecha en la línea de comandos. El comando usa el cmdlet Get-Date para obtener la fecha y utiliza el parámetro Value para pasar la fecha al cmdlet Add-Content. El parámetro PassThru pasa un objeto que representa el contenido agregado a través de la canalización. Como no hay ningún otro cmdlet para recibir el objeto pasado, se muestra en la línea de comandos.

Ejemplo 3

C:\PS>add-content -path monthly.txt -value (get-content c:\rec1\weekly.txt)

Descripción
-----------
Este comando agrega el contenido del archivo Weekly.txt al final del archivo Monthly.txt. Usa el cmdlet Get-Content para obtener el contenido del archivo Weekly.txt y utiliza el parámetro Value para pasar el contenido de Weekly.txt al cmdlet Add-Content. Los paréntesis garantizan que el comando Get-Content se complete antes de que comience el comando Add-Content.

También puede copiar el contenido de Weekly.txt a una variable, como $w, y usar el parámetro Value para pasar la variable al cmdlet Add-Content. En ese caso, el comando sería "add-content -path monthly.txt -value $w".

Ejemplo 4

C:\PS>add-content -value (get-content test.log) -path C:\tests\test134\logs\test134.log

Descripción
-----------
Este comando crea un directorio y un archivo nuevos y copia el contenido de un archivo existente en el archivo que se acaba de crear.

Este comando utiliza el cmdlet Add-Content para agregar el contenido. El valor del parámetro Value es un comando Get-Content que obtiene el contenido de un archivo existente, Test.log. 

El valor del parámetro Path es una ruta de acceso que no existe cuando se ejecuta el comando. En este ejemplo, solo existen los directorios C:\Tests. El comando crea los directorios restantes y el archivo Test134.log.

No se requiere el parámetro Force para este comando. Add-Content crea directorios para completar una ruta de acceso incluso sin el parámetro Force.

Vea también

Conceptos

about_Providers
Get-Content
Set-Content
Clear-Content
Get-Item