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]
[-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
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-Itemale funguje s položkami s obsahem, nikoli 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" -ForceTento 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 zpřístupňuje 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 z datového proudu
Tento příklad ukazuje, jak rutina Clear-Content vymaže obsah z alternativního datového streamu, zatímco datový proud zůstane nedotčený.
První příkaz pomocí rutiny Get-Content získá obsah datového Zone.Identifier proudu v Copy-Script.ps1 souboru, který byl stažen z internetu.
Druhý příkaz pomocí rutiny Clear-Content vymaže obsah.
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 stažený soubor je bezpečný, použijte tuto 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í.
| Typ: | SwitchParameter |
| Aliasy: | cf |
| Position: | Named |
| Default value: | None |
| 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 element nebo vzor cesty, 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 element nebo vzor cesty, 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, LP |
| 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
Jedná se o dynamický parametr, který zpřístupnil zprostředkovatel FileSystem . 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.
Pomocí této 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 tuto rutinu Unblock-File .
Tento parametr byl představen v PowerShellu 3.0. Od PowerShellu 7.2 Clear-Content může vymazat obsah alternativních datových proudů z adresářů i souborů.
Další informace najdete v tématu about_FileSystem_Provider.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
| 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
Do této rutiny nemůžete roušit objekty.
Výstupy
None
Tato rutina nevrátí žádný výstup.
Poznámky
PowerShell obsahuje následující aliasy pro Clear-Content:
- Všechny platformy:
clc
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é 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.
Pokud chcete zobrazit seznam poskytovatelů dostupných v relaci, zadejte Get-PsProvider.
Další informace najdete v tématu about_Providers.
