Clear-Content

  • Reference
Modul:
Microsoft.PowerShell.Management

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

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>]
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" -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 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í.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
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
Required:False
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 element nebo vzor cesty, například *.txt. Jsou povoleny zástupné cardy.

Type:String[]
Position:Named
Default value:None
Required:False
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ů, místo aby po načtení objekty vyfiltroval PowerShell.

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

-Force

Vynutí spuštění příkazu bez výzvy k potvrzení uživatele.

Type:SwitchParameter
Position:Named
Default value:False
Required: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 element nebo vzor cesty, například *.txt. Jsou povoleny zástupné cardy.

Type:String[]
Position:Named
Default value:None
Required:False
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
Required:True
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é 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ý.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters: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.