Remove-Item

Modul:

Microsoft.PowerShell.Management Module

Löscht die angegebenen Elemente.

Syntax

Path (Default) - FileSystem provider

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

LiteralPath - FileSystem provider

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

Path (Default) - Certificate provider

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

LiteralPath - Certificate provider

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

Path (Default) - All providers

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

LiteralPath - All providers

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

Beschreibung

Das Cmdlet Remove-Item 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 Ordner C:\Test 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 *1*enthält.

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

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

Beispiel 3: Versteckte, schreibgeschützte Dateien löschen

Dieser Befehl löscht eine Datei, die sowohl versteckt als auch schreibgeschützt ist.

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

Er verwendet den parameter Path, um die Datei anzugeben. Er verwendet den Force Parameter, um ihn zu löschen. Ohne Force können Sie keine schreibgeschützten oder versteckten 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 in Remove-Item ein bekanntes Problem aufweist, verwendet der Befehl in diesem Beispiel Get-ChildItem, um die gewünschten Dateien abzurufen, und verwendet dann den Pipelineoperator, um sie an Remove-Itemzu übergeben.

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

Im Befehl Get-ChildItem weist Path einen Wert von (*) auf, der den Inhalt des aktuellen Ordners darstellt. 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. B. -Path *.csv, interpretiert das Cmdlet den Betreff der Suche so, dass es sich um eine Datei ohne untergeordnete Elemente handelt, und Recurse fehlschlägt.

Hinweis

Dieses Verhalten wurde in Windows-Versionen 1909 und höher behoben.

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 verwendet Remove-Item, 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 OldApp-Schlüssels 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 eckige Klammern oder runde 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 Stream dynamischen Parameter des Cmdlets Remove-Item 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'.

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

Parameter

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen. Weitere Informationen finden Sie in den folgenden Artikeln:

• about_Preference_Variables
• about_Functions_CmdletBindingAttribute (Informationen zu Funktionen und dem CmdletBinding-Attribut)

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	False
Unterstützt Platzhalter:	False
Nicht anzeigen:	False
Aliase:	vgl

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Credential

Hinweis

Dieser Parameter wird von anbietern, die mit PowerShell installiert sind, nicht unterstützt. Verwenden Sie Invoke-Command-, um die Identität eines anderen Benutzers zu imitieren oder Ihre Anmeldeinformationen beim Ausführen dieses Cmdlets zu erhöhen.

Parametereigenschaften

Typ:	PSCredential
Standardwert:	Current user
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-DeleteKey

Dies ist ein dynamischer Parameter, der vom anbieter Certificate zur Verfügung gestellt wird. Der Anbieter des Zertifikats und dieser Parameter sind nur unter Windows verfügbar.

Wenn angegeben, löscht das Cmdlet den privaten Schlüssel, wenn das Zertifikat gelöscht wird.

Weitere Informationen findest du unter about_Certificate_Provider.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	False
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Exclude

Gibt als Array von Zeichenfolgen ein Element oder Elemente an, die dieses Cmdlet im Vorgang ausschließt. Der Wert dieses Parameters qualifiziert den parameter Path. Geben Sie ein Pfadelement oder Muster ein, z. B. *.txt. Platzhalterzeichen sind zulässig. Der Exclude Parameter ist nur wirksam, wenn der Befehl den Inhalt eines Elements enthält, z. B. C:\Windows\*, wobei das Wildcardzeichen den Inhalt des C:\Windows Verzeichnisses angibt.

Wenn Sie Recurse mit Exclude verwenden, filtert Exclude nur die Ergebnisse des aktuellen Verzeichnisses. Wenn es in Unterordnern Dateien gibt, die dem Muster Ausschließen entsprechen, werden diese Dateien zusammen mit dem übergeordneten Verzeichnis entfernt.

Parametereigenschaften

Typ:	String[]
Standardwert:	None
Unterstützt Platzhalter:	True
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Filter

Gibt einen Filter an, der den parameter Path qualifizieren soll. Der FileSystem--Anbieter ist der einzige installierte PowerShell-Anbieter, der die Verwendung von Filtern unterstützt. Sie finden die Syntax für die FileSystem Filtersprache in über_Wildcards. Filter sind effizienter als andere Parameter, da der Anbieter sie anwendet, wenn das Cmdlet die Objekte abruft, anstatt dass PowerShell die Objekte nach dem Abrufen filtert.

Parametereigenschaften

Typ:	String
Standardwert:	None
Unterstützt Platzhalter:	True
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Force

Erzwingt das Cmdlet, Elemente zu entfernen, die andernfalls nicht geändert werden können, z. B. ausgeblendete oder schreibgeschützte Dateien oder schreibgeschützte Aliase oder Variablen. Das Cmdlet kann keine konstanten Aliasse oder Variablen entfernen. Die Implementierung variiert von Anbieter zu Anbieter. Weitere Informationen finden Sie unter über_Anbieter. Selbst bei Verwendung des parameters Force kann das Cmdlet keine Sicherheitseinschränkungen außer Kraft setzen.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	False
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Include

Gibt als Zeichenfolgenarray ein oder mehrere Elemente an, die dieses Cmdlet in den Vorgang einbezieht. Der Wert dieses Parameters qualifiziert den parameter Path. Geben Sie ein Pfadelement oder Muster ein, z. B. "*.txt". Platzhalterzeichen sind zulässig. Der Include Parameter ist nur wirksam, wenn der Befehl den Inhalt eines Elements einbezieht, wie zum Beispiel C:\Windows\*, wobei das Wildcard-Zeichen den Inhalt des C:\Windows-Verzeichnisses angibt.

Parametereigenschaften

Typ:	String[]
Standardwert:	None
Unterstützt Platzhalter:	True
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-LiteralPath

Gibt einen Pfad zu einem oder mehreren Speicherorten an. Der Wert LiteralPath- wird genau so verwendet, wie er eingegeben wird. Es werden keine Zeichen als Wildcards interpretiert. Wenn der Pfad Escapezeichen enthält, müssen Sie ihn in einfache Anführungszeichen einschließen. Einfache Anführungszeichen signalisieren PowerShell, dass keine Zeichen als Escapesequenzen interpretiert werden sollen.

Weitere Informationen finden Sie unter über_Zitierregeln.

Parametereigenschaften

Typ:	String[]
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False
Aliase:	PSPath, EP

Parametersätze

LiteralPath

Position:	Named
Obligatorisch.:	True
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-Path

Gibt einen Pfad der zu entfernenden Elemente an. Platzhalterzeichen sind zulässig.

Parametereigenschaften

Typ:	String[]
Standardwert:	None
Unterstützt Platzhalter:	True
Nicht anzeigen:	False

Parametersätze

Path

Position:	0
Obligatorisch.:	True
Wert aus Pipeline:	True
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-Recurse

Gibt an, dass dieses Cmdlet die Objekte in den angegebenen Speicherorten und in allen untergeordneten Objekten der Speicherorte löscht.

Der Parameter Recurse löscht möglicherweise nicht alle Unterordner oder alle untergeordneten Elemente. Dies ist ein bekanntes Problem.

Hinweis

Dieses Verhalten wurde in Windows-Versionen 1909 und höher behoben.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Stream

Dies ist ein dynamischer Parameter, der vom FileSystem Provider zur Verfügung gestellt wird. Dieser Parameter ist nur unter Windows verfügbar. Dieser Parameter kann nicht in Kombination mit dem parameter Recurse verwendet werden.

Sie können Remove-Item verwenden, um einen alternativen Datenstrom zu löschen, z. B. Zone.Identifier. Es ist jedoch nicht die empfohlene Möglichkeit, Sicherheitsüberprüfungen zu beseitigen, die Dateien blockieren, die aus dem Internet heruntergeladen werden. Wenn Sie überprüfen, ob eine heruntergeladene Datei sicher ist, verwenden Sie das Cmdlet Unblock-File.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt. Ab Windows PowerShell 7.2 können Remove-Item alternative Datenströme aus Verzeichnissen und Dateien entfernen.

Weitere Informationen finden Sie unter about_FileSystem_Provider.

Parametereigenschaften

Typ:	String[]
Standardwert:	None
Unterstützt Platzhalter:	True
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	False
Unterstützt Platzhalter:	False
Nicht anzeigen:	False
Aliase:	Wi

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

String

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

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück.

Hinweise

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

• Alle Plattformen:
  • del
  • erase
  • rd
  • ri
• Fenster:
  • rm
  • rmdir

Das Cmdlet Remove-Item ist für die Arbeit mit den Daten konzipiert, die von einem beliebigen Anbieter verfügbar gemacht werden. Geben Sie Get-PSProviderein, um die in Ihrer Sitzung verfügbaren Anbieter auflisten zu können. Weitere Informationen finden Sie unter über_Anbieter.

Wenn Sie versuchen, einen Ordner zu löschen, der Elemente enthält, ohne den parameter Recurse zu verwenden, fordert das Cmdlet zur Bestätigung auf. Die Verwendung von -Confirm:$false unterdrückt die Eingabeaufforderung nicht. Dies ist beabsichtigt.

Ähnliche Themen

• Element löschen
• Copy-Item
• Get-Item
• Invoke-Item
• Move-Item
• Neues Element
• Remove-ItemProperty
• Element umbenennen
• Set-Item
• Über_Anbieter
• about_Preference_Variables
• about_Functions_CmdletBindingAttribute