Elimina el contenido de un elemento (por ejemplo, elimina el texto de un archivo), pero no elimina el elemento en sí.
Sintaxis
Clear-Content [-LiteralPath] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>] Clear-Content [-Path] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]
Descripción
El cmdlet Clear-Content elimina el contenido de un elemento (por ejemplo, elimina el texto de un archivo), pero no elimina el elemento en sí. Como resultado, el elemento seguirá existiendo, pero vacío. Clear-Content es similar a Clear-Item, pero se aplica a archivos, en lugar de a alias y variables.
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.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-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.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-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.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Force
Permite al cmdlet borrar el contenido de un archivo aunque se trate de un archivo de solo lectura. La implementación varía según el proveedor. Para obtener más información, vea about_Providers. Incluso si se usa el parámetro Force, el cmdlet no puede invalidar las restricciones de seguridad.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Include <string[]>
Borra ú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.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-LiteralPath <string[]>
Especifica las rutas de acceso de los elementos de los que se elimina contenido. 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.
|
¿Requerido? |
true |
|
¿Posición? |
1 |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-Path <string[]>
Especifica las rutas de acceso de los elementos de los que se elimina contenido. Se permite el uso de caracteres comodín. Deben ser rutas de acceso 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. Se permite el uso de caracteres comodín. Este parámetro es obligatorio, pero el nombre del parámetro ("Path") es opcional.
|
¿Requerido? |
true |
|
¿Posición? |
1 |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-Confirm
Solicita confirmación antes de ejecutar el comando.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-WhatIf
Describe lo que ocurriría si ejecutara el comando sin ejecutarlo realmente.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-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.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
<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.
|
Entradas |
Ninguno No se pueden canalizar objetos a Clear-Content. |
|
Salidas |
Ninguno Este cmdlet no devuelve objetos. |
Notas
También puede hacer referencia a Clear-Content mediante su alias integrado, "clc". Para obtener más información, vea about_Aliases.
Si se omite el nombre del parámetro -Path, el valor de Path debe ser el primer parámetro del comando. Por ejemplo, "clear-content c:\mydir\*.txt". Si se incluye el nombre del parámetro, se pueden enumerar los parámetros en cualquier orden.
Puede usar Clear-Content con el proveedor FileSystem de Windows PowerShell y con otros proveedores que manipulan contenido. Para borrar elementos que no se consideran contenido, como los elementos administrados por los proveedores Certificate o Registry de Windows PowerShell, use Clear-Item.
El cmdlet Clear-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>clear-content ..\SmpUsers\*\init.txt Descripción ----------- Este comando elimina todo el contenido de los archivos "init.txt" en todos los subdirectorios del directorio SmpUsers. No se eliminan los archivos, pero quedan vacíos.
Ejemplo 2
C:\PS>clear-content -path * -filter *.log -force Descripción ----------- Este comando elimina el contenido de todos los archivos del directorio actual con la extensión ".log", incluidos los archivos con el atributo de sólo lectura. El asterisco (*) de la ruta representa a todos los elementos del directorio actual. El parámetro Force hace que el comando surta efecto en archivos de sólo lectura. La operación tardará menos si se usa un filtro para restringir el comando a archivos con la extensión ".log", en lugar de especificar "*.log" en la ruta de acceso.
Ejemplo 3
C:\PS>clear-content c:\Temp\* -Include Smp* -Exclude *2* -whatif Descripción ----------- Este comando solicita una predicción de lo que sucedería si se ejecuta el comando: "clear-content c:\temp\* -include smp* -exclude *2*". El resultado muestra los archivos que se borrarían; en este caso, los archivos del directorio Temp cuyos nombres empiecen por "Smp", a menos que los nombres de archivo incluyan un "2". Para ejecutar realmente el comando, vuelva a ejecutarlo sin el parámetro Whatif.
Vea también