Add-Content

Sintaxis

Path (valor predeterminado)

Add-Content
    [-Path] <string[]>
    [-Value] <Object[]>
    [-PassThru]
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Force]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [-NoNewline]
    [-Encoding <FileSystemCmdletProviderEncoding>]
    [-Stream <string>]
    [<CommonParameters>]

LiteralPath

Add-Content
    [-Value] <Object[]>
    -LiteralPath <string[]>
    [-PassThru]
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Force]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [-NoNewline]
    [-Encoding <FileSystemCmdletProviderEncoding>]
    [-Stream <string>]
    [<CommonParameters>]

Description

Ejemplos

Ejemplo 1: Agregar una cadena a todos los archivos de texto con una excepción

Add-Content -Path .\*.txt -Exclude help* -Value 'End of file'

Ejemplo 2: Agregar una fecha al final de los archivos especificados

Add-Content -Path .\DateTimeFile1.log, .\DateTimeFile2.log -Value (Get-Date) -PassThru
Get-Content -Path .\DateTimeFile1.log

Tuesday, May 14, 2019 8:24:27 AM
Tuesday, May 14, 2019 8:24:27 AM
5/14/2019 8:24:27 AM

Ejemplo 3: Agregar el contenido de un archivo especificado a otro archivo

$From = Get-Content -Path .\CopyFromFile.txt
Add-Content -Path .\CopyToFile.txt -Value $From
Get-Content -Path .\CopyToFile.txt

Ejemplo 4: Agregar el contenido de un archivo especificado a otro archivo mediante la canalización

Get-Content -Path .\CopyFromFile.txt | Add-Content -Path .\CopyToFile.txt
Get-Content -Path .\CopyToFile.txt

Ejemplo 5: Crear un nuevo archivo y copiar contenido

Add-Content -Path .\NewFile.txt -Value (Get-Content -Path .\CopyFromFile.txt)
Get-Content -Path .\NewFile.txt

Ejemplo 6: Agregar contenido a un archivo de solo lectura

New-Item -Path .\IsReadOnlyTextFile.txt -ItemType File
Set-ItemProperty -Path .\IsReadOnlyTextFile.txt -Name IsReadOnly -Value $true
Get-ChildItem -Path .\IsReadOnlyTextFile.txt
Add-Content -Path .\IsReadOnlyTextFile.txt -Value 'Add value to read-only text file' -Force
Get-Content -Path .\IsReadOnlyTextFile.txt

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-ar--         1/28/2019     13:35              0 IsReadOnlyTextFile.txt

Parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Conjuntos de parámetros

-Credential

Propiedades de parámetro

Conjuntos de parámetros

-Encoding

Especifica el tipo de codificación para el archivo de destino. El valor predeterminado es Default.

Los valores aceptables para este parámetro son los siguientes:

• Ascii usa el juego de caracteres ASCII (7 bits).
• BigEndianUnicode Usa UTF-16 con el orden de bytes big-endian.
• BigEndianUTF32 Usa UTF-32 con el orden de bytes big-endian.
• Byte Codifica un conjunto de caracteres en una secuencia de bytes.
• Default Usa la codificación que corresponde a la página de códigos activa del sistema (normalmente ANSI).
• Oem Usa la codificación que corresponde a la página de códigos oem actual del sistema.
• String Igual que Unicode .
• Unicode Usa UTF-16 con el orden de bytes little-endian.
• Unknown Igual que Unicode .
• UTF7 usa UTF-7.
• UTF8 usa UTF-8.
• UTF32 Usa UTF-32 con el orden de bytes little-endian.

La codificación es un parámetro dinámico que el proveedor FileSystem agrega al cmdlet Add-Content. Este parámetro solo funciona en unidades del sistema de archivos.

Propiedades de parámetro

Conjuntos de parámetros

-Exclude

Especifica, como matriz de cadenas, un elemento o elementos que este cmdlet excluye en la operación. El valor de este parámetro define el parámetro Path. Escriba un elemento de ruta o patrón, como *.txt. Se permite el uso de caracteres comodín. El parámetro Exclude solo es efectivo cuando el comando incluye el contenido de un elemento, como C:\Windows\*, donde el carácter comodín especifica el contenido del directorio C:\Windows.

Propiedades de parámetro

Conjuntos de parámetros

-Filter

Especifica un filtro para calificar el parámetro Path. El proveedor de FileSystem es el único proveedor de PowerShell instalado que admite el uso de filtros. Puede encontrar la sintaxis del lenguaje de filtro de FileSystem en about_Wildcards. Los filtros son más eficaces que otros parámetros, ya que el proveedor los aplica cuando el cmdlet obtiene los objetos en lugar de que PowerShell filtre los objetos después de recuperarlos.

Propiedades de parámetro

Conjuntos de parámetros

-Force

Invalida el atributo de solo lectura, lo que le permite agregar contenido a un archivo de solo lectura. Por ejemplo, Force invalida el atributo de solo lectura, pero no cambia los permisos de archivo.

Propiedades de parámetro

Conjuntos de parámetros

-Include

Especifica, como matriz de cadenas, un elemento o elementos que este cmdlet incluye en la operación. El valor de este parámetro define el parámetro Path. Escriba un elemento de ruta o patrón, como "*.txt". Se permite el uso de caracteres comodín. El parámetro Include solo es efectivo cuando el comando incluye el contenido de un elemento, como C:\Windows\*, donde el carácter comodín especifica el contenido del directorio C:\Windows.

Propiedades de parámetro

Conjuntos de parámetros

-LiteralPath

Especifica una ruta de acceso a una o varias ubicaciones. El valor de LiteralPath se usa exactamente tal como está escrito. Ninguno de los caracteres se interpreta como caracteres comodín. Si la ruta de acceso incluye caracteres de escape, escríbala entre comillas simples. Las comillas simples indican a PowerShell que no interprete ningún carácter como secuencias de escape.

Para obtener más información, consulte sobre_las_normas_de_citación.

Propiedades de parámetro

Conjuntos de parámetros

-NoNewline

Indica que este cmdlet no agrega una nueva línea o retorno de carro al contenido.

Las representaciones de cadena de los objetos de entrada se concatenan para formar la salida. No se insertan espacios ni nuevas líneas entre las cadenas de salida. No se agrega ninguna nueva línea después de la última cadena de salida.

Propiedades de parámetro

Conjuntos de parámetros

-PassThru

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

Propiedades de parámetro

Conjuntos de parámetros

-Path

Especifica la ruta de acceso a los elementos que reciben el contenido adicional. Se permite el uso de caracteres comodín. Las rutas de acceso deben ser rutas de acceso a elementos, no a contenedores. Por ejemplo, debe especificar una ruta de acceso a uno o varios archivos, no una ruta de acceso a un directorio. Si especifica varias rutas de acceso, use comas para separar las rutas de acceso.

Propiedades de parámetro

Conjuntos de parámetros

-Stream

Especifica un flujo de datos alternativo para el contenido. Si el flujo no existe, este cmdlet lo crea. No se admiten caracteres comodín.

Stream es un parámetro dinámico que el proveedor FileSystem agrega a Add-Content. Este parámetro solo funciona en unidades del sistema de archivos.

Puede usar el cmdlet Add-Content para cambiar el contenido de cualquier flujo de datos alternativo, como Zone.Identifier. Sin embargo, no se recomienda esto como una manera de eliminar las comprobaciones de seguridad que bloquean los archivos que se descargan de Internet. Si comprueba que un archivo descargado es seguro, use el cmdlet Unblock-File.

Este parámetro se introdujo en PowerShell 3.0.

Propiedades de parámetro

Conjuntos de parámetros

-UseTransaction

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

Propiedades de parámetro

Conjuntos de parámetros

-Value

Especifica el contenido que se va a agregar. Escriba una cadena entrecomillada, como Estos datos son solo para uso internoo especifiquen un objeto que contenga contenido, como el objeto DateTime que Get-Date genera.

No se puede especificar el contenido de un archivo escribiendo su ruta de acceso, porque la ruta de acceso es simplemente una cadena. Puede usar un comando Get-Content para obtener el contenido y pasarlo al parámetro Value.

Propiedades de parámetro

Conjuntos de parámetros

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Propiedades de parámetro

Conjuntos de parámetros

CommonParameters

Entradas

Object

PSCredential

Salidas

None

String

Notas

Vínculos relacionados

• about_Aliases
• Acerca de los Proveedores
• about_Transactions
• Borrar contenido
• Get-Content
• Get-Item
• New-Item
• Set-Content