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>]
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-Content
Clear-Item
hasonló, 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.
Típus: | SwitchParameter |
Aliasok: | cf |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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-Command
a következőt: .
Típus: | PSCredential |
Position: | Named |
Alapértelmezett érték: | Current user |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String[] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | True |
-Force
Kényszeríti a parancs futtatását anélkül, hogy felhasználói megerősítést kérne.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String[] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String[] |
Aliasok: | PSPath, LP |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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ő.
Típus: | String[] |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-WhatIf
Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.
Típus: | SwitchParameter |
Aliasok: | wi |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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-Content
tartalmazza:
- 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.