Remove-Item

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

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

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

Este comando elimina todos los archivos que tienen nombres que incluyen un punto ('.') de la carpeta "C:\Test". Dado que el comando especifica un punto, el comando no elimina carpetas ni archivos que no tienen ninguna extensión de nombre de archivo.

Remove-Item C:\Test\*.*

Este comando elimina de la carpeta actual todos los archivos que tienen una extensión de nombre de archivo ".doc" y un nombre que no incluye 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.

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

Este comando elimina un archivo que es ocultos y de solo lectura . Usa el parámetro path para especificar el archivo. Usa el parámetro Force para eliminarlo. Sin Force, no puede eliminar de solo lectura ni archivos ocultos.

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

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

Dado que el parámetro Recurse en 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.

En el comando Get-ChildItem, Ruta de acceso tiene un valor de "*", que representa el contenido de la carpeta actual. Usa incluir para especificar el tipo de archivo CSV y usa Recurse para que la recuperación sea recursiva.

Si intenta especificar el tipo de archivo la ruta de acceso, como -Path *.csv, el cmdlet interpreta el asunto de la búsqueda para que sea un archivo que no tenga elementos secundarios y error de recurse.

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

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

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

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

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

El primer comando usa el stream parámetro dinámico del cmdlet Get-Item para obtener el flujo de Zone.Identifier del archivo "Copy-Script.ps1".

El segundo comando usa el stream parámetro dinámico del cmdlet Remove-Item para quitar el flujo de Zone.Identifier del archivo.

El tercer comando usa el stream parámetro dinámico del cmdlet para comprobar que se elimina la secuencia de Zone.Identifier.

El cuarto comando Get-Item cmdlet sin el parámetro Stream para comprobar que el archivo no se ha eliminado.

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'.
At line:1 char:1
+ Get-Item 'C:\Test\Copy-Script.ps1' -Stream Zone.Identifier
+ [!INCLUDE[]()][!INCLUDE[]()][!INCLUDE[]()][!INCLUDE[]()][!INCLUDE[]()]~~
    + CategoryInfo          : ObjectNotFound: (C:\Test\Copy-Script.ps1:String) [Get-Item], FileNotFoundE
   xception
    + FullyQualifiedErrorId : AlternateDataStreamNotFound,Microsoft.PowerShell.Commands.GetItemCommand

Get-Item C:\Test\Copy-Script.ps1

    Directory: C:\Test

Mode                LastWriteTime     Length Name
----                -------------     ------ ----
-a---          8/4/2011  11:15 AM       9436 Copy-Script.ps1

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Puede pasar una cadena que contenga una ruta, pero no una ruta literal, a este cmdlet.

Este cmdlet no genera resultados de ningún tipo.

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