Remove-Item

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

Met de cmdlet Remove-Item worden een of meer items verwijderd. Omdat het door veel providers wordt ondersteund, kan het veel verschillende typen items verwijderen, waaronder bestanden, mappen, registersleutels, variabelen, aliassen en functies.

In dit voorbeeld worden alle bestanden met namen met een punt (.) uit de map C:\Test verwijderd. Omdat met de opdracht een punt wordt opgegeven, worden mappen of bestanden die geen bestandsextensie hebben, niet verwijderd.

Remove-Item C:\Test\*.*

In dit voorbeeld worden alle bestanden verwijderd uit de huidige map met een .doc bestandsextensie en een naam die geen *1*bevat.

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

Het jokerteken (*) wordt gebruikt om de inhoud van de huidige map op te geven. Het maakt gebruik van de Include en Exclude parameters om de bestanden op te geven die moeten worden verwijderd.

Met deze opdracht verwijdert u een bestand dat zowel verborgen als alleen-lezenis.

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

Hierbij wordt de parameter Path gebruikt om het bestand op te geven. Hierbij wordt de parameter Force gebruikt om deze te verwijderen. Zonder forcerenkunt u alleen-lezen of verborgen bestanden niet verwijderen.

Met deze opdracht worden alle CSV-bestanden in de huidige map en alle submappen recursief verwijderd.

Omdat de parameter Recurse in Remove-Item een bekend probleem heeft, gebruikt de opdracht in dit voorbeeld Get-ChildItem om de gewenste bestanden op te halen en gebruikt vervolgens de pijplijnoperator om deze door te geven aan Remove-Item.

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

In de opdracht Get-ChildItem heeft Pad de waarde (*) die de inhoud van de huidige map vertegenwoordigt. Het maakt gebruik van Include om het CSV-bestandstype op te geven en gebruikt Recurse- om het ophalen recursief te maken. Als u probeert het bestandstype op te geven in het pad, zoals -Path *.csv, interpreteert de cmdlet het onderwerp van de zoekopdracht als een bestand dat geen onderliggende items bevat en Recurse- mislukt.

Met deze opdracht verwijdert u de registersleutel OldApp en alle bijbehorende subsleutels en -waarden. Remove-Item wordt gebruikt om de sleutel te verwijderen. Het pad is opgegeven, maar de optionele parameternaam (Pad) wordt weggelaten.

De parameter Recurse verwijdert alle inhoud van de sleutel OldApp recursief. Als de sleutel subsleutels bevat en u de parameter Recurse weglaat, wordt u gevraagd om te bevestigen dat u de inhoud van de sleutel wilt verwijderen.

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

In het volgende voorbeeld ziet u hoe u bestanden verwijdert die speciale tekens bevatten, zoals vierkante haakjes of ronde haakjes.

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

In dit voorbeeld ziet u hoe u de Stream dynamische parameter van de Remove-Item-cmdlet gebruikt om een alternatieve gegevensstroom te verwijderen. De streamparameter wordt geïntroduceerd in 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'.

De parameter StreamGet-Item haalt de Zone.Identifier stream van het Copy-Script.ps1-bestand op. Remove-Item gebruikt de parameter Stream om de Zone.Identifier stroom van het bestand te verwijderen. Ten slotte ziet u in de Get-Item cmdlet dat de Zone.Identifier stream is verwijderd.

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

U kunt een tekenreeks die een pad bevat naar deze cmdlet pijpen, maar niet een letterlijk pad.

Deze cmdlet retourneert geen uitvoer.

PowerShell bevat de volgende aliassen voor Remove-Item:

• Alle platforms:
  • del
  • erase
  • rd
  • ri
• Windows:
  • rm
  • rmdir

De cmdlet Remove-Item is ontworpen om te werken met de gegevens die door elke provider worden weergegeven. Als u de providers wilt weergeven die beschikbaar zijn in uw sessie, typt u Get-PSProvider. Zie about_Providersvoor meer informatie.

Wanneer u probeert een map te verwijderen die items bevat zonder de parameter Recurse te gebruiken, wordt er om bevestiging gevraagd. Als u -Confirm:$false gebruikt, wordt de prompt niet onderdrukt. Dit is standaard.