Löscht den Inhalt eines Elements, beispielsweise den Text in einer Datei, ohne das Element selbst zu löschen. (Clear-Content)
NAMEClear-ContentÜBERSICHTLöscht den Inhalt eines Elements, beispielsweise den Text in einer Datei, ohne das Element selbst zu löschen.SYNTAXClear-Content [-LiteralPath] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>] Clear-Content [-Path] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]BESCHREIBUNGMit dem Cmdlet "Clear-Content" wird der Inhalt eines Elements gelöscht, beispielsweise der Text in einer Datei, ohne das Element selbst zu löschen. Folglich ist das Element vorhanden, aber leer. Clear-Content ist vergleichbar mit Clear-Item, wird jedoch für Dateien statt für Aliase und Variablen verwendet.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 es dem Cmdlet, den Dateiinhalt selbst dann zu löschen, wenn die Datei schreibgeschützt ist. 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 die Pfade zu den Elementen an, aus denen der Inhalt gelöscht wird. 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 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 einer oder mehreren 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. Erforderlich? true Position? 1 Standardwert Pipelineeingaben akzeptieren?true (ByPropertyName) 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".EINGABENKeiner Objekte können nicht über die Pipeline an Clear-Content übergeben werden.AUSGABENKeiner Dieses Cmdlet gibt keine Objekte zurück.HINWEISESie können auch über den integrierten Alias "clc" auf Clear-Content verweisen. Weitere Informationen finden Sie unter "about_Aliases". Wenn Sie den Parameternamen "-Path" auslassen, muss der Wert von "Path" der erste Parameter im Befehl sein. Beispiel: "clear-content c:\mydir\*.txt". Wenn Sie den Parameternamen angeben, können die Parameter in beliebiger Reihenfolge aufgelistet werden. Sie können Clear-Content mit dem Windows PowerShell-Dateisystemanbieter und mit anderen Anbietern zum Bearbeiten von Inhalt verwenden. Elemente, die nicht als Inhalt angesehen werden, beispielsweise Elemente, die vom Windows PowerShell-Certificate-Anbieter oder -Registry-Anbieter verwaltet werden, können Sie mit Clear-Item löschen. Das Cmdlet "Clear-Content" 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".Beispiele
BEISPIEL 1C:\PS>clear-content ..\SmpUsers\*\init.txt Beschreibung ----------- Mit diesem Befehl wird der gesamte Inhalt aus den Dateien mit dem Namen "init.txt" in allen Unterverzeichnissen des Verzeichnisses "SmpUsers" gelöscht. Die Dateien werden nicht gelöscht, sie sind anschließend jedoch leer.BEISPIEL 2C:\PS>clear-content -path * -filter *.log -force Beschreibung ----------- Mit diesem Befehl wird der Inhalt aller Dateien mit der Dateinamenerweiterung ".log" im aktuellen Verzeichnis gelöscht, einschließlich der Dateien mit Schreibschutzattribut. Das Sternchen (*) im Pfad stellt alle Elemente im aktuellen Verzeichnis dar. Aufgrund des Force-Parameters wird der Befehl auch auf schreibgeschützte Dateien angewendet. Wenn Sie den Befehl mit einem Filter auf Dateien mit der Dateinamenerweiterung ".log" beschränken, anstatt "*.log" im Pfad anzugeben, wird der Vorgang beschleunigt.BEISPIEL 3C:\PS>clear-content c:\Temp\* -Include Smp* -Exclude *2* -whatif Beschreibung ----------- Mit diesem Befehl werden die Auswirkungen einer Ausführung des folgenden Befehls angefordert: "clear-content c:\temp\* -include smp* -exclude *2*". Im Ergebnis werden die Dateien aufgelistet, die gelöscht werden, in diesem Fall Dateien im Verzeichnis "Temp", deren Name mit "Smp" beginnt und keine "2" enthält. Führen Sie den Befehl aus, indem Sie ihn erneut ohne den Whatif-Parameter ausführen. VERWANDTE LINKS Online version: http://go.microsoft.com/fwlink/?LinkID=113282 (möglicherweise auf Englisch) about_Providers Get-Content Set-Content Add-Content Get-Item C:\Windows>powershell get-help Clear-ItemProperty -full
Microsoft Windows [Version 10.0.19045.3693]
Copyright (c) 2023 Microsoft Corporation.
ColorConsole [Version 3.7.1000] PowerShell 2.0-Export
