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

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

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

Remove-Item C:\Test\*.*

In diesem Beispiel werden alle Dateien aus dem aktuellen Ordner gelöscht, die eine .doc Dateinamenerweiterung und einen Namen aufweisen, *1*der nicht 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.

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 parameter Path, um die Datei anzugeben. Er verwendet den Force Parameter, um ihn zu löschen. Ohne Force können Sie schreibgeschützte oder versteckte Dateien nicht löschen.

Mit diesem Befehl werden alle CSV-Dateien im aktuellen Ordner und alle Unterordner rekursiv gelöscht.

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 Pfad des Dateityps anzugeben, z. B -Path *.csv. , interpretiert das Cmdlet den Betreff der Suche als eine Datei, die keine untergeordneten Elemente enthält, und die Rekursion schlägt fehl.

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

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

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.

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.

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

Dieses Cmdlet gibt keine Ausgabe zurück.

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. Mit -Confirm:$false unterdrückt die Eingabeaufforderung nicht. Dies ist beabsichtigt.