Clear-Item

  • Referencia
Modul:
Microsoft.PowerShell.Management

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

Syntax

Clear-Item
     [-Path] <String[]>
     [-Force]
     [-Filter <String>]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-Credential <PSCredential>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Clear-Item
     -LiteralPath <String[]>
     [-Force]
     [-Filter <String>]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-Credential <PSCredential>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

A Clear-Item parancsmag törli egy elem tartalmát, de nem törli az elemet. A parancsmag például Clear-Item törölheti egy változó értékét, de nem törli a változót. A törölt elemek megjelenítéséhez használt értéket minden PowerShell-szolgáltató definiálja. Ez a parancsmag hasonló a parancsmaghoz Clear-Content, de fájlok helyett aliasokon és változókon működik.

Példák

1. példa: Változó értékének törlése

Ez a parancs törli a névvel ellátott TestVar1változó értékét. A változó megmarad és érvényes, de értéke a következőre $nullvan állítva: . A változó neve előtaggal Variable: van elnevítve a PowerShell-változó szolgáltatójának jelzéséhez.

A másodlagos parancsok azt mutatják, hogy ugyanahhoz az eredményhez válthat a PowerShell-meghajtóra Variable: , majd futtathatja a Clear-Item parancsot.

Clear-Item Variable:TestVar1

Set-Location Variable:
PS Variable:\> Clear-Item TestVar1

2. példa: Az összes beállításjegyzék-bejegyzés törlése

Ez a parancs törli a "MyKey" alkulcs összes beállításjegyzék-bejegyzését, de csak azután, hogy a szándék megerősítésére kéri. Nem törli a "MyKey" alkulcsot, és nem befolyásolja az egyéb beállításkulcsokat vagy bejegyzéseket. A Belefoglalás és kizárás paraméterekkel azonosíthat bizonyos beállításkulcsokat, de nem használhatja őket beállításjegyzék-bejegyzések azonosítására.

  • Bizonyos beállításjegyzék-bejegyzések törléséhez használja a Remove-ItemProperty parancsmagot.
  • A beállításjegyzék-bejegyzés értékének törléséhez használja a következőt Clear-ItemProperty cmdlet: .
Clear-Item HKLM:\Software\MyCompany\MyKey -Confirm

Paraméterek

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
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 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.

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

-Exclude

Sztringtömbként olyan elemet vagy elemeket határoz meg, amelyeket ez a parancsmag kizár a műveletbő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. A helyettesítő karakterek használata engedélyezett. A Kizárás paraméter csak akkor érvényes, ha a parancs egy elem tartalmát tartalmazza, például C:\Windows\*ha a helyettesítő karakter a könyvtár tartalmát C:\Windows adja meg.

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

-Filter

Egy szűrőt ad meg, amely megfelel az Elérési út paraméternek. A Fájlrendszer-szolgáltató az egyetlen telepített PowerShell-szolgáltató, amely támogatja a szűrők használatát. A Fájlrendszer szűrőnyelvének szintaxisa about_Wildcards található. A szűrők hatékonyabbak, mint a többi paraméter, mivel a szolgáltató akkor alkalmazza őket, amikor a parancsmag lekéri az objektumokat, és nem azt, hogy a PowerShell szűrje az objektumokat a lekérés után.

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

-Force

Azt jelzi, hogy a parancsmag törli az egyébként nem módosítható elemeket, például írásvédett aliasokat. A parancsmag nem tudja törölni az állandókat. A megvalósítás szolgáltatónként eltérő. További információ: about_Providers. A parancsmag nem tudja felülbírálni a biztonsági korlátozásokat, még akkor sem, ha a Force paramétert használja.

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

-Include

Sztringtömbként egy elemet vagy elemet határoz meg, amelyet ez a parancsmag tartalmaz a műveletben. 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". A helyettesítő karakterek használata engedélyezett. Az Include paraméter csak akkor érvényes, ha a parancs egy elem tartalmát tartalmazza, például C:\Windows\*amikor a helyettesítő karakter a könyvtár tartalmát C:\Windows adja meg.

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

-LiteralPath

Egy vagy több hely elérési útját adja meg. A LiteralPath értékét pontosan a beírt módon használja a rendszer. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési út tartalmaz escape karaktereket, csatolja egy idézőjelek közé. Az idézőjelek azt mondják a PowerShellnek, hogy ne értelmezzen karaktereket feloldósorozatként.

További információ: about_Quoting_Rules.

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

-Path

Megadja a törölni kívánt elemek elérési útját. A helyettesítő karakterek használata engedélyezett. Ez a paraméter kötelező, de az Elérési út paraméter neve nem kötelező.

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

-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

String

Ehhez a parancsmaghoz egy elérésiút-sztringet is beszúrhat.

Kimenetek

None

Ez a parancsmag nem ad vissza kimenetet.

Jegyzetek

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

  • Összes platform:

    • cli

  • A Clear-Item parancsmagot csak több PowerShell-szolgáltató támogatja, beleértve az aliast, a környezetet, a függvényt, a beállításjegyzéket és a változószolgáltatókat. Clear-Item Így törölheti a szolgáltatói névterek elemeinek tartalmát. A munkamenetben elérhető szolgáltatók listájához írja be a következőt Get-PsProvider: További információ: about_Providers.

  • Nem lehet Clear-Item törölni egy fájl tartalmát, mert a PowerShell-fájlrendszer-szolgáltató nem támogatja ezt a parancsmagot. A fájlok törléséhez használja a Clear-Content.