Clear-Content
Tar bort innehållet i ett objekt, men tar inte bort objektet.
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>]
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>]
Description
Cmdleten Clear-Content
tar bort innehållet i ett objekt, till exempel att ta bort texten från en fil, men objektet tas inte bort. Därför finns objektet, men det är tomt. Clear-Content
liknar Clear-Item
, men fungerar på objekt med innehåll i stället för objekt med värden.
Exempel
Exempel 1: Ta bort allt innehåll från en katalog
Clear-Content "..\SmpUsers\*\init.txt"
Det här kommandot tar bort allt innehåll från init.txt
filerna i alla underkataloger i SmpUsers
katalogen. Filerna tas inte bort, men de är tomma.
Exempel 2: Ta bort innehållet i alla filer med jokertecken
Clear-Content -Path "*" -Filter "*.log" -Force
Det här kommandot tar bort innehållet i alla filer i den aktuella katalogen med filnamnstillägget .log
, inklusive filer med det skrivskyddade attributet. Asterisken (*
) i sökvägen representerar alla objekt i den aktuella katalogen. Parametern Force gör kommandot effektivt för skrivskyddade filer. Om du använder ett filter för att begränsa kommandot till filer med filnamnstillägget .log
i stället för att *.log
ange i sökvägen går åtgärden snabbare.
Exempel 3: Rensa alla data från en dataström
Det här exemplet visar hur cmdleten Clear-Content
rensar innehållet från en alternativ dataström samtidigt som strömmen lämnas intakt.
Det första kommandot använder cmdleten Get-Content
för att hämta innehållet Zone.Identifier
i dataströmmen Copy-Script.ps1
i filen, som laddades ned från Internet.
Det andra kommandot använder cmdleten Clear-Content
för att rensa innehållet.
Det tredje kommandot upprepar det första kommandot. Den verifierar att innehållet rensas, men strömmen finns kvar. Om dataströmmen togs bort skulle kommandot generera ett fel.
Du kan använda en metod som den här för att rensa innehållet i en alternativ dataström. Det är dock inte det rekommenderade sättet att eliminera säkerhetskontroller som blockerar filer som laddas ned från Internet. Om du kontrollerar att en nedladdad fil är säker använder du cmdleten 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
Parametrar
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Anteckning
Den här parametern stöds inte av några providers som är installerade med PowerShell. Om du vill personifiera en annan användare eller höja dina autentiseringsuppgifter när du kör den här cmdleten använder du Invoke-Command
.
Type: | PSCredential |
Position: | Named |
Default value: | Current user |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Exclude
Anger, som en strängmatris, strängar som denna cmdlet utelämnar från sökvägen till innehållet. Värdet för den här parametern kvalificerar parametern Path . Ange ett sökvägselement eller mönster, till exempel *.txt
. Jokertecken tillåts.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Filter
Anger ett filter i providerns format eller språk. Värdet för den här parametern kvalificerar parametern Path . Syntaxen för filtret, inklusive användningen av jokertecken, beror på providern. Filter är effektivare än andra parametrar eftersom providern tillämpar dem när objekten hämtas, i stället för att PowerShell filtrerar objekten när de har hämtats.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Force
Tvingar kommandot att köras utan att be om användarbekräftelse.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Include
Anger, som en strängmatris, innehåll som denna cmdlet rensar. Värdet för den här parametern kvalificerar parametern Path . Ange ett sökvägselement eller mönster, till exempel *.txt
. Jokertecken tillåts.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-LiteralPath
Anger sökvägarna till de objekt som innehållet tas bort från. Till skillnad från parametern Path används värdet för LiteralPath exakt som det skrivs. Inga tecken tolkas som jokertecken.
Om sökvägen innehåller escape-tecken omger du den med enkla citattecken ('
). Enkla citattecken anger att PowerShell inte ska tolka några tecken som escape-sekvenser.
Type: | String[] |
Aliases: | PSPath, LP |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Path
Anger sökvägarna till de objekt som innehållet tas bort från. Jokertecken tillåts. Sökvägarna måste vara sökvägar till objekt, inte till containrar. Du måste till exempel ange en sökväg till en eller flera filer, inte en sökväg till en katalog. Jokertecken tillåts. Den här parametern krävs, men parameternamnet (sökvägen) är valfritt.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Stream
Det här är en dynamisk parameter som görs tillgänglig av FileSystem-providern . Den här parametern är endast tillgänglig i Windows.
Anger en alternativ dataström för innehåll. Om strömmen inte finns skapar den här cmdleten den. Jokertecken stöds inte.
Du kan använda cmdleten Clear-Content
för att ändra innehållet i en alternativ dataström, till exempel Zone.Identifier
. Vi rekommenderar dock inte detta som ett sätt att eliminera säkerhetskontroller som blockerar filer som laddas ned från Internet. Om du kontrollerar att en nedladdad fil är säker använder du cmdleten Unblock-File
.
Den här parametern introducerades i PowerShell 3.0. Från och med PowerShell 7.2 Clear-Content
kan rensa innehållet i alternativa dataströmmar från kataloger och filer.
Mer information finns i about_FileSystem_Provider.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Indata
None
Du kan inte skicka objekt till den här cmdleten.
Utdata
None
Denna cmdlet returnerar inga utdata.
Kommentarer
PowerShell innehåller följande alias för Clear-Content
:
- Alla plattformar:
clc
Du kan använda Clear-Content
med PowerShell FileSystem-providern och med andra leverantörer som manipulerar innehåll. Om du vill rensa objekt som inte anses vara innehåll, till exempel objekt som hanteras av PowerShell-certifikatet eller registerprovidrar, använder du Clear-Item
.
Cmdleten Clear-Content
är utformad för att fungera med data som exponeras av alla leverantörer.
Om du vill visa en lista över de providrar som är tillgängliga i sessionen skriver du Get-PsProvider
.
Mer information finns i about_Providers.