Compartir a través de

Clear-Content

  • Referencia
Módulo:
Microsoft.PowerShell.Management

Elimina el contenido de un elemento, pero no elimina el elemento.

Sintaxis

Clear-Content
     [-Path] <String[]>
     [-Filter <String>]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-Force]
     [-Credential <PSCredential>]
     [-WhatIf]
     [-Confirm]
     [-UseTransaction]
     [-Stream <String>]
     [<CommonParameters>]
Clear-Content
     -LiteralPath <String[]>
     [-Filter <String>]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-Force]
     [-Credential <PSCredential>]
     [-WhatIf]
     [-Confirm]
     [-UseTransaction]
     [-Stream <String>]
     [<CommonParameters>]

Description

El cmdlet Clear-Content elimina el contenido de un elemento, como eliminar el texto de un archivo, pero no elimina el elemento. Como resultado, el elemento existe, pero está vacío. El Clear-Content es similar a Clear-Item, pero funciona en elementos con contenido, en lugar de elementos con valores.

Ejemplos

Ejemplo 1: Eliminar todo el contenido de un directorio

Clear-Content "..\SmpUsers\*\init.txt"

Este comando elimina todo el contenido de los archivos "init.txt" en todos los subdirectorios del directorio SmpUsers. Los archivos no se eliminan, pero están vacíos.

Ejemplo 2: Eliminar contenido de todos los archivos con un carácter comodín

Clear-Content -Path "*" -Filter "*.log" -Force

Este comando elimina el contenido de todos los archivos del directorio actual con la extensión de nombre de archivo ".log", incluidos los archivos con el atributo de solo lectura. El asterisco (*) de la ruta de acceso representa todos los elementos del directorio actual. El parámetro Force hace que el comando sea eficaz en los archivos de solo lectura. El uso de un filtro para restringir el comando a los archivos con la extensión de nombre de archivo .log en lugar de especificar *.log en la ruta de acceso hace que la operación sea más rápida.

Ejemplo 3: Borrar todos los datos de una secuencia

En este ejemplo se muestra cómo el cmdlet Clear-Content borra el contenido de un flujo de datos alternativo mientras deja intacto el flujo.

El primer comando usa el cmdlet Get-Content para obtener el contenido de la secuencia Zone.Identifier en el archivo Copy-Script.ps1, que se descargó de Internet.

El segundo comando usa el cmdlet Clear-Content para borrar el contenido.

El tercer comando repite el primer comando. Comprueba que se borra el contenido, pero la secuencia permanece. Si se eliminó la secuencia, el comando generaría un error.

Puede usar un método como este para borrar el contenido de un flujo de datos alternativo. Sin embargo, no es la manera recomendada 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.

Get-Content C:\Test\Copy-Script.ps1 -Stream Zone.Identifier

[ZoneTransfer]
ZoneId=3

Clear-Content C:\Test\Copy-Script.ps1 -Stream Zone.Identifier
Get-Content C:\Test\Copy-Script.ps1 -Stream Zone.Identifier

Parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Credential

Nota

Este parámetro no es compatible con ningún proveedor instalado con PowerShell. Para suplantar a otro usuario o elevar las credenciales al ejecutar este cmdlet, use Invoke-Command.

Tipo:PSCredential
Posición:Named
Valor predeterminado:Current user
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Exclude

Especifica, como matriz de cadenas, cadenas que este cmdlet omite de la ruta de acceso al contenido. El valor de este parámetro califica el parámetro Path. Escriba un elemento o patrón de ruta de acceso, como "*.txt". Se permiten caracteres comodín.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

-Filter

Especifica un filtro en el formato o idioma 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 que PowerShell filtre los objetos una vez recuperados.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

-Force

Obliga a que el comando se ejecute sin pedir confirmación del usuario.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Include

Especifica, como matriz de cadenas, el contenido que borra este cmdlet. El valor de este parámetro califica el parámetro Path. Escriba un elemento o patrón de ruta de acceso, como "*.txt". Se permiten caracteres comodín.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

-LiteralPath

Especifica las rutas de acceso a los elementos desde los que se elimina el contenido. A diferencia del parámetro path de , el valor de LiteralPath se usa exactamente como se escribe. No se interpreta ningún carácter como caracteres comodín. Si la ruta de acceso incluye caracteres de escape, escríbala entre comillas simples. Las comillas simples indican que PowerShell no interprete ningún carácter como secuencias de escape.

Tipo:String[]
Alias:PSPath
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Path

Especifica las rutas de acceso a los elementos desde los que se elimina el contenido. Se permiten 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. Se permiten caracteres comodín. Este parámetro es obligatorio, pero el nombre del parámetro ("Path") es opcional.

Tipo:String[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:True

-Stream

Especifica un flujo de datos alternativo para el contenido. Si la secuencia 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 Clear-Content. Este parámetro solo funciona en unidades del sistema de archivos.

Puede usar el cmdlet Clear-Content para cambiar el contenido del flujo de datos alternativo 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 Windows PowerShell 3.0.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

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

Tipo:SwitchParameter
Alias:usetx
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

No se pueden canalizar objetos a Clear-Content.

Salidas

None

Este cmdlet no devuelve ningún objeto .

Notas

Puede usar Clear-Content con el proveedor FileSystem de PowerShell y con otros proveedores que manipulan el contenido. Para borrar los elementos que no se consideran contenido, como los elementos administrados por los proveedores de certificados o del Registro de PowerShell, use Clear-Item.

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