Clear-Content

Törli egy elem tartalmát, de nem törli az elemet.

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

A Clear-Content parancsmag törli egy elem tartalmát, például törli a szöveget egy fájlból, de nem törli az elemet. Ennek eredményeképpen az elem létezik, de üres. Clear-Content A hasonló Clear-Item, de az értékeket tartalmazó elemek helyett a tartalommal rendelkező elemeken működik.

Példák

1. példa: Az összes tartalom törlése egy könyvtárból

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

Ez a parancs törli az összes tartalmat a init.txt könyvtár összes alkönyvtárában SmpUsers található fájlokból. A fájlok nem törlődnek, de üresek.

2. példa: Az összes fájl tartalmának törlése helyettesítő karakterrel

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

Ez a parancs törli az aktuális könyvtárban lévő összes fájl tartalmát a .log fájlnévkiterjesztéssel, beleértve az írásvédett attribútummal rendelkező fájlokat is. Az elérési út csillaga (*) az aktuális könyvtár összes elemét jelöli. A Force paraméterrel a parancs írásvédett fájlokon is hatékonyan működik. Ha szűrővel korlátozza a parancsot a fájlnévkiterjesztéssel rendelkező fájlokra ahelyett .log , hogy megadná *.log az elérési úton, gyorsabban végrehajthatja a műveletet.

3. példa: Az összes adat törlése egy streamből

Ez a példa bemutatja, hogyan törli a Clear-Content parancsmag a tartalmat egy másik adatfolyamból, miközben az adatfolyam érintetlen marad.

Az első parancs a Get-Content parancsmag használatával lekéri a Zone.Identifier fájlban lévő Copy-Script.ps1 adatfolyam tartalmát, amely az internetről lett letöltve.

A második parancs a Clear-Content parancsmaggal törli a tartalmat.

A harmadik parancs megismétli az első parancsot. Ellenőrzi, hogy a tartalom törölve van-e, de a stream továbbra is megmarad. Ha törölné a streamet, a parancs hibát eredményezne.

Egy ehhez hasonló módszerrel törölheti egy másik adatfolyam tartalmát. Az internetről letöltött fájlokat letiltó biztonsági ellenőrzések azonban nem ajánlottak. Ha ellenőrzi, hogy a letöltött fájl biztonságos-e, használja a Unblock-File parancsmagot.

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

Paraméterek

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

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

-Credential

Megjegyzés

Ezt a paramétert a PowerShell-lel telepített szolgáltatók nem támogatják. Ha egy másik felhasználót szeretne megszemélyesíteni, vagy a parancsmag futtatásakor megemelni a hitelesítő adatait, használja Invoke-Commanda következőt: .

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

-Exclude

Sztringtömbként megadja azokat a sztringeket, amelyeket ez a parancsmag kihagy a tartalom elérési útjából. Ennek a paraméternek az értéke minősíti az Elérési út paramétert. Adjon meg egy elérésiút-elemet vagy mintát, például *.txt. Helyettesítő karakterek használata engedélyezett.

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

-Filter

Szűrőt ad meg a szolgáltató formátumában vagy nyelvén. Ennek a paraméternek az értéke minősíti az Elérési út paramétert. A szűrő szintaxisa, beleértve a helyettesítő karakterek használatát is, a szolgáltatótól függ. A szűrők hatékonyabbak a többi paraméternél, mivel a szolgáltató azokat az objektumok lekérésekor alkalmazza ahelyett, hogy a PowerShell a beolvasásuk után szűri az objektumokat.

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

-Force

Kényszeríti a parancs futtatását a felhasználó megerősítésének kérése nélkül.

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

-Include

Sztringtömbként megadja a parancsmag által törölt tartalmat. Ennek a paraméternek az értéke minősíti az Elérési út paramétert. Adjon meg egy elérésiút-elemet vagy mintát, például *.txt. Helyettesítő karakterek használata engedélyezett.

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

-LiteralPath

Megadja azoknak az elemeknek az elérési útját, amelyekből a tartalmat törölték. Az Elérési út paramétertől eltérően a LiteralPath értéke pontosan a begépelt módon lesz felhasználva. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési út tartalmaz feloldókaraktereket, tegye idézőjelek közé ('). Az szimpla idézőjelek azt jelzik, hogy a PowerShell egyetlen karaktert sem értelmez feloldókarakterekként.

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

-Path

Megadja azoknak az elemeknek az elérési útját, amelyekből a tartalmat törölték. Helyettesítő karakterek használata engedélyezett. Az elérési utaknak nem tárolók, hanem elemek elérési útjainak kell lenniük. Meg kell adnia például egy vagy több fájl elérési útját, nem pedig egy könyvtár elérési útját. Helyettesítő karakterek használata engedélyezett. Ez a paraméter kötelező, de a paraméter neve (Elérési út) megadása nem kötelező.

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

-Stream

Megjegyzés

Ez a paraméter csak Windows rendszeren érhető el.

Alternatív adatfolyamot ad meg a tartalomhoz. Ha a stream nem létezik, ez a parancsmag hozza létre. A helyettesítő karakterek nem támogatottak.

A Stream egy dinamikus paraméter, amelyet a fájlrendszer-szolgáltató ad hozzá Clear-Content. Ez a paraméter csak fájlrendszer-meghajtókon működik, és törli az alternatív adatfolyamok tartalmát a fájlokon és a könyvtárakon.

A parancsmaggal Clear-Content bármilyen alternatív adatfolyam tartalmát módosíthatja, például Zone.Identifier. Ezt azonban nem javasoljuk az internetről letöltött fájlokat blokkoló biztonsági ellenőrzések kiküszöbölésére. Ha ellenőrzi, hogy a letöltött fájl biztonságos-e, használja a Unblock-File parancsmagot.

Ez a paraméter a PowerShell 3.0-ban lett bevezetve. A PowerShell 7.2-től Clear-Content kezdve képes törölni az alternatív adatfolyamok tartalmát a könyvtárakból és a fájlokból.

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

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

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

Bevitelek

None

Az objektumok nem adhatók át a célnak Clear-Content.

Kimenetek

None

Ez a parancsmag nem ad vissza objektumokat.

Jegyzetek

Használhatja Clear-Content a PowerShell fájlrendszer-szolgáltatóval és a tartalmat módosító más szolgáltatókkal. Ha törölni szeretné a tartalomnak nem minősülő elemeket, például a PowerShell-tanúsítvány- vagy beállításjegyzék-szolgáltatók által kezelt elemeket, használja a következőt Clear-Item: .

A Clear-Content parancsmagot úgy tervezték, hogy bármely szolgáltató által közzétett adatokkal működjön. A munkamenetben elérhető szolgáltatók listázásához írja be a következőt Get-PsProvider: . További információ: about_Providers.