Clear-Content
Törli egy elem tartalmát, de nem törli az elemet.
Syntax
Path (Alapértelmezett)
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
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.
A Clear-Content hasonló a 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" fájlokból az SmpUsers könyvtár összes alkönyvtárában. 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 csak olvasható fájlokon teszi hatékonyan. Ha szűrővel korlátozza a parancsot a .log fájlnévkiterjesztéssel rendelkező fájlokra ahelyett, hogy *.log ad meg az elérési úton, 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 Zone.Identifier stream tartalmának lekéréséhez az internetről letöltött Copy-Script.ps1 fájlban.
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
Megerősítést kér a parancsmag futtatása előtt.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Cf |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Credential
Megjegyzés:
Ezt a paramétert a PowerShell-lel telepített szolgáltatók nem támogatják. Ha megszemélyesíteni szeretne egy másik felhasználót, vagy a parancsmag futtatásakor emeli a hitelesítő adatait, használja az Invoke-Command parancsot.
Paramétertulajdonságok
| Típus: | PSCredential |
| Alapértelmezett érték: | Current user |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | 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 a 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.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Filter
A szűrőt a szolgáltató formátumában vagy nyelvén adja meg. Ennek a paraméternek az értéke a 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.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Force
Kényszeríti a parancs futtatását anélkül, hogy felhasználói megerősítést kérne.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Include
Sztringtömbként megadja a parancsmag által törölt tartalmat. Ennek a paraméternek az értéke a 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.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-LiteralPath
Megadja azoknak az elemeknek az elérési útját, amelyekből a tartalom törlődik. A Path paramétertől eltérően a LiteralPath értéke pontosan a beíráskor lesz használva. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési útvonal escape karaktereket tartalmaz, tedd azt egyes idézőjelek közé. Az egy idézőjelek azt jelzik, hogy a PowerShell nem értelmezi a karaktereket menekülési sorozatként.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | PSPath |
Paraméterkészletek
LiteralPath
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | 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") megadása nem kötelező.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
Path
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-Stream
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.
Stream egy dinamikus paraméter, amelyet a Fájlrendszer-szolgáltató a Clear-Content-höz ad hozzá.
Ez a paraméter csak fájlrendszer-meghajtókon működik.
A Clear-Content parancsmaggal módosíthatja a Zone.Identifier alternatív adatfolyam tartalmát.
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 Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-UseTransaction
Tartalmazza a parancsot az aktív tranzakcióban. Ez a paraméter csak akkor érvényes, ha egy tranzakció folyamatban van. További információ: about_transactions.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | usetx |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-WhatIf
Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Wi |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
None
Az objektumokat nem lehet Clear-Content.
Kimenetek
None
Ez a parancsmag nem ad vissza objektumokat.
Jegyzetek
A Clear-Content a PowerShell-fájlrendszer szolgáltatójával és más tartalomkezelő szolgáltatókkal is használhatja.
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 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 Get-PsProvider.
További információért lásd a about_Providerscímű részt.