Set-Content

Sintaxis

Path (valor predeterminado)

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

Set-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: Reemplazar el contenido de varios archivos en un directorio

Get-ChildItem -Path .\Test*.txt

Test1.txt
Test2.txt
Test3.txt

Set-Content -Path .\Test*.txt -Value 'Hello, World'
Get-Content -Path .\Test*.txt

Hello, World
Hello, World
Hello, World

Ejemplo 2: Crear un nuevo archivo y escribir contenido

Set-Content -Path .\DateTime.txt -Value (Get-Date)
Get-Content -Path .\DateTime.txt

1/30/2019 09:55:08

Ejemplo 3: Reemplazar texto en un archivo

Get-Content -Path .\Notice.txt

Warning
Replace Warning with a new word.
The word Warning was replaced.

(Get-Content -Path .\Notice.txt) |
    ForEach-Object {$_ -Replace 'Warning', 'Caution'} |
        Set-Content -Path .\Notice.txt
Get-Content -Path .\Notice.txt

Caution
Replace Caution with a new word.
The word Caution was replaced.

Ejemplo 4: Usar filtros con Set-Content

Set-Content -Path C:\Temp\* -Filter *.txt -Value "Empty"

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.

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

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.
• valor predeterminado 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.
• cadena igual que Unicode .
• unicode usa UTF-16 con el orden de bytes little-endian.
• desconocido 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 a Set-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 una vez recuperados.

Propiedades de parámetro

Conjuntos de parámetros

-Force

Obliga al cmdlet a establecer el contenido de un archivo, incluso si el archivo es de solo lectura. La implementación varía de proveedor a proveedor. Para obtener más información, consulte about_Providers. El parámetro Force no invalida las restricciones de seguridad.

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

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. De forma predeterminada, este cmdlet no genera ninguna salida.

Propiedades de parámetro

Conjuntos de parámetros

-Path

Especifica la ruta de acceso del elemento que recibe el contenido. Se permite el uso de caracteres comodín.

Propiedades de parámetro

Conjuntos de parámetros

-Stream

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

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

Puede usar el cmdlet Set-Content para cambiar el contenido del Zone.Identifier flujo de datos alternativo. 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 nuevo contenido del elemento.

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

Salidas

None or System.String

Notas

Vínculos relacionados

• about_Aliases
• about_Automatic_Variables.md
• Acerca de los Proveedores
• about_Transactions
• Agregar contenido
• Borrar contenido
• Get-ChildItem
• Get-Content
• ForEach-Object
• New-Item