Remove-Item

Syntax

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

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

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

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

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

Beschreibung

Das Remove-Item Cmdlet löscht mindestens ein Element. Da es von vielen Anbietern unterstützt wird, kann es viele verschiedene Arten von Elementen löschen, darunter Dateien, Ordner, Registrierungsschlüssel, Variablen, Aliase und Funktionen.

Beispiele

Beispiel 1: Löschen von Dateien mit dateierweiterung

In diesem Beispiel werden alle Dateien mit Namen gelöscht, die einen Punkt (.) aus dem C:\Test Ordner enthalten. Da der Befehl einen Punkt angibt, löscht der Befehl keine Ordner oder Dateien ohne Dateierweiterung.

Remove-Item C:\Test\*.*

Beispiel 2: Löschen von Dokumentdateien in einem Ordner

In diesem Beispiel wird aus dem aktuellen Ordner alle Dateien gelöscht, die über eine .doc Dateierweiterung und einen Namen verfügen, der nicht enthalten *1*ist.

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

Es verwendet das Wildcardzeichen (*), um den Inhalt des aktuellen Ordners anzugeben. Sie verwendet die Parameter "Include" und "Exclude ", um die zu löschenden Dateien anzugeben.

Beispiel 3: Löschen ausgeblendeter, schreibgeschützter Dateien

Mit diesem Befehl wird eine Datei gelöscht, die sowohl ausgeblendet als auch schreibgeschützt ist.

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

Er verwendet den Path-Parameter , um die Datei anzugeben. Er verwendet den Parameter Force , um ihn zu löschen. Ohne Force können Sie keine schreibgeschützten oder ausgeblendeten Dateien löschen.

Beispiel 4: Rekursives Löschen von Dateien in Unterordnern

Dieser Befehl löscht alle CSV-Dateien im aktuellen Ordner und alle Unterordner rekursiv.

Da der Recurse-Parameter Remove-Item ein bekanntes Problem aufweist, verwendet Get-ChildItem der Befehl in diesem Beispiel, um die gewünschten Dateien abzurufen, und verwendet dann den Pipelineoperator, um sie an .Remove-Item

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

In the Get-ChildItem command, Path has a value of (*), which represents the contents of the current folder. Es verwendet Include , um den CSV-Dateityp anzugeben, und es verwendet Recurse , um den Abruf rekursiv zu machen. Wenn Sie versuchen, den Dateityp im Pfad anzugeben, z -Path *.csv. B. interpretiert das Cmdlet den Betreff der Suche als Datei ohne untergeordnete Elemente, und Recurse schlägt fehl.

Beispiel 5: Rekursives Löschen von Unterschlüsseln

Mit diesem Befehl wird der Registrierungsschlüssel "OldApp" und alle zugehörigen Unterschlüssel und Werte gelöscht. Es wird Remove-Item verwendet, um den Schlüssel zu entfernen. Der Pfad wird angegeben, aber der optionale Parametername (Path) wird weggelassen.

Der Recurse-Parameter löscht alle Inhalte des Schlüssels "OldApp" rekursiv. Wenn der Schlüssel Unterschlüssel enthält und Sie den Parameter Recurse weglassen, werden Sie aufgefordert, zu bestätigen, dass Sie den Inhalt des Schlüssels löschen möchten.

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

Beispiel 6: Löschen von Dateien mit Sonderzeichen

Das folgende Beispiel zeigt, wie Dateien gelöscht werden, die Sonderzeichen wie Klammern oder Klammern enthalten.

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

Beispiel 7: Entfernen eines alternativen Datenstroms

In diesem Beispiel wird gezeigt, wie Sie den dynamischen Stream-Parameter des Remove-Item Cmdlets verwenden, um einen alternativen Datenstrom zu löschen. Der Streamparameter wird in Windows PowerShell 3.0 eingeführt.

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
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : ObjectNotFound: (C:\Test\Copy-Script.ps1:String) [Get-Item], FileNotFoundException
    + FullyQualifiedErrorId : AlternateDataStreamNotFound,Microsoft.PowerShell.Commands.GetItemCommand

Der Stream-Parameter Get-Item ruft den Zone.Identifier Datenstrom der Copy-Script.ps1 Datei ab. Remove-Item verwendet den Stream-Parameter , um den Zone.Identifier Datenstrom der Datei zu entfernen. Schließlich zeigt das Get-Item Cmdlet an, dass der Zone.Identifier Datenstrom gelöscht wurde.

Parameter

-Confirm

-Credential

-DeleteKey

-Exclude

-Filter

-Force

-Include

-LiteralPath

-Path

-Recurse

-Stream

-UseTransaction

-WhatIf

Eingaben

String

Sie können eine Zeichenfolge, die einen Pfad, aber keinen Literalpfad enthält, an dieses Cmdlet weiterleiten.

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück.

Hinweise

Windows PowerShell enthält die folgenden Aliase für Remove-Item:

• del
• erase
• rd
• ri
• rm
• rmdir

Das Remove-Item Cmdlet wurde entwickelt, um mit den Daten zu arbeiten, die von einem beliebigen Anbieter verfügbar gemacht werden. Geben Sie ein, um die in Ihrer Sitzung verfügbaren Anbieter auflisten zu können Get-PsProvider. Weitere Informationen finden Sie unter about_Providers.

Wenn Sie versuchen, einen Ordner zu löschen, der Elemente enthält, ohne den Recurse-Parameter zu verwenden, fordert das Cmdlet zur Bestätigung auf. Die Verwendung -Confirm:$false unterdrückt die Eingabeaufforderung nicht. Es handelt sich hierbei um ein beabsichtigtes Verhalten.

Ähnliche Themen

• 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