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]
     [-UseTransaction]
     [<CommonParameters>]
Clear-Item
     -LiteralPath <String[]>
     [-Force]
     [-Filter <String>]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-Credential <PSCredential>]
     [-WhatIf]
     [-Confirm]
     [-UseTransaction]
     [<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 $null. Název proměnné má předponu Variable: označující zprostředkovatele proměnných PowerShellu.

Alternativní příkazy ukazují, že pokud chcete získat stejný výsledek, můžete přepnout na jednotku PowerShellu Variable: a pak spustit příkaz 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 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.
  • Pokud chcete odstranit hodnotu položky registru, použijte rutinu Clear-ItemProperty.
Clear-Item HKLM:\Software\MyCompany\MyKey -Confirm

Parametry

-Confirm

Před spuštěním rutiny vás vyzve 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 oprávnění 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 prvek cesty nebo vzor, například *.txt. Jsou povoleny zástupné znaky. Parametr Exclude je efektivní pouze v případě, že příkaz obsahuje obsah položky, například C:\Windows\*, kde zástupný znak určuje obsah adresáře C:\Windows.

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 pro kvalifikaci parametru 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 naleznete 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 prvek cesty nebo vzor, 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 adresáře C:\Windows.

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
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 název parametru cesta 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

-UseTransaction

Zahrnuje příkaz v aktivní transakci. Tento parametr je platný pouze v případě, že probíhá transakce. Další informace najdete v tématu about_Transactions.

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

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

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 negeneruje žádný výstup.

Poznámky

  • Rutinu podporuje jenom několik poskytovatelů PowerShellu, včetněaliasu ,prostředí ,funkce , registru a zprostředkovatelů proměnných. V takovém případě můžete pomocí Clear-Item odstranit obsah položek v oborech názvů zprostředkovatele. Pokud chcete zobrazit seznam poskytovatelů dostupných v relaci, zadejte Get-PsProvider. Další informace naleznete v tématu about_Providers.
  • Obsah souboru nelze odstranit pomocí Clear-Item, protože zprostředkovatel systému souborů PowerShellu tuto rutinu nepodporuje. Pokud chcete vymazat soubory, použijte Clear-Content.