Remove-Item

Elimina los elementos especificados.

Sintaxis

Remove-Item [-LiteralPath] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-Recurse] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]

Remove-Item [-Path] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-Recurse] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]

Descripción

El cmdlet Remove-Item elimina uno o varios elementos. Como es compatible con muchos proveedores, puede eliminar muchos tipos diferentes de elementos, incluidos archivos, directorios, claves del Registro, variables, alias y funciones.

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.

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

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

-Force

Permite al cmdlet quitar elementos que no se pueden cambiar de ningún otro modo, como archivos ocultos o de solo lectura, o bien, alias o variables de solo lectura. El cmdlet no puede quitar alias ni variables de constantes. 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.

-Include <string[]>

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

-LiteralPath <string[]>

Especifica una ruta de los elementos que se van a quitar. 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.

-Path <string[]>

Especifica una ruta de los elementos que se van a quitar. Se permite el uso de caracteres comodín. El nombre del parámetro ("-Path") es opcional.

-Recurse

Elimina los elementos de las ubicaciones especificadas y de todos los elementos secundarios de esas ubicaciones.

El parámetro Recurse de este cmdlet no funciona correctamente.

-Confirm

Solicita confirmación antes de ejecutar el comando.

-WhatIf

Describe lo que ocurriría si ejecutara el comando sin ejecutarlo realmente.

-UseTransaction

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

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

Notas

También puede hacer referencia a Remove-Item mediante cualquiera de sus alias integrados, "del", "erase", "rmdir", "rd", "ri" o "rm". Para obtener más información, vea about_Aliases.

El cmdlet Remove-Item está diseñado de modo que funcione 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>remove-item C:\Test\*.*

Descripción
-----------
Este comando elimina todos los archivos del directorio C:\Test cuyo nombre incluya un punto (.). Como el comando especifica un punto, no elimina directorios ni archivos sin extensión.

Ejemplo 2

C:\PS>remove-item * -include *.doc -exclude *1*

Descripción
-----------
Este comando elimina del directorio actual todos los archivos que tengan extensión .doc y cuyo nombre no incluya "1". Usa el carácter comodín (*) para especificar el contenido del directorio actual. Usa los parámetros Include y Exclude para especificar los archivos que se van a eliminar.

Ejemplo 3

C:\PS>remove-item -path C:\Test\hidden-RO-file.txt -force

Descripción
-----------
Este comando elimina un archivo oculto y de sólo lectura. Usa el parámetro Path para especificar el archivo. Usa el parámetro Force para permitir la eliminación del archivo. Sin Force no es posible eliminar archivos ocultos o de sólo lectura.

Ejemplo 4

C:\PS>get-childitem * -include *.csv -recurse | remove-item

Descripción
-----------
Este comando elimina recursivamente todos los archivos CSV del directorio actual y de todos los subdirectorios.

Como el parámetro Recurse de este cmdlet no es correcto, el comando usa el cmdlet Get-Childitem para obtener los archivos y usa el operador de canalización para pasárselos al cmdlet Remove-Item.

En el comando Get-ChildItem, el parámetro Path tiene el valor *, que representa el contenido del directorio actual. Usa el parámetro Include para especificar el tipo de archivo CSV y usa el parámetro Recurse para que la recuperación sea recursiva. 

Si intenta especificar el tipo de archivo en la ruta, como "-path *.csv", el cmdlet interpreta que el objeto buscado es un archivo que no tiene elementos secundarios, por lo que se pierde la recursividad.

Ejemplo 5

C:\PS>remove-item hklm:\software\mycompany\OldApp -recurse

Descripción
-----------
Este comando elimina la clave OldApp del Registro y todas sus subclaves y valores. Usa el cmdlet Remove-Item para quitar la clave. Se especifica la ruta pero se omite el nombre del parámetro (Path), que es opcional. 

El parámetro Recurse elimina de forma recursiva todo el contenido de la clave OldApp. Si la clave contiene subclaves y el usuario omite el parámetro Recurse, se le pedirá que confirme si desea eliminar el contenido de la clave.

Vea también

Conceptos

about_Providers
Clear-Item
Copy-Item
Get-Item
Invoke-Item
Move-Item
New-Item
Remove-ItemProperty
Rename-Item
Set-Item