Clear-Content

Odstraní obsah položky, ale neodstraní ji.

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

Description

Rutina Clear-Content odstraní obsah položky, například odstranění textu ze souboru, ale neodstraní položku. V důsledku toho položka existuje, ale je prázdná. Clear-Content je podobný Clear-Item, ale funguje na položkách s obsahem místo položek s hodnotami.

Příklady

Příklad 1: Odstranění veškerého obsahu z adresáře

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

Tento příkaz odstraní veškerý obsah ze init.txt souborů ve všech podadresářích SmpUsers adresáře. Soubory se neodstraní, ale jsou prázdné.

Příklad 2: Odstranění obsahu všech souborů se zástupným znakem

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

Tento příkaz odstraní obsah všech souborů v aktuálním adresáři s příponou .log názvu souboru, včetně souborů s atributem jen pro čtení. Hvězdička (*) v cestě představuje všechny položky v aktuálním adresáři. Parametr Force zúčtuje příkaz pro soubory jen pro čtení. Použití filtru k omezení příkazu na soubory s příponou .log názvu souboru místo zadání *.log v cestě zrychlová operaci.

Příklad 3: Vymazání všech dat ze streamu

Tento příklad ukazuje, jak rutina Clear-Content vymaže obsah z alternativního datového streamu a přitom datový proud ponechá nedotčený.

První příkaz použije rutinu Get-Content k získání obsahu datového Zone.Identifier proudu v Copy-Script.ps1 souboru, který byl stažen z internetu.

Druhý příkaz použije rutinu Clear-Content k vymazání obsahu.

Třetí příkaz zopakuje první příkaz. Ověří, že je obsah vymazán, ale stream zůstane. Pokud se datový proud odstranil, příkaz by vygeneroval chybu.

K vymazání obsahu alternativního datového proudu můžete použít metodu, jako je tato. Nedoporučuje se ale eliminovat kontroly zabezpečení, které blokují soubory stažené z internetu. Pokud ověříte, že stažený soubor je bezpečný, použijte rutinu 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

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Poznámka

Tento parametr nejsou podporovány žádnými poskytovateli nainstalovanými v PowerShellu. Pokud chcete zosobnit jiného uživatele nebo zvýšit úroveň přihlašovacích údajů při spuštění této rutiny, použijte Invoke-Command.

Type:PSCredential
Position:Named
Default value:Current user
Accept pipeline input:True
Accept wildcard characters:False

-Exclude

Určuje jako pole řetězců řetězce, které tato rutina vynechá z cesty k obsahu. Hodnota tohoto parametru kvalifikuje parametr Path . Zadejte prvek cesty nebo vzor, například *.txt. Jsou povoleny zástupné dokumentace.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-Filter

Určuje filtr ve formátu nebo jazyce poskytovatele. Hodnota tohoto parametru kvalifikuje parametr Path . Syntaxe filtru, včetně použití zástupných znaků, závisí na poskytovateli. Filtry jsou efektivnější než jiné parametry, protože zprostředkovatel je použije při načítání objektů, a ne když powershellové filtruje objekty po jejich načtení.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-Force

Vynutí spuštění příkazu bez žádosti o potvrzení uživatele.

Type:SwitchParameter
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-Include

Určuje obsah, který tato rutina vymaže, jako pole řetězců. Hodnota tohoto parametru kvalifikuje parametr Path . Zadejte prvek cesty nebo vzor, například *.txt. Jsou povoleny zástupné dokumentace.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-LiteralPath

Určuje cesty k položkám, ze kterých se obsah odstraní. Na rozdíl od parametru Path se hodnota LiteralPath používá přesně tak, jak je zadána. Žádné znaky nejsou interpretovány jako zástupné znaky. Pokud cesta obsahuje řídicí znaky, uzavřete ji do jednoduchých uvozovek ('). Jednoduché uvozovky říkají, že PowerShell nemůže interpretovat žádné znaky jako řídicí sekvence.

Type:String[]
Aliases:PSPath, LP
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Path

Určuje cesty k položkám, ze kterých se obsah odstraní. Jsou povoleny zástupné dokumentace. Cesty musí být cesty k položkám, ne ke kontejnerům. Musíte například zadat cestu k jednomu nebo více souborům, nikoli cestu k adresáři. Jsou povoleny zástupné dokumentace. Tento parametr je povinný, ale název parametru (Path) je volitelný.

Type:String[]
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:True

-Stream

Poznámka

Tento parametr je k dispozici pouze ve Windows.

Určuje alternativní datový proud pro obsah. Pokud stream neexistuje, tato rutina ho vytvoří. Zástupné znaky nejsou podporovány.

Stream je dynamický parametr, který zprostředkovatel FileSystem přidá do Clear-Content. Tento parametr funguje jenom na jednotkách systému souborů a vymaže obsah alternativních datových proudů v souborech i adresářích.

Pomocí rutiny Clear-Content můžete změnit obsah libovolného alternativního datového proudu, například Zone.Identifier. Nedoporučujeme to ale jako způsob, jak eliminovat kontroly zabezpečení, které blokují soubory stažené z internetu. Pokud ověříte, že stažený soubor je bezpečný, použijte rutinu Unblock-File .

Tento parametr byl zaveden v PowerShellu 3.0. Od PowerShellu 7.2 Clear-Content může vymazat obsah alternativních datových proudů z adresářů a souborů.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

None

Objekty nelze roušit do Clear-Content.

Výstupy

None

Tato rutina nevrací žádné objekty.

Poznámky

Můžete použít Clear-Content s poskytovatelem systému souborů PowerShellu a s dalšími poskytovateli, kteří manipulují s obsahem. Pokud chcete vymazat položky, které nejsou považovány za obsah, například položky spravované certifikátem PowerShellu nebo poskytovateli registru, použijte Clear-Item.

Rutina Clear-Content je navržená tak, aby fungovala s daty vystavenými libovolným poskytovatelem. Chcete-li zobrazit seznam poskytovatelů dostupných v relaci, zadejte Get-PsProvider. Další informace najdete v tématu about_Providers.