Sdílet prostřednictvím

Clear-Item

Modul:
Microsoft.PowerShell.Management Module

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

Syntax

Path (Výchozí) 

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

LiteralPath 

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 $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 Clear-ItemProperty cmdlet.
Clear-Item HKLM:\Software\MyCompany\MyKey -Confirm

Parametry

-Confirm

Před spuštěním cmdletu vás vyzve k potvrzení.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False
Aliasy:viz

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:PSCredential
Default value:Current user
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Exclude

Určuje, jako pole řetězců, položku nebo položky, které tento příkaz vylučuje z operace. 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.

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:True
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-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.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:True
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-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. Pro více informací viz about_Providers. Příkazový modul nemůže přepsat bezpečnostní omezení, ani když je použit parametr Force.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Include

Určuje, jako pole řetězců, jednu nebo více položek, které tento cmdlet 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.

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:True
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-LiteralPath

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

Další informace najdete v about_Quoting_Rules.

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:PSPath, PO

Sady parametrů

LiteralPath
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů: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ý.

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:True
DontShow:False

Sady parametrů

Path
Position:0
Povinné:True
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Wi

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

String

Můžete odeslat řetězec cesty do této rutiny cmdlet.

Výstupy

None

Tento cmdlet nevrátí žádný výstup.

Poznámky

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

  • Všechny platformy:

    • cli

  • Cmdlet Clear-Item je podporován pouze několika poskytovateli PowerShellu, včetně poskytovatelů aliasu , prostředí , funkce , registru a proměnných . V takovém případě můžete pomocí Clear-Item odstranit obsah položek v názvových prostorech zprostředkovatele. Chcete-li zobrazit seznam poskytovatelů dostupných ve vaší relaci, napište Get-PsProvider. Pro více informací viz 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.