Clear-Content
Löscht den Inhalt eines Elements, jedoch nicht das Element selbst.
Syntax
Clear-Content
[-Path] <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-Stream <String>]
[<CommonParameters>]
Clear-Content
-LiteralPath <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-Stream <String>]
[<CommonParameters>]
Beschreibung
Das Clear-Content
Cmdlet löscht den Inhalt eines Elements, z. B. das Löschen des Texts aus einer Datei, löscht jedoch nicht das Element.
Folglich ist das Element vorhanden, aber leer.
Dies Clear-Content
ist ähnlich wie Clear-Item
, aber es funktioniert für Elemente mit Inhalten anstelle von Elementen mit Werten.
Beispiele
Beispiel 1: Löschen aller Inhalte aus einem Verzeichnis
Clear-Content "..\SmpUsers\*\init.txt"
Mit diesem Befehl wird der gesamte Inhalt aus den Dateien mit dem Namen %%amp;quot;init.txt%%amp;quot; in allen Unterverzeichnissen des Verzeichnisses %%amp;quot;SmpUsers%%amp;quot; gelöscht. Die Dateien werden nicht gelöscht, sie sind anschließend jedoch leer.
Beispiel 2: Löschen von Inhalten aller Dateien mit einem Wildcard
Clear-Content -Path "*" -Filter "*.log" -Force
Mit diesem Befehl wird der Inhalt aller Dateien mit der Dateinamenerweiterung %%amp;quot;.log%%amp;quot; im aktuellen Verzeichnis gelöscht, einschließlich der Dateien mit Schreibschutzattribut. Das Sternchen (*) im Pfad stellt alle Elemente im aktuellen Verzeichnis dar. Der Parameter Force macht den Befehl für schreibgeschützte Dateien wirksam. Wenn Sie einen Filter verwenden, um den Befehl auf Dateien mit der Dateinamenerweiterung ".log" einzuschränken, anstatt *.log im Pfad anzugeben, wird der Vorgang schneller.
Beispiel 3: Löschen aller Daten aus einem Datenstrom
In diesem Beispiel wird gezeigt, wie das Clear-Content
Cmdlet den Inhalt aus einem alternativen Datenstrom löscht, während der Datenstrom intakt bleibt.
Der erste Befehl verwendet das Get-Content
Cmdlet, um den Inhalt des Zone.Identifier-Datenstroms in der datei Copy-Script.ps1 abzurufen, die aus dem Internet heruntergeladen wurde.
Der zweite Befehl verwendet das Clear-Content
Cmdlet, um den Inhalt zu löschen.
Mit dem dritten Befehl wird der erste Befehl wiederholt. Es überprüft, ob der Inhalt gelöscht wird, der Datenstrom bleibt jedoch erhalten. Wenn der Datenstrom gelöscht wurde, würde der Befehl einen Fehler generieren.
Sie können eine Methode wie diese verwenden, um den Inhalt eines alternativen Datenstroms zu 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.
PS C:\> Get-Content C:\Test\Copy-Script.ps1 -Stream Zone.Identifier
[ZoneTransfer]
ZoneId=3
PS C:\>Clear-Content C:\Test\Copy-Script.ps1 -Stream Zone.Identifier
PS C:\>Get-Content C:\Test\Copy-Script.ps1 -Stream Zone.Identifier
PS C:\>
Parameter
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
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 Zeichenfolgen an, die dieses Cmdlet vom Pfad zum Inhalt weggelassen wird. Der Wert dieses Parameters qualifiziert den Path-Parameter. Geben Sie ein Pfadelement oder ein Muster wie %%amp;quot;*.txt%%amp;quot; ein. Platzhalter sind zulässig.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Filter
Gibt einen Filter im Format oder in der Sprache des Anbieters an. Der Wert dieses Parameters qualifiziert den Path-Parameter. Die Syntax des Filters einschließlich der Verwendung von Platzhaltern ist vom Anbieter abhängig. Filter sind effizienter als andere Parameter, da der Anbieter sie beim Abrufen der Objekte anwendet, 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 die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Include
Gibt als Zeichenfolgenarray Inhalt an, den dieses Cmdlet löscht. Der Wert dieses Parameters qualifiziert den Path-Parameter. Geben Sie ein Pfadelement oder ein Muster wie %%amp;quot;*.txt%%amp;quot; ein. Platzhalter sind zulässig.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-LiteralPath
Gibt die Pfade zu den Elementen an, aus denen der Inhalt gelöscht wird. Im Gegensatz zum Path-Parameter wird der Wert des LiteralPath-Parameters 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. Einzelne Anführungszeichen weisen darauf hin, dass PowerShell keine Zeichen als Escapesequenzen interpretiert.
Type: | String[] |
Aliases: | PSPath, LP |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Path
Gibt die Pfade zu den Elementen an, aus denen der Inhalt gelöscht wird. Platzhalter sind zulässig. Die Pfade müssen auf Elemente und nicht auf Container zeigen. Sie müssen beispielsweise einen Pfad zu Dateien angeben, ein Pfad zu einem Verzeichnis ist nicht zulässig. Platzhalter sind zulässig. Dieser Parameter ist erforderlich, der Parametername (Path) ist jedoch optional.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Stream
Gibt einen alternativen Datenstrom für Inhalte an. Wenn der Datenstrom nicht vorhanden ist, erstellt dieses Cmdlet ihn. Platzhalterzeichen werden nicht unterstützt.
Stream ist ein dynamischer Parameter, den der FileSystem-Anbieter hinzufügt Clear-Content
.
Dieser Parameter funktioniert nur in Dateisystemlaufwerken.
Sie können das Clear-Content
Cmdlet verwenden, um den Inhalt des alternativen Datenstroms Zone.Identifier zu ändern.
Wir empfehlen dies jedoch nicht als 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 Unblock-File
Cmdlet.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-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
None
Sie können keine Objekte an Clear-Content
.
Ausgaben
None
Dieses Cmdlet gibt keine Objekte zurück.
Hinweise
Sie können mit dem PowerShell FileSystem-Anbieter und anderen Anbietern verwenden Clear-Content
, die Inhalte bearbeiten.
Verwenden Sie die Verwendung Clear-Item
, um Elemente zu löschen, die nicht als Inhalte gelten, z. B. Elemente, die vom PowerShell-Zertifikat oder Registrierungsanbieter verwaltet werden.
Das Clear-Content
Cmdlet ist so konzipiert, dass sie mit den daten verwendet wird, die von jedem Anbieter verfügbar gemacht werden.
Zum Auflisten der in Ihrer Sitzung verfügbaren Anbieter geben Sie Get-PsProvider
.
Weitere Informationen finden Sie unter about_Providers.