Clear-Content

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

Clear-Content
    [-Path] <String[]>
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Force]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Clear-Content
    -LiteralPath <String[]>
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Force]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

De Clear-Content cmdlet verwijdert de inhoud van een item, zoals het verwijderen van de tekst uit een bestand, maar het item wordt niet verwijderd. Als gevolg hiervan bestaat het item, maar het is leeg. Clear-Content lijkt op Clear-Item, maar het werkt op items met inhoud, in plaats van items met waarden.

Clear-Content "..\SmpUsers\*\init.txt"

Met deze opdracht verwijdert u alle inhoud uit de init.txt bestanden in alle submappen van de SmpUsers map. De bestanden worden niet verwijderd, maar zijn leeg.

Clear-Content -Path "*" -Filter "*.log" -Force

Met deze opdracht wordt de inhoud van alle bestanden in de huidige map verwijderd met de bestandsextensie .log, inclusief bestanden met het kenmerk Alleen-lezen. Het sterretje (*) in het pad vertegenwoordigt alle items in de huidige map. De parameter Forceren maakt de opdracht effectief voor alleen-lezenbestanden. Als u een filter gebruikt om de opdracht te beperken tot bestanden met de .log bestandsnaamextensie in plaats van *.log op te geven in het pad, wordt de bewerking sneller.

In dit voorbeeld ziet u hoe de Clear-Content cmdlet de inhoud van een alternatieve gegevensstroom wist terwijl de stroom intact blijft.

De eerste opdracht maakt gebruik van de Get-Content cmdlet om de inhoud van de Zone.Identifier stream op te halen in het Copy-Script.ps1-bestand, dat is gedownload van internet.

De tweede opdracht maakt gebruik van de Clear-Content cmdlet om de inhoud te wissen.

De derde opdracht herhaalt de eerste opdracht. Er wordt gecontroleerd of de inhoud is gewist, maar de stream blijft behouden. Als de stream is verwijderd, genereert de opdracht een fout.

U kunt een methode zoals deze gebruiken om de inhoud van een alternatieve gegevensstroom te wissen. Het is echter niet de aanbevolen manier om beveiligingscontroles te elimineren die bestanden blokkeren die van internet worden gedownload. Als u controleert of een gedownload bestand veilig is, gebruikt u de cmdlet Unblock-File.

Get-Content C:\Test\Copy-Script.ps1 -Stream Zone.Identifier

[ZoneTransfer]
ZoneId=3

Clear-Content C:\Test\Copy-Script.ps1 -Stream Zone.Identifier
Get-Content C:\Test\Copy-Script.ps1 -Stream Zone.Identifier

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

U kunt geen objecten doorsluisen naar deze cmdlet.

Deze cmdlet retourneert geen uitvoer.

PowerShell bevat de volgende aliassen voor Clear-Content:

• Alle platforms:
  • clc

U kunt Clear-Content gebruiken met de PowerShell FileSystem-provider en met andere providers die inhoud bewerken. Als u items wilt wissen die niet als inhoud worden beschouwd, zoals items die worden beheerd door het PowerShell-certificaat of registerproviders, gebruikt u Clear-Item.

De cmdlet Clear-Content is ontworpen om te werken met de gegevens die door elke provider worden weergegeven. Als u de providers wilt weergeven die beschikbaar zijn in uw sessie, typt u Get-PSProvider. Zie about_Providersvoor meer informatie.