Dela via

Clear-Content

Modul:
Microsoft.PowerShell.Management Module

Tar bort innehållet i ett objekt, men tar inte bort objektet.

Syntax

Path (Default) - FileSystem provider 

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

LiteralPath - FileSystem provider 

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

Path (Default) - All providers 

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

LiteralPath - All providers 

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 när texten tas bort 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 katalogen SmpUsers. 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 filnamnstillägget .log, inklusive filer med skrivskyddat attribut. 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 ange *.log 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 i den Zone.Identifier 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.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Credential

Anmärkning

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.

Parameteregenskaper

Typ:PSCredential
Standardvärde:Current user
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument: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.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:True
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:True
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Force

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:True
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-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 wildcards. 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.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:PSPath, SP

Parameteruppsättningar

LiteralPath
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument: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 (Path) är valfritt.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:True
DontShow:False

Parameteruppsättningar

Path
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-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 valfri 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 kan Clear-Content rensa innehållet i alternativa dataströmmar från kataloger och filer.

Mer information finns i about_FileSystem_Provider.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-WhatIf

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

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 om_Leverantörer.