Sdílet prostřednictvím

Clear-Item

  • Reference
Modul:
Microsoft.PowerShell.Management

Vymaže obsah položky, ale neodstraní ji.

Syntaxe

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

Rutina Clear-Item vymaže obsah položky, ale neodstraní ji. Například rutina Clear-Item může odstranit hodnotu proměnné, ale neodstraní proměnnou. Hodnota, která se používá k vyjádření nevymazané položky, je definována jednotlivými zprostředkovateli PowerShellu. Tato rutina se podobá Clear-Content, ale funguje na aliasech a proměnných místo souborů.

Příklady

Příklad 1: Vymazání hodnoty proměnné

Tento příkaz vymaže hodnotu proměnné s názvem TestVar1. Proměnná zůstává a je platná, ale její hodnota je nastavena na $nullhodnotu . Název proměnné je předponou Variable: označující zprostředkovatele proměnné PowerShellu.

Alternativní příkazy ukazují, že pokud chcete získat stejný výsledek, můžete přepnout na jednotku PowerShellu Variable: a pak příkaz spustit Clear-Item .

Clear-Item Variable:TestVar1

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

Příklad 2: Vymazání všech položek registru

Tento příkaz vymaže všechny položky registru v podklíči MyKey, ale až po zobrazení výzvy k potvrzení záměru. Neodstraní podklíč "MyKey" ani neovlivní žádné jiné klíče nebo položky registru. Pomocí parametrů Zahrnout a Vyloučit můžete identifikovat konkrétní klíče registru, ale nemůžete je použít k identifikaci položek registru.

  • Pokud chcete odstranit konkrétní položky registru, použijte rutinu Remove-ItemProperty .
  • Chcete-li odstranit hodnotu položky registru, použijte .Clear-ItemProperty cmdlet
Clear-Item HKLM:\Software\MyCompany\MyKey -Confirm

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Credential

Poznámka:

Tento parametr nejsou podporovány žádnými poskytovateli nainstalovanými v PowerShellu. Pokud chcete zosobnit jiného uživatele nebo zvýšit úroveň přihlašovacích údajů při spuštění této rutiny, použijte Invoke-Command.

Typ:PSCredential
Position:Named
Default value:Current user
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Exclude

Určuje, jako pole řetězců, položku nebo položky, které tato rutina vylučuje v operaci. Hodnota tohoto parametru kvalifikuje parametr Path . Zadejte element nebo vzor cesty, například *.txt. Jsou povoleny zástupné znaky. Parametr Exclude je účinný pouze v případě, že příkaz obsahuje obsah položky, například C:\Windows\*, kde zástupný znak určuje obsah C:\Windows adresáře.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:True

-Filter

Určuje filtr, který má kvalifikovat parametr Path . Zprostředkovatel fileSystem je jediným nainstalovaným poskytovatelem PowerShellu, který podporuje použití filtrů. Syntaxi jazyka filtru FileSystem najdete v about_Wildcards. Filtry jsou efektivnější než jiné parametry, protože je poskytovatel použije, když rutina získá objekty místo toho, aby objekty po jejich načtení vyfiltroval PowerShell.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:True

-Force

Označuje, že rutina vymaže položky, které nelze jinak změnit, například aliasy jen pro čtení. Rutina nemůže vymazat konstanty. Implementace se liší od zprostředkovatele po zprostředkovatele. Další informace najdete v tématu about_Providers. Rutina nemůže přepsat omezení zabezpečení, i když se použije parametr Force .

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Include

Určuje, jako pole řetězců, položku nebo položky, které tato rutina zahrnuje v operaci. Hodnota tohoto parametru kvalifikuje parametr Path . Zadejte element nebo vzor cesty, například "*.txt". Jsou povoleny zástupné znaky. Parametr Include je efektivní pouze v případě, že příkaz obsahuje obsah položky, například C:\Windows\*, kde zástupný znak určuje obsah C:\Windows adresáře.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:True

-LiteralPath

Určuje cestu k jednomu nebo více umístěním. Hodnota LiteralPath se používá přesně tak, jak je zadána. Žádné znaky nejsou interpretovány jako zástupné znaky. Pokud cesta obsahuje řídicí znaky, uzavřete ji do jednoduchých uvozovek. Jednoduché uvozovky říkají PowerShellu, aby nepřekládaly žádné znaky jako řídicí sekvence.

Další informace najdete v tématu about_Quoting_Rules.

Typ:String[]
Aliasy:PSPath, LP
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Path

Určuje cestu k odstraněným položkám. Jsou povoleny zástupné znaky. Tento parametr je povinný, ale cesta k názvu parametru je nepovinná.

Typ:String[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:True

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String

K této rutině můžete převést řetězec cesty.

Výstupy

None

Tato rutina nevrátí žádný výstup.

Poznámky

PowerShell obsahuje následující aliasy pro Clear-Item:

  • Všechny platformy:

    • cli

  • Rutina Clear-Item je podporovaná jenom několika poskytovateli PowerShellu, včetně zprostředkovatelů Alias, Environment, Function, Registry a Variable. Můžete například použít Clear-Item k odstranění obsahu položek v oborech názvů zprostředkovatele. Pokud chcete zobrazit seznam poskytovatelů dostupných v relaci, zadejte Get-PsProvider. Další informace najdete v tématu about_Providers.

  • Obsah souboru nelze odstranit Clear-Item , protože zprostředkovatel systému souborů PowerShellu tuto rutinu nepodporuje. Pokud chcete vymazat soubory, použijte .Clear-Content