Clear-Content

  • Referencia
Modul:
Microsoft.PowerShell.Management

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>]
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

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ént az elem létezik, de üres. Clear-ContentClear-Itemhasonló, 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 lévő 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éter a parancsot írásvédett fájlokon teszi hatékonyan. Ha szűrővel korlátozza a parancsot a fájlnévkiterjesztéssel rendelkező fájlokra az .log elérési út megadása *.log helyett, a művelet gyorsabb lesz.

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

Ez a példa bemutatja, hogy a Clear-Content parancsmag hogyan törli a tartalmat egy másik adatfolyamból, miközben érintetlenül hagyja a streamet.

Az első parancs a Get-Content parancsmagot használja a fájlban lévő Copy-Script.ps1 stream tartalmának Zone.Identifier lekéréséhez, 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 a stream törölve lett volna, a parancs hibát okozna.

Az ehhez hasonló metódussal 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 egy 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Feljegyzé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 emeli a hitelesítő adatait, használja Invoke-Commanda következőt: .

Type:PSCredential
Position:Named
Default value:Current user
Required:False
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 az Elérési út paramétert minősíti. 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
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Filter

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

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

-Force

Kényszeríti a parancs futtatását anélkül, hogy felhasználói megerősítést kérne.

Type:SwitchParameter
Position:Named
Default value:False
Required: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 az Elérési út paramétert minősíti. 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
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-LiteralPath

Megadja azoknak az elemeknek az elérési útját, amelyekből a tartalom törlődik. Az Elérési út paramétertől eltérően a LiteralPath értéke pontosan a beírt módon lesz használva. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési út tartalmaz feloldó karaktereket, csatolja egy idézőjelbe ('). Az egy idézőjelek azt jelzik, hogy a PowerShell nem értelmezi a karaktereket menekülési sorozatként.

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

-Path

Megadja azoknak az elemeknek az elérési útját, amelyekből a tartalom törlődik. Helyettesítő karakterek használata engedélyezett. Az elérési utaknak nem tárolókhoz, hanem elemekhez vezető elérési utaknak kell lenniük. Például meg kell adnia 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) nem kötelező.

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

-Stream

Ez a fájlrendszer-szolgáltató által elérhetővé tett dinamikus paraméter. 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 parancsmaggal Clear-Content módosíthatja bármely alternatív adatfolyam tartalmát, például Zone.Identifier. Ezt azonban nem javasoljuk, hogy kiküszöbölje az internetről letöltött fájlokat letiltó biztonsági ellenőrzéseket. Ha ellenőrzi, hogy egy letöltött fájl biztonságos-e, használja a Unblock-File parancsmagot.

Ezt a paramétert a PowerShell 3.0-ban vezettük be. A PowerShell 7.2-től Clear-Content kezdve törölheti az alternatív adatfolyamok tartalmát könyvtárakból és fájlokból.

További információ: about_FileSystem_Provider.

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

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

None

Ez a parancsmag nem ad vissza kimenetet.

Jegyzetek

A PowerShell a következő aliasokat Clear-Contenttartalmazza:

  • Minden platform:
    • clc

Clear-Content Használhatja a PowerShell FileSystem szolgáltatót és a tartalmakat módosító más szolgáltatókat is. A tartalomnak nem minősülő elemek, például a PowerShell-tanúsítvány vagy a beállításjegyzék-szolgáltatók által kezelt elemek törléséhez használja a következőt Clear-Item:

A Clear-Content parancsmag úgy lett kialakítva, hogy bármely szolgáltató által közzétett adatokkal működjön együtt. A munkamenetben elérhető szolgáltatók listájához írja be a következőt Get-PsProvider: További információ: about_Providers.