Remove-Item

  • Referenz
Modul:
Microsoft.PowerShell.Management

Löscht die angegebenen Elemente.

Syntax

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

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, einschließlich Dateien, Ordnern, Registrierungsschlüsseln, Variablen, Aliasen und Funktionen.

Beispiele

Beispiel 1: Löschen von Dateien mit einer Dateinamenerweiterung

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

Remove-Item C:\Test\*.*

Beispiel 2: Löschen einiger Dokumentdateien in einem Ordner

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

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

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

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

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

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

Es verwendet den Path-Parameter , um die Datei anzugeben. Er verwendet den Force-Parameter , um ihn zu löschen. Ohne Kraft können Sie schreibgeschützte oder ausgeblendete Dateien nicht löschen.

Beispiel 4: Löschen von Dateien in Unterordnern rekursiv

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

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

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

Get-ChildItem Im Befehl weist Path einen Wert von (*) auf, der den Inhalt des aktuellen Ordners darstellt. Es verwendet "Include ", um den CSV-Dateityp anzugeben, und er verwendet Recurse, um den Abruf rekursiv zu machen. Wenn Sie versuchen, den Dateityp anzugeben, z -Path *.csv. B. interpretiert das Cmdlet den Betreff der Suche, um eine Datei zu sein, die keine untergeordneten Elemente enthält, und Recurse schlägt fehl.

Hinweis

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

Beispiel 5: Rekursives Löschen von Unterschlüsseln

Dieser Befehl löscht den Registrierungsschlüssel "OldApp" und alle seine Unterschlüssel und Werte. Es wird verwendet Remove-Item , um den Schlüssel zu entfernen. Der Pfad wird angegeben, aber der optionale Parametername (Pfad) wird nicht angegeben.

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 auslassen, 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

Im folgenden Beispiel wird gezeigt, 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 Parameter "Stream " 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'.

Der Stream-ParameterGet-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

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert. Weitere Informationen finden Sie in den folgenden Artikeln:

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Hinweis

Dieser Parameter wird von anbietern, die mit PowerShell installiert sind, nicht unterstützt. Um einen anderen Benutzer zu imitieren oder Ihre Anmeldeinformationen beim Ausführen dieses Cmdlets zu erhöhen, verwenden Sie "Invoke-Command".

Type:PSCredential
Position:Named
Default value:Current user
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Exclude

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

Wenn Sie "Recurse" mit "Ausschließen" verwenden, filtern Sie nur Ergebnisse des aktuellen Verzeichnisses. Wenn Dateien mit dem Muster " Ausschließen " in Unterordnern übereinstimmen, werden diese Dateien zusammen mit dem übergeordneten Verzeichnis entfernt.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Filter

Gibt einen Filter an, um den Pfadparameter zu qualifizieren. Der FileSystem-Anbieter ist der einzige installierte PowerShell-Anbieter, der die Verwendung von Filtern unterstützt. Sie können die Syntax für die Dateisystemfiltersprache in about_Wildcards finden. Filter sind effizienter als andere Parameter, da der Anbieter sie anwendet, wenn das Cmdlet die Objekte abruft, anstatt powerShell nach dem Abrufen der Objekte zu filtern.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-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. Mit dem Cmdlet können keine konstanten Aliase oder Variablen entfernt werden. Die Implementierung unterscheidet sich bei den einzelnen Anbietern. Weitere Informationen finden Sie unter about_Providers. Selbst bei Verwendung des Force-Parameters kann das Cmdlet Sicherheitseinschränkungen nicht außer Kraft setzen.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Include

Gibt als Zeichenfolgenarray ein Element oder Elemente an, die dieses Cmdlet im Vorgang enthält. Der Wert dieses Parameters qualifiziert den Path-Parameter. Geben Sie ein Pfadelement oder Muster ein, z. B "*.txt". . Platzhalterzeichen sind zulässig. Der Parameter "Einschließen " ist nur wirksam, wenn der Befehl den Inhalt eines Elements enthält, z C:\Windows\*. B. wo das Wildcardzeichen den Inhalt des C:\Windows Verzeichnisses angibt.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-LiteralPath

Gibt einen Pfad zu einem oder mehreren Speicherorten an. Der Wert von LiteralPath wird genau wie eingegeben verwendet. Es werden keine Zeichen als Platzhalter interpretiert. Wenn der Pfad Escapezeichen enthält, müssen Sie ihn in einfache Anführungszeichen einschließen. Einzelne Anführungszeichen weisen PowerShell darauf hin, keine Zeichen als Escapesequenzen zu interpretieren.

Weitere Informationen finden Sie unter about_Quoting_Rules.

Type:String[]
Aliases:PSPath, LP
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Path

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

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Recurse

Gibt an, dass dieses Cmdlet die Elemente an den angegebenen Speicherorten und in allen untergeordneten Elementen 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 neuer behoben.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Stream

Hinweis

Dieser Parameter ist nur unter Windows verfügbar.

Der Stream-Parameter ist ein dynamischer Parameter, den der FileSystem-Anbieter hinzufügt Remove-Item. Dieser Parameter funktioniert nur in Dateisystemlaufwerken.

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

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

String

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

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück.

Hinweise

Das Remove-Item Cmdlet ist so konzipiert, dass die Von jedem Anbieter verfügbar gemachten Daten verwendet werden. Geben Sie Get-PsProviderzum Auflisten der in Ihrer Sitzung verfügbaren Anbieter ein. 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. Dies ist beabsichtigt.