Get-Item
Získá položku v zadaném umístění.
Syntax
Path (Výchozí)
Get-Item
[-Path] <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-UseTransaction]
[-Stream <String[]>]
[<CommonParameters>]
LiteralPath
Get-Item
-LiteralPath <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-UseTransaction]
[-Stream <String[]>]
[<CommonParameters>]
Description
Cmdlet Get-Item získá položku na 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.
Výstraha
Tento parametr nejsou podporovány žádnými poskytovateli nainstalovanými ve Windows PowerShellu.
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 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.
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 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.
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 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. Pro více informací viz about_Providers. I při použití parametru Force nemůže rutina přepsat omezení zabezpečení.
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 položce. Na rozdíl od parametru Path se hodnota LiteralPath 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.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | PSPath |
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 položce. Tento cmdlet získá položku na zadaném umístění. Jsou povoleny zástupné symboly. 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í.
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 |
-Stream
Získá zadaný alternativní soubor NTFS stream ze souboru. Zadejte název datového proudu. Zástupné znaky jsou podporovány. 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ů.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | No alternate file streams |
| 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 |
-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.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | usetx |
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
Řetězec, který obsahuje cestu, můžete předat tomuto cmdletu.
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.
Pro procházení registru použijte tento příkaz cmdlet 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.
Chcete-li zobrazit seznam poskytovatelů dostupných ve vaší relaci, napište Get-PsProvider.
Pro více informací viz about_Providers.