Clear-Content

  • Referens
Modul:
Microsoft.PowerShell.Management

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åll för 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 .log filnamnstillägget, 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 blir å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 strömmen i Copy-Script.ps1 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. Det verifierar att innehållet rensas, men strömmen finns kvar. Om strö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.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Credential

Kommentar

Den här parametern stöds inte av några leverantörer 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.

Typ:PSCredential
Position:Named
Standardvärde:Current user
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:True

-Force

Tvingar kommandot att köras utan att be om användarbekräftelse.

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Include

Anger, som en strängmatris, innehåll som den här cmdleten 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.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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 precis 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.

Typ:String[]
Alias:PSPath, LP
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:String[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken: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 du rensa innehållet i alternativa dataströmmar från kataloger och filer.

Mer information finns i about_FileSystem_Provider.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

None

Du kan inte skicka objekt till den här cmdleten.

Utdata

None

Den här cmdleten 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 tillgängliga leverantörer i sessionen skriver du Get-PsProvider. Mer information finns i about_Providers.