Clear-Content
Odstraní obsah položky, ale neodstraní položku.
Syntax
Path (Výchozí)
Clear-Content
[-Path] <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[-Stream <String>]
[<CommonParameters>]
LiteralPath
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" -Force
Tento 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 cmdletu vás vyzve k potvrzení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | viz |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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.
Vlastnosti parametru
| Typ: | PSCredential |
| Default value: | Current user |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | 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é symboly.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-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.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Force
Přinutí příkaz ke spuštění bez výzvy k potvrzení uživatele.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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é symboly.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-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ý znak není interpretován jako zástupný znak. Pokud cesta obsahuje únikové znaky, uzavřete ji do jednoduchých uvozovek. Jednoduché uvozovky říkají, že PowerShell nemůže interpretovat žádné znaky jako řídicí sekvence.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | PSPath |
Sady parametrů
LiteralPath
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Path
Určuje cesty k položkám, ze kterých se obsah odstraní. Jsou povoleny zástupné symboly. Cesty musí vést 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é symboly. Tento parametr je povinný, ale název parametru ("Cesta") je volitelný.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
Path
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-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.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | usetx |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-WhatIf
Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Wi |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
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.
Chcete-li zobrazit seznam poskytovatelů dostupných ve vaší relaci, napište Get-PsProvider.
Pro více informací viz about_Providers.