Löscht die angegebenen Elemente. (Remove-Item)
NAME
Remove-Item
# ÜBERSICHT
Löscht die angegebenen Elemente.
# SYNTAX
Remove-Item [-LiteralPath] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-Recurse] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]
Remove-Item [-Path] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-Recurse] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]
# BESCHREIBUNG
Das Cmdlet "Remove-Item" löscht eines oder mehrere Elemente. Da es von vielen Anbietern unterstützt wird, können damit viele verschiedene Elementtypen gelöscht werden, einschließlich Dateien, Verzeichnissen, Registrierungsschlüsseln, Variablen, Aliasen und Funktionen.
# PARAMETER
-Credential <PSCredential>
Gibt ein Benutzerkonto an, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Der Standardwert ist der aktuelle Benutzer.
Geben Sie einen Benutzernamen ein, z. B. "User01" oder "Domain01\User01", oder geben Sie ein PSCredential-Objekt ein, z. B. ein vom Cmdlet "Get-Credential" generiertes Objekt. Wenn Sie einen Benutzernamen eingeben, werden Sie zur Eingabe eines Kennworts aufgefordert.
Dieser Parameter wird nicht von mit Windows PowerShell installierten Anbietern unterstützt.
Erforderlich? false
Position? named
Standardwert
Pipelineeingaben akzeptieren?true (ByPropertyName)
Platzhalterzeichen akzeptieren?false
-Exclude <string[]>
Lässt die angegebenen Elemente aus. Der Path-Parameter wird durch den Wert dieses Parameters qualifiziert. Geben Sie ein Pfadelement oder -muster wie "*.txt" ein. Platzhalter sind zulässig.
Erforderlich? false
Position? named
Standardwert
Pipelineeingaben akzeptieren?false
Platzhalterzeichen akzeptieren?false
-Filter <string>
Gibt einen Filter im Format oder in der Sprache des Anbieters an. Der Path-Parameter wird durch den Wert dieses Parameters qualifiziert. Die Syntax des Filters einschließlich der Verwendung von Platzhaltern ist vom Anbieter abhängig. Filter sind effizienter als andere Parameter, da sie beim Abrufen der Objekte vom Anbieter angewendet werden und die Objekte nicht erst nach dem Abrufen von Windows PowerShell gefiltert werden.
Erforderlich? false
Position? named
Standardwert
Pipelineeingaben akzeptieren?false
Platzhalterzeichen akzeptieren?false
-Force [<SwitchParameter>]
Ermöglicht dem Cmdlet das Entfernen von Elementen, die andernfalls nicht geändert werden können, z. B. versteckte oder schreibgeschützte Dateien bzw. 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". Auch bei Verwendung des Force-Parameters kann das Cmdlet keine Sicherheitseinschränkungen außer Kraft setzen.
Erforderlich? false
Position? named
Standardwert
Pipelineeingaben akzeptieren?false
Platzhalterzeichen akzeptieren?false
-Include <string[]>
Löscht nur die angegebenen Elemente. Der Path-Parameter wird durch den Wert dieses Parameters qualifiziert. Geben Sie ein Pfadelement oder -muster wie "*.txt" ein. Platzhalter sind zulässig.
Erforderlich? false
Position? named
Standardwert
Pipelineeingaben akzeptieren?false
Platzhalterzeichen akzeptieren?false
-LiteralPath <string[]>
Gibt einen Pfad zu den zu entfernenden Elementen an. Im Gegensatz zu "Path" wird der Wert von "LiteralPath" genau so verwendet, wie er eingegeben wurde. Es werden keine Zeichen als Platzhalter interpretiert. Wenn der Pfad Escapezeichen enthält, müssen Sie ihn in einfache Anführungszeichen einschließen. Einfache Anführungszeichen veranlassen Windows PowerShell, Zeichen nicht als Escapesequenzen zu interpretieren.
Erforderlich? true
Position? 1
Standardwert
Pipelineeingaben akzeptieren?true (ByPropertyName)
Platzhalterzeichen akzeptieren?false
-Path <string[]>
Gibt einen Pfad zu den zu entfernenden Elementen an. Platzhalter sind zulässig. Der Parametername ("-Path") ist optional.
Erforderlich? true
Position? 1
Standardwert
Pipelineeingaben akzeptieren?true (ByValue, ByPropertyName)
Platzhalterzeichen akzeptieren?false
-Recurse [<SwitchParameter>]
Löscht die Elemente an den angegebenen Speicherorten und allen untergeordneten Elementen der Speicherorte.
Der Recurse-Parameter wird in diesem Cmdlet nicht ordnungsgemäß verarbeitet.
Erforderlich? false
Position? named
Standardwert
Pipelineeingaben akzeptieren?false
Platzhalterzeichen akzeptieren?false
-Confirm [<SwitchParameter>]
Fordert Sie vor der Ausführung des Befehls zur Bestätigung auf.
Erforderlich? false
Position? named
Standardwert
Pipelineeingaben akzeptieren?false
Platzhalterzeichen akzeptieren?false
-WhatIf [<SwitchParameter>]
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.
Erforderlich? false
Position? named
Standardwert
Pipelineeingaben akzeptieren?false
Platzhalterzeichen akzeptieren?false
-UseTransaction [<SwitchParameter>]
Schließt den Befehl in die aktive Transaktion ein. Dieser Parameter ist nur gültig, wenn eine Transaktion ausgeführt wird. Weitere Informationen finden Sie unter "about_Transactions".
Erforderlich? false
Position? named
Standardwert
Pipelineeingaben akzeptieren?false
Platzhalterzeichen akzeptieren?false
<CommonParameters>
Dieses Cmdlet unterstützt folgende allgemeine Parameter: "Verbose", "Debug",
"ErrorAction", "ErrorVariable", "WarningAction", "WarningVariable",
"OutBuffer" und "OutVariable". Weitere Informationen
erhalten Sie mit dem Befehl "get-help about_commonparameters".
# EINGABEN
System.String
Sie können eine Zeichenfolge, die einen Pfad (jedoch keinen literalen Pfad) enthält, über die Pipeline an Remove-Item übergeben.
# AUSGABEN
Keiner
Dieses Cmdlet gibt keine Ausgabe zurück.
# HINWEISE
Auf Remove-Item kann auch über einen der integrierten Aliase "del", "erase", "rmdir", "rd", "ri" oder "rm" verwiesen werden. Weitere Informationen finden Sie unter "about_Aliases".
Das Cmdlet "Remove-Item" ist für die Verwendung mit Daten konzipiert, die von beliebigen Anbietern verfügbar gemacht werden. Um die in der Sitzung verfügbaren Anbieter aufzuführen, geben Sie "Get-PsProvider" ein. Weitere Informationen finden Sie unter "about_Providers".
# BEISPIEL 1
C:\PS>remove-item C:\Test\*.*
Beschreibung
-----------
Mit diesem Befehl werden alle Dateien aus dem Verzeichnis "C:\Test" gelöscht, deren Name einen Punkt (.) enthält. Da im Befehl ein Punkt angegeben wird, werden keine Verzeichnisse und keine Dateien ohne Dateinamenerweiterung gelöscht.
# BEISPIEL 2
C:\PS>remove-item * -include *.doc -exclude *1*
Beschreibung
-----------
Mit diesem Befehl werden alle Dateien mit der Dateinamenerweiterung ".doc", deren Name keine "1" enthält, aus dem aktuellen Verzeichnis gelöscht. Mit dem Platzhalterzeichen (*) wird der Inhalt des aktuellen Verzeichnisses angegeben. Mit dem Include-Parameter und dem Exclude-Parameter werden die zu löschenden Dateien angegeben.
# BEISPIEL 3
C:\PS>remove-item -path C:\Test\hidden-RO-file.txt -force
Beschreibung
-----------
Mit diesem Befehl wird eine Datei gelöscht, die sowohl versteckt als auch schreibgeschützt ist. Mit dem Path-Parameter wird die Datei angegeben. Mit dem Force-Parameter wird die Berechtigung zum Löschen der Datei gewährt. Wenn "Force" nicht angegeben wird, können keine schreibgeschützten und keine versteckten Dateien gelöscht werden.
# BEISPIEL 4
C:\PS>get-childitem * -include *.csv -recurse | remove-item
Beschreibung
-----------
Mit diesem Befehl werden alle CSV-Dateien im aktuellen Verzeichnis und rekursiv in allen Unterverzeichnissen gelöscht.
Da der Recurse-Parameter in diesem Cmdlet fehlerhaft ist, ruft der Befehl die gewünschten Dateien mit dem Cmdlet "Get-Childitem" ab und verwendet den Pipelineoperator, um sie an das Cmdlet "Remove-Item" zu übergeben.
Im Befehl "Get-ChildItem" weist der Path-Parameter den Wert "*" auf, der den Inhalt des aktuellen Verzeichnisses darstellt. Mit dem Include-Parameter wird der Dateityp CSV angegeben, und mit dem Recurse-Parameter wird ein rekursiver Abrufvorgang festgelegt.
Wenn Sie im Pfad den Dateityp angeben, beispielsweise mit "-path *.csv", interpretiert das Cmdlet das Objekt der Suche als Datei ohne untergeordnete Elemente, sodass keine Rekursion möglich ist.
# BEISPIEL 5
C:\PS>remove-item hklm:\software\mycompany\OldApp -recurse
Beschreibung
-----------
Mit diesem Befehl werden der Registrierungsschlüssel "OldApp" und alle seine Unterschlüssel und Werte gelöscht. Mit dem Cmdlet "Remove-Item" wird der Schlüssel entfernt. Der Pfad ist angegeben, der optionale Parametername ("Path") wurde jedoch ausgelassen.
Mit dem Recurse-Parameter wird rekursiv der gesamte Inhalt des Schlüssels "OldApp" gelöscht. Wenn der Schlüssel Unterschlüssel enthält und Sie den Recurse-Parameter auslassen, werden Sie aufgefordert, das Löschen des Schlüsselinhalts zu bestätigen.
VERWANDTE LINKS
Online version: http://go.microsoft.com/fwlink/?LinkID=113373 (möglicherweise auf Englisch)
about_Providers
Clear-Item
Copy-Item
Get-Item
Invoke-Item
Move-Item
New-Item
Remove-ItemProperty
Rename-Item
Set-Item
C:\Windows>powershell get-help Move-Item -full
ColorConsole [Version 1.7.1000] PowerShell 2.0-Export
Microsoft Windows [Version 6.1.7600]
Copyright (c) 2014 Microsoft Corporation.
