Remove-Item

Módulo:

Microsoft.PowerShell.Management

Elimina los elementos especificados.

Sintaxis

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

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

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

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

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

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

Description

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

Ejemplos

Ejemplo 1: Eliminar archivos que tengan cualquier extensión de archivo

En este ejemplo se eliminan todos los archivos con nombres que incluyen un punto (.) de la C:\Test carpeta. Dado que el comando especifica un punto, el comando no elimina carpetas ni archivos que no tienen ninguna extensión de archivo.

Remove-Item C:\Test\*.*

Ejemplo 2: Eliminación de archivos de documento en una carpeta

En este ejemplo se elimina de la carpeta actual todos los archivos que tienen una .doc extensión de archivo y un nombre que no incluye *1*.

Remove-Item * -Include *.doc -Exclude *1*

Usa el carácter comodín (*) para especificar el contenido de la carpeta actual. Usa los parámetros Include y Exclude para especificar los archivos que se van a eliminar.

Ejemplo 3: Eliminar archivos ocultos y de solo lectura

Este comando elimina un archivo que está oculto y de solo lectura.

Remove-Item -Path C:\Test\hidden-RO-file.txt -Force

Usa el parámetro Path para especificar el archivo. Usa el parámetro Force para eliminarlo. Sin Force, no se pueden eliminar archivos de solo lectura ni ocultos .

Ejemplo 4: Eliminación de archivos en subcarpetas de forma recursiva

Este comando elimina todos los archivos CSV de la carpeta actual y todas las subcarpetas de forma recursiva.

Dado que el parámetro Recurse de Remove-Item tiene un problema conocido, el comando de este ejemplo usa Get-ChildItem para obtener los archivos deseados y, a continuación, usa el operador de canalización para pasarlos a Remove-Item.

Get-ChildItem * -Include *.csv -Recurse | Remove-Item

En el Get-ChildItem comando, Path tiene un valor de (*), que representa el contenido de la carpeta actual. Usa Include para especificar el tipo de archivo CSV y usa Recurse para hacer que la recuperación sea recursiva. Si intenta especificar el tipo de archivo en la ruta de acceso, como -Path *.csv, el cmdlet interpreta el asunto de la búsqueda como un archivo que no tiene elementos secundarios y se produce un error en Recurse .

Nota:

Este comportamiento se corrigió en las versiones 1909 y posteriores de Windows.

Ejemplo 5: Eliminar subclaves de forma recursiva

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

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

Remove-Item HKLM:\Software\MyCompany\OldApp -Recurse

Ejemplo 6: Eliminación de archivos con caracteres especiales

En el ejemplo siguiente se muestra cómo eliminar archivos que contienen caracteres especiales como corchetes o paréntesis.

Get-ChildItem

Directory: C:\temp\Downloads

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a---          6/1/2018  12:19 PM           1362 myFile.txt
-a---          6/1/2018  12:30 PM           1132 myFile[1].txt
-a---          6/1/2018  12:19 PM           1283 myFile[2].txt
-a---          6/1/2018  12:19 PM           1432 myFile[3].txt

Get-ChildItem | Where-Object Name -Like '*`[*'

Directory: C:\temp\Downloads

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a---          6/1/2018  12:30 PM           1132 myFile[1].txt
-a---          6/1/2018  12:19 PM           1283 myFile[2].txt
-a---          6/1/2018  12:19 PM           1432 myFile[3].txt

Get-ChildItem | Where-Object Name -Like '*`[*' | ForEach-Object { Remove-Item -LiteralPath $_.Name }
Get-ChildItem

Directory: C:\temp\Downloads

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a---          6/1/2018  12:19 PM           1362 myFile.txt

Ejemplo 7: Eliminación de un flujo de datos alternativo

En este ejemplo se muestra cómo usar el parámetro dinámico Stream del Remove-Item cmdlet para eliminar un flujo de datos alternativo. El parámetro stream se presenta en Windows PowerShell 3.0.

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

FileName: \\C:\Test\Copy-Script.ps1

Stream                   Length
------                   ------
Zone.Identifier              26

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

Get-Item : Could not open alternate data stream 'Zone.Identifier' of file 'C:\Test\Copy-Script.ps1'.

El parámetro Get-Item Stream obtiene la Zone.Identifier secuencia del Copy-Script.ps1 archivo. Remove-Item usa el parámetro Stream para quitar la Zone.Identifier secuencia del archivo. Por último, el Get-Item cmdlet muestra que se eliminó la Zone.Identifier secuencia.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet. Vea los siguientes artículos para más información:

• about_Preference_Variables
• about_Functions_CmdletBindingAttribute

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

-DeleteKey

Este es un parámetro dinámico que el proveedor de certificados pone a disposición. El proveedor de certificados y este parámetro solo están disponibles en las plataformas Windows.

Cuando se proporciona, el cmdlet elimina la clave privada cuando se elimina el certificado.

Para obtener más información, consulte about_Certificate_Provider.

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

-Exclude

Especifica, como matriz de cadenas, un elemento o elementos que este cmdlet excluye en la operación. El valor de este parámetro califica el parámetro Path . Escriba un elemento o patrón de ruta de acceso, 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 C:\Windows directorio.

Cuando se usa Recurse con Exclude, Exclude solo filtra los resultados del directorio actual. Si hay archivos que coinciden con el patrón Exclude en subcarpetas, esos archivos se quitan junto con su directorio primario.

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 para calificar el parámetro Path . El proveedor FileSystem es el único proveedor de PowerShell instalado que admite el uso de filtros. Puede encontrar la sintaxis del lenguaje de filtro 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 después de recuperarlos.

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

-Force

Obliga al cmdlet a quitar elementos que, de lo contrario, no se pueden cambiar, como archivos ocultos o de solo lectura o alias o variables de solo lectura. El cmdlet no puede quitar alias o variables constantes. La implementación varía en función del proveedor. Para obtener más información, consulte about_Providers. Incluso con el parámetro Force , el cmdlet no puede invalidar las restricciones de seguridad.

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, un elemento o elementos que este cmdlet incluye en la operación. El valor de este parámetro califica el parámetro Path . Escriba un elemento o patrón de ruta de acceso, 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 C:\Windows directorio.

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

-LiteralPath

Especifica una ruta de acceso a una o varias ubicaciones. El valor de LiteralPath se usa exactamente como se escribe. Ninguno de los caracteres se interpreta como caracteres comodín. Si la ruta de acceso contiene caracteres de escape, escríbalos 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 about_Quoting_Rules.

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

-Path

Especifica una ruta de acceso de los elementos que se quitan. Se permite el uso de caracteres comodín.

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

-Recurse

Indica que este cmdlet elimina los elementos de las ubicaciones especificadas y en todos los elementos secundarios de las ubicaciones.

Es posible que el parámetro Recurse no elimine todas las subcarpetas o todos los elementos secundarios. Este es un problema conocido.

Nota:

Este comportamiento se corrigió en las versiones 1909 y posteriores de Windows.

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

-Stream

Se trata de un parámetro dinámico que el proveedor FileSystem pone a disposición. Este parámetro solo está disponible en Windows. Este parámetro no se puede usar en combinación con el parámetro Recurse .

Puede usar Remove-Item para eliminar un flujo de datos alternativo, como Zone.Identifier. 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 Unblock-File cmdlet .

Este parámetro se incorporó en Windows PowerShell 3.0. A partir de Windows PowerShell 7.2, Remove-Item puede quitar flujos de datos alternativos de directorios, así como archivos.

Para obtener más información, consulte about_FileSystem_Provider.

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

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. 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

String

Puede canalizar una cadena que contenga una ruta de acceso, pero no una ruta de acceso literal, a este cmdlet.

Salidas

None

Este cmdlet no devuelve ningún resultado.

Notas

PowerShell incluye los siguientes alias para Remove-Item:

• Todas las plataformas:
  • del
  • erase
  • rd
  • ri
• Windows:
  • rm
  • rmdir

El Remove-Item cmdlet 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, consulte about_Providers.

Al intentar eliminar una carpeta que contiene elementos sin usar el parámetro Recurse , el cmdlet solicita confirmación. El uso -Confirm:$false de no suprime el mensaje. es así por diseño.

Vínculos relacionados

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