Agrega contenido a los elementos especificados, como agregar palabras a un archivo.
- la Sintaxis de
- Descripción
- Ejemplos
- Ejemplo 1: Añadir una cadena a todos los archivos de texto con una excepción
- Ejemplo 2: Agregar una fecha al final de los archivos especificados
- Ejemplo 3: Agregue el contenido de un archivo especificado a otro archivo
- Ejemplo 4: Agregue el contenido de un archivo especificado a otro archivo mediante canalización
- Ejemplo 5: Crear un nuevo archivo y copiar contenido
- Ejemplo 6: Añadir contenido a un archivo de solo lectura
- Ejemplo 7: Usar filtros con Contenido adicional
- Parámetros
- Entradas
- Salidas
- Notas
la Sintaxis de
Add-Content <string> <Object> >] >] Add-Content <Object> -LiteralPath <string> >] >] Descripción
El Add-Content cmdlet agrega contenido a un determinado elemento o archivo. Puede especificar el contenido escribiendo el contenido en el comando o especificando un objeto que contenga el contenido.
Si necesita crear archivos o directorios para los siguientes ejemplos, consulte Nuevo elemento.
Ejemplos
Ejemplo 1: Añadir una cadena a todos los archivos de texto con una excepción
Este ejemplo añade un valor a los archivos de texto del directorio actual, pero excluye los archivos en función de su nombre de archivo.
Add-Content -Path .\*.txt -Exclude help* -Value 'End of file'El parámetro Path especifica todos los archivos .txt del directorio actual, pero el parámetro Excluideparameter ignora los nombres de archivo que coinciden con el patrón especificado. El parámetro Valor especifica la cadena de texto que se escribe en los archivos.
Ejemplo 2: Agregar una fecha al final de los archivos especificados
Este ejemplo añade la fecha a los archivos del directorio actual y muestra la fecha en la consola de Powershell.
Add-Content -Path .\DateTimeFile1.log, .\DateTimeFile2.log -Value (Get-Date) -PassThruGet-Content -Path .\DateTimeFile1.logTuesday, May 14, 2019 8:24:27 AMTuesday, May 14, 2019 8:24:27 AM5/14/2019 8:24:27 AMEl Add-Content cmdlet crea dos nuevos archivos en el directorio actual. El parámetro Value contiene la salida del cmdlet Get-Date. El parámetro PassThru muestra el contenido añadido a la canalización.Dado que no hay otro cmdlet para recibir el resultado, se muestra en la consola de PowerShell.El Get-Content cmdlet muestra el archivo actualizado, DateTimeFile1.log.
Ejemplo 3: Agregue el contenido de un archivo especificado a otro archivo
Este ejemplo obtiene el contenido de un archivo y almacena el contenido en una variable. La variable se utiliza para anexar el contenido a otro archivo.
$From = Get-Content -Path .\CopyFromFile.txtAdd-Content -Path .\CopyToFile.txt -Value $FromGet-Content -Path .\CopyToFile.txtGet-Contentcmdlet obtiene el contenido deCopyFromFile.txty almacena el contenido en el$Fromvariable.- El cmdlet
Add-Contentactualiza el archivoCopyToFile.txtutilizando el contenido de la variable$From. - El cmdlet
Get-Contentmuestra el archivo de copia.txt.
Ejemplo 4: Agregue el contenido de un archivo especificado a otro archivo mediante canalización
Este ejemplo obtiene el contenido de un archivo y lo canaliza al cmdlet Add-Content.
Get-Content -Path .\CopyFromFile.txt | Add-Content -Path .\CopyToFile.txtGet-Content -Path .\CopyToFile.txtEl Get-Content cmdlet obtiene el contenido de CopyFromFile.txt. Los resultados se canalizan al cmdletAdd-Content, que actualiza CopyToFile.txt.El último cmdlet Get-Content muestra CopyToFile.txt.
Ejemplo 5: Crear un nuevo archivo y copiar contenido
Este ejemplo crea un nuevo archivo y copia el contenido de un archivo existente en el nuevo archivo.
Add-Content -Path .\NewFile.txt -Value (Get-Content -Path .\CopyFromFile.txt)Get-Content -Path .\NewFile.txt- El cmdlet
Add-Contentutiliza los parámetros de ruta y valor para crear un nuevo archivo en el directorio actual. - El cmdlet
Get-Contentobtiene el contenido de un archivo existente,CopyFromFile.txty lo pasa al parámetro Value. Los paréntesis alrededor del cmdletGet-Contentgarantizan que el comando finalice antes de que comience el comandoAdd-Content. Get-Contentcmdlet muestra el contenido del nuevo archivo,NewFile.txt.
Ejemplo 6: Añadir contenido a un archivo de solo lectura
Este comando añade un valor al archivo incluso si el atributo IsReadOnly está establecido en True.Los pasos para crear un archivo de solo lectura se incluyen en el ejemplo.
New-Item -Path .\IsReadOnlyTextFile.txt -ItemType FileSet-ItemProperty -Path .\IsReadOnlyTextFile.txt -Name IsReadOnly -Value $TrueGet-ChildItem -Path .\IsReadOnlyTextFile.txtAdd-Content -Path .\IsReadOnlyTextFile.txt -Value 'Add value to read-only text file' -ForceGet-Content -Path .\IsReadOnlyTextFile.txtMode LastWriteTime Length Name---- ------------- ------ -----ar-- 1/28/2019 13:35 0 IsReadOnlyTextFile.txt- El cmdlet
New-Itemutiliza los parámetros Path y ItemType para crear el archivoIsReadOnlyTextFile.txten el directorio actual. - El cmdlet
Set-ItemPropertyutiliza los parámetros Name y Value para cambiar la propiedad IsReadOnly del archivo a True. - El cmdlet
Get-ChildItemmuestra que el archivo está vacío (0) y tiene el atributo de solo lectura (r). - El cmdlet
Add-Contentutiliza el parámetro Path para especificar el archivo. El parámetro de valor incluye la cadena de texto que se añade al archivo. El parámetro Force escribe el texto en el archivo de solo lectura. - El cmdlet
Get-Contentutiliza el parámetro Path para mostrar el contenido del archivo.
Para eliminar el atributo de solo lectura, utilice el comando Set-ItemProperty con el conjunto de parámetros de valor False.
Ejemplo 7: Usar filtros con Contenido adicional
Puede especificar un filtro en el cmdlet Add-Content. Al usar filtros para calificar el parámetro de ruta, debe incluir un asterisco final (*) para indicar el contenido de la ruta.
El siguiente comando agrega la palabra «Hecho» el contenido de todos los archivos *.txt en el directorio C:\Temp.
Add-Content -Path C:\Temp\* -Filter *.txt -Value "Done"Parámetros
Especifica que el contenido debe ser leído como una secuencia de bytes. Este parámetro se introdujo en PowerShell 6.0.
Se produce una advertencia cuando se utiliza el parámetro AsByteStream con el parámetro Encoding. TheAsByteStream parameter ignores any encoding and the output is returned as a stream of bytes.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Prompts you for confirmation before running the cmdlet.
| Type: | Parámetro de conmutación |
| Alias: | cf |
| Posición: | Nombre |
| Valor predeterminado: | False |
| Aceptar entrada de canalización: | False | Aceptar caracteres comodín: | False |
Nota
Este parámetro no es compatible con ningún proveedor instalado con PowerShell.To hacerse pasar por otro usuario o elevar las credenciales al ejecutar este cmdlet, utilice Invoke-Command.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Specifies the type of encoding for the target file. The default value is utf8NoBOM.
Encoding is a dynamic parameter that the FileSystem provider adds to the Add-Content cmdlet. Este parámetro solo funciona en unidades del sistema de archivos.
Los valores aceptables para este parámetro son los siguientes:
-
ascii: Utiliza la codificación para el conjunto de caracteres ASCII (7 bits). -
bigendianunicode: Codifica en formato UTF-16 utilizando el orden de bytes big-endian. -
bigendianutf32: Codifica en formato UTF-32 utilizando el orden de bytes big-endian. -
oem: Utiliza la codificación predeterminada para MS-DOS y programas de consola. -
unicode: Codifica en formato UTF-16 utilizando el orden de bytes little-endian. -
utf7: Codifica en formato UTF-7. -
utf8: Codifica en formato UTF-8. -
utf8BOM: Codifica en formato UTF-8 con Marca de Orden de Bytes (BOM) -
utf8NoBOM: Codifica en formato UTF-8 sin Marca de Orden de Bytes (BOM) -
utf32: codificación en UTF-32 formato.
A partir de PowerShell 6.2, el parámetro de codificación también permite identificaciones numéricas de páginas de código registradas (como -Encoding 1251) o nombres de cadena de páginas de código registradas (como-Encoding "windows-1251"). Para obtener más información, consulte la documentación de.NET para codificación.Página de código.
Nota
UTF-7 * ya no se recomienda su uso. En PowerShell 7.1, se escribe una advertencia si especifica utf7 para el parámetro de codificación.
| Tipo: | Codificación |
| valores Aceptados: | ASCII, BigEndianUnicode, BigEndianUTF32, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32 |
| Position: | Named |
| Default value: | UTF8NoBOM |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies, as a string array, an item or items that this cmdlet excludes in the operation. The valueof this parameter qualifies the Path parameter. Introduzca un elemento o patrón de ruta, como*.txt. Se permiten 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.
| Tipo: | String |
| Cargo: | Nombre |
| valor Predeterminado: | Ninguno |
| Aceptar tubería de entrada: | False |
| Aceptar caracteres comodín: | True |
Especifica un filtro para calificar el parámetro Path. FileSystemprovider es el único proveedor de PowerShell instalado que admite el uso de filtros. Puede encontrar la sintaxis para el lenguaje de filtros del sistema de archivos en about_Wildcards.Los filtros son más eficientes que otros parámetros, porque el proveedor los aplica cuando el cmdlet obtiene los objetos en lugar de hacer que PowerShell filtre los objetos después de recuperarlos.
| Tipo: | String |
| Posición: | Nombre |
| valor Predeterminado: | Ninguno |
| Aceptar tubería de entrada: | False |
| Aceptar caracteres comodín: | Sí |
Anula el atributo de sólo lectura, lo que le permite añadir contenido a un archivo de sólo lectura. Por ejemplo,Force anulará el atributo de solo lectura o creará directorios para completar una ruta de archivo, pero no intentará cambiar los permisos de archivo.
| Tipo: | SwitchParameter |
| Posición: | Nombre |
| valor Predeterminado: | Ninguno |
| Aceptar tubería de entrada: | False |
| Aceptar caracteres comodín: | False |
Especifica, como una matriz de cadenas, un elemento o los elementos que este cmdlet se incluye en la operación. El valor de este parámetro califica el parámetro Path. Introduzca un elemento o patrón de ruta, como"*.txt". Se permiten 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.
| Tipo: | String |
| Cargo: | Nombre |
| valor Predeterminado: | Ninguno |
| Aceptar tubería de entrada: | False |
| Aceptar caracteres comodín: | Sí |
Especifica una ruta de acceso a una o más ubicaciones. El valor de LiteralPath se usa exactamente como se escribe. Ningún carácter se interpreta como comodines. Si la ruta de acceso incluye caracteres de escape, escríbala entre comillas simples. Las comillas simples indican a PowerShell que no interprete caracteres como secuencias de escape.
Para obtener más información, consulte about_Quoting_Rules.
| Tipo: | String |
| Alias: | PSPath, LP |
| Cargo: | Nombre |
| valor Predeterminado: | Ninguno |
| Aceptar tubería de entrada: | Sí |
| Aceptar caracteres comodín: | False |
Indica que este cmdlet no agregar una nueva línea o retorno de carro para el 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 añade una nueva línea después de la última cadena de salida.
| Tipo: | SwitchParameter |
| Cargo: | Nombre |
| valor Predeterminado: | Ninguno |
| Aceptar tubería de entrada: | False |
| Aceptar caracteres comodín: | False |
Devuelve un objeto que representa el contenido añadido. De forma predeterminada, este cmdlet no genera ninguna salida.
| Type: | SwitchParameter |
| Cargo: | Nombre |
| valor Predeterminado: | Ninguno |
| Aceptar tubería de entrada: | False |
| Aceptar caracteres comodín: | False |
Especifica la ruta de acceso a los elementos que recibir el contenido adicional.Se permiten caracteres comodín.Las rutas deben ser rutas a elementos, no a contenedores.Por ejemplo, debe especificar una ruta de acceso a uno o más archivos, no una ruta de acceso a un directorio.Si especifica varias rutas, utilice comas para separar las rutas.
| Tipo: | String |
| Cargo: | 0 |
| valor Predeterminado: | Ninguno |
| Aceptar tubería de entrada: | Sí |
| Aceptar caracteres comodín: | Sí |
Nota
Este Parámetro sólo está disponible en Windows.
Especifica un flujo de datos alternativo para el contenido. Si la secuencia no existe, este cmdlet crea sit. No se admiten caracteres comodín.
Stream es un parámetro dinámico que el proveedor del sistema de archivos agrega a Add-Content. Este parámetro solo funciona en unidades del sistema de archivos.
Puede usar el cmdlet Add-Contentpara cambiar el contenido de cualquier secuencia de datos alternativos, como Zone.Identifier. Sin embargo, no recomendamos esta forma de eliminar las comprobaciones de seguridad que bloquean los archivos que se descargan de Internet. Si comprueba que un archivo descargado es seguro, utilice el cmdletUnblock-File.
This parameter was introduced in PowerShell 3.0.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the content to be added. Escriba una cadena entre comillas, como Estos datos son solo para uso interno, o especifique un objeto que contenga contenido, como el objeto DateTime que genera Get-Date.
No puede especificar el contenido de un archivo escribiendo su ruta de acceso, porque la ruta de acceso es solo una cadena.Puede usar un comando Get-Content para obtener el contenido y pasarlo al parámetro Value.
| Tipo: | Objeto |
| Cargo: | 1 |
| valor Predeterminado: | Ninguno |
| Aceptar tubería de entrada: | True |
| Accept wildcard characters: | False |
Shows what would happen if the cmdlet runs. The cmdlet is not run.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
Sistema.Objeto, Sistema.Gestión.Automatización.PSCredential
Puede canalizar valores, rutas o credenciales a Set-Content.
Salidas
Ninguna o Sistema.String
Cuando se utiliza el parámetro PassThru, Add-Content genera un Sistema.Objeto de cadena que representa el contenido. De lo contrario, este cmdlet no genera ningún resultado.
Notas
- Cuando canaliza un objeto a
Add-Content, el objeto se convierte en una cadena antes de añadirlo al elemento. El tipo de objeto determina el formato de cadena, pero el formato puede ser diferente de la visualización predeterminada del objeto. Para controlar el formato de cadena, utilice los parámetros de formato del cmdlet de envío. - Usted también puede referirse a
Add-Contentpor su alias,ac. Para obtener más información, Consulteabout_aliases. - El cmdlet
Add-Contentestá diseñado para funcionar con los datos expuestos por cualquier proveedor. Para listar los proveedores disponibles en su sesión, escribaGet-PSProvider. Para obtener más información, consulte About_providers.
- about_Aliases
- about_Providers
- Borrar Contenido
- Get-Content
- Get-Elemento
- Nuevo Elemento
- Set-Contenido