Sdílet prostřednictvím

Get-Item

  • Reference
Modul:
Microsoft.PowerShell.Management

Získá položku v zadaném umístění.

Syntaxe

Get-Item
   [-Path] <String[]>
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Force]
   [-Credential <PSCredential>]
   [-UseTransaction]
   [-Stream <String[]>]
   [<CommonParameters>]
Get-Item
   -LiteralPath <String[]>
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Force]
   [-Credential <PSCredential>]
   [-UseTransaction]
   [-Stream <String[]>]
   [<CommonParameters>]

Description

Rutina Get-Item získá položku v zadaném umístění. Nezískal obsah položky v umístění, pokud k vyžádání veškerého obsahu položky nepoužíváte zástupný znak (*).

Tuto rutinu používají poskytovatelé PowerShellu k procházení různých typů úložišť dat.

Příklady

Příklad 1: Získání aktuálního adresáře

Tento příkaz získá aktuální adresář. Tečka (.) představuje položku v aktuálním umístění (nikoli v jejím obsahu).

Get-Item .

Directory: C:\

Mode                LastWriteTime     Length Name
----                -------------     ------ ----
d----         7/26/2006  10:01 AM            ps-test

Příklad 2: Získání všech položek v aktuálním adresáři

Tento příkaz získá všechny položky v aktuálním adresáři. Zástupný znak (*) představuje veškerý obsah aktuální položky.

Get-Item *

Directory: C:\ps-test

Mode                LastWriteTime     Length Name
----                -------------     ------ ----
d----         7/26/2006   9:29 AM            Logs
d----         7/26/2006   9:26 AM            Recs
-a---         7/26/2006   9:28 AM         80 date.csv
-a---         7/26/2006  10:01 AM         30 filenoext
-a---         7/26/2006   9:30 AM      11472 process.doc
-a---         7/14/2006  10:47 AM         30 test.txt

Příklad 3: Získání aktuálního adresáře jednotky

Tento příkaz získá aktuální adresář jednotky C: . Načtený objekt představuje pouze adresář, nikoli jeho obsah.

Get-Item C:\

Příklad 4: Získání položek na zadané jednotce

Tento příkaz získá položky v jednotce C: . Zástupný znak (*) představuje všechny položky v kontejneru, nejen kontejner.

V PowerShellu použijte jednu hvězdičku (') k získání obsahu místo tradičního.". Formát se interpretuje doslova, takže ".*" by nenačetl adresáře ani názvy souborů bez tečky.

Get-Item C:\*

Příklad 5: Získání vlastnosti v zadaném adresáři

Tento příkaz získá vlastnost LastAccessTime adresáře "C:\Windows". LastAccessTime je jen jednou vlastností adresářů systému souborů. Pokud chcete zobrazit všechny vlastnosti adresáře, zadejte (Get-Item \<directory-name\>) | Get-Member.

(Get-Item C:\Windows).LastAccessTime

Příklad 6: Zobrazení obsahu klíče registru

Tento příkaz zobrazí obsah klíče registru Microsoft.PowerShellu. Tuto rutinu můžete použít s poskytovatelem registru PowerShellu k získání klíčů registru a podklíčů registru, ale k získání hodnot a dat registru musíte použít rutinu Get-ItemProperty.

Get-Item HKLM:\Software\Microsoft\Powershell\1\Shellids\Microsoft.Powershell\

Příklad 7: Získání položek v adresáři s vyloučením

Tento příkaz získá položky v adresáři Windows s názvy, které obsahují tečku (.), ale nezačínají znakem "w*". Tento příkaz funguje pouze v případě, že cesta obsahuje zástupný znak (*) k určení obsahu položky.

Get-Item c:\Windows\*.* -Exclude "w*"

Parametry

-Credential

Určuje uživatelský účet, který má oprávnění k provedení této akce. Výchozí hodnota je aktuální uživatel.

Zadejte uživatelské jméno, například "User01" nebo "Domain01\User01", nebo zadejte PSCredential objekt, například objekt vygenerovaný rutinou Get-Credential. Pokud zadáte uživatelské jméno, zobrazí se výzva k zadání hesla.

Varování

Tento parametr nejsou podporovány žádnými poskytovateli nainstalovanými ve Windows PowerShellu.

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 platí 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 ve formátu nebo jazyce poskytovatele. Hodnota tohoto parametru kvalifikuje parametr Path.

Syntaxe filtru, včetně použití zástupných znaků, závisí na poskytovateli. 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 tato rutina získá položky, ke kterým se jinak nedá získat přístup, například skryté položky. Implementace se liší od zprostředkovatele po zprostředkovatele. Další informace naleznete v tématu about_Providers. I při použití parametru Force nemůže rutina přepsat omezení zabezpečení.

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 položce. Na rozdíl od parametru Path se hodnota LiteralPath 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.

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 položce. Tato rutina získá položku v zadaném umístění. Jsou povoleny zástupné cardy. Tento parametr je povinný, ale název parametru ("Cesta") je volitelný.

Pomocí tečky (.) zadejte aktuální umístění. Pomocí zástupné znaky (*) zadejte všechny položky v aktuálním umístění.

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

-Stream

Získá zadaný alternativní soubor NTFS stream ze souboru. Zadejte název datového proudu. Podporují se zástupné kóty. Pokud chcete získat všechny streamy, použijte hvězdičku (*). Tento parametr není u složek platný.

Stream je dynamický parametr, který zprostředkovatel FileSystem přidává do rutiny Get-Item. Tento parametr funguje jenom na jednotkách systému souborů.

Typ:String[]
Position:Named
Default value:No alternate file streams
Vyžadováno:False
Přijmout vstup kanálu:False
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

Vstupy

String

Řetězec, který obsahuje cestu k této rutině, můžete převést.

Výstupy

Object

Tato rutina vrátí objekty, které získá. Typ je určen typem objektů v cestě.

Poznámky

Tato rutina nemá parametr Recurse, protože získá pouze položku, nikoli její obsah. Chcete-li získat obsah položky rekurzivně, použijte Get-ChildItem.

K procházení registru použijte tuto rutinu k získání klíčů registru a Get-ItemProperty k získání hodnot a dat registru. Hodnoty registru jsou považovány za vlastnosti klíče registru.

Tato rutina je navržená tak, aby fungovala s daty vystavenými jakýmkoli poskytovatelem. Pokud chcete zobrazit seznam poskytovatelů dostupných v relaci, zadejte Get-PsProvider. Další informace naleznete v tématu about_Providers.