Clear-Content
Odstraní obsah položky, ale neodstraní položku.
Syntaxe
Clear-Content
[-Path] <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[-Stream <String>]
[<CommonParameters>]Clear-Content
-LiteralPath <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[-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 se podobá 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 souborůinit.txtve všech podadresářích adresáře SmpUsers. 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" -ForceTento příkaz odstraní obsah všech souborů v aktuálním adresáři s příponou názvu souboru ".log", 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 způsobí, že příkaz bude efektivní pro soubory jen pro čtení. Použití filtru k omezení příkazu na soubory s příponou názvu souboru .log namísto zadání *.log v cestě zrychlová operace.
Příklad 3: Vymazání všech dat z datového proudu
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žívá rutinu Get-Content k získání obsahu streamu Zone.Identifier v souboru Copy-Script.ps1, 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 byl datový proud odstraněn, příkaz by vygeneroval chybu.
Pomocí podobné metody můžete vymazat obsah alternativního datového streamu. Není to však doporučený způsob, jak eliminovat kontroly zabezpečení, které blokují soubory stažené z internetu. Pokud ověříte, že je stažený soubor v bezpečí, 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 vás vyzve k potvrzení.
| Typ: | SwitchParameter |
| Aliasy: | cf |
| Position: | Named |
| Default value: | False |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | 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.
| Typ: | PSCredential |
| Position: | Named |
| Default value: | Current user |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | 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é cardy.
| Typ: | String[] |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | 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ů, místo aby po načtení objekty vyfiltroval PowerShell.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | True |
-Force
Vynutí spuštění příkazu bez výzvy k potvrzení uživatele.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | 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é cardy.
| Typ: | String[] |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | 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.
| Typ: | String[] |
| Aliasy: | PSPath |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-Path
Určuje cesty k položkám, ze kterých se obsah odstraní. Jsou povoleny zástupné cardy. Cesty musí být cesty k položkám, nikoli ke kontejnerům. Musíte například zadat cestu k jednomu nebo více souborům, nikoli cestě k adresáři. Jsou povoleny zástupné cardy. Tento parametr je povinný, ale název parametru ("Cesta") je volitelný.
| Typ: | String[] |
| Position: | 0 |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | True |
-Stream
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ává do Clear-Content.
Tento parametr funguje jenom na jednotkách systému souborů.
Pomocí rutiny Clear-Content můžete změnit obsah alternativního datového streamu 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 je stažený soubor v bezpečí, použijte rutinu Unblock-File.
Tento parametr byl představen ve Windows PowerShellu 3.0.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-UseTransaction
Zahrnuje příkaz v aktivní transakci. Tento parametr je platný pouze v případě, že probíhá transakce. Další informace najdete v tématu about_transactions.
| Typ: | SwitchParameter |
| Aliasy: | usetx |
| Position: | Named |
| Default value: | False |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-WhatIf
Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.
| Typ: | SwitchParameter |
| Aliasy: | wi |
| Position: | Named |
| Default value: | False |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
Vstupy
None
Objekty nelze pipetovat 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.
Chcete-li vymazat položky, které nejsou považovány za obsah, například položky spravované pomocí certifikátu PowerShellu nebo poskytovatele registru, použijte Clear-Item.
Rutina Clear-Content je navržená tak, aby fungovala s daty vystavenými jakýmkoli poskytovatelem.
Pokud chcete zobrazit seznam poskytovatelů dostupných v relaci, zadejte Get-PsProvider.
Další informace naleznete v tématu about_Providers.