Get-ItemProperty
Získá vlastnosti zadané položky.
Syntax
Path (Výchozí)
Get-ItemProperty
[-Path] <String[]>
[[-Name] <String[]>]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
LiteralPath
Get-ItemProperty
[[-Name] <String[]>]
-LiteralPath <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
Description
Rutina Get-ItemProperty získá vlastnosti zadaných položek.
Tuto rutinu můžete například použít k získání hodnoty vlastnosti LastAccessTime objektu souboru.
Tuto rutinu můžete použít také k zobrazení položek registru a jejich hodnot.
Příklady
Příklad 1: Získání informací o konkrétním adresáři
Tento příkaz získá informace o adresáři C:\Windows.
Get-ItemProperty C:\Windows
Příklad 2: Získání vlastností určitého souboru
Tento příkaz získá vlastnosti souboruC:\Test\Weather.xls.
Výsledek se předá rutině Format-List, aby se výstup zobrazil jako seznam.
Get-ItemProperty C:\Test\Weather.xls | Format-List
Příklad 3: Zobrazení názvu hodnoty a dat položek registru v podklíči registru
Tento příkaz zobrazí název hodnoty a data každé položky registru obsažené v podklíči registru CurrentVersion.
Všimněte si, že příkaz vyžaduje, aby byla jednotka PowerShellu s názvem HKLM:, která je namapovaná na podregistr "HKEY_LOCAL_MACHINE" registru.
Jednotka s tímto názvem a mapováním je ve výchozím nastavení dostupná v PowerShellu.
Případně můžete cestu k tomuto podklíči registru zadat pomocí následující alternativní cesty, která začíná názvem zprostředkovatele následovaným dvěma dvojtečkami:
"Registr::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion".
Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion
Příklad 4: Získání názvu hodnoty a dat položky registru v podklíči registru
Tento příkaz získá název hodnoty a data položky registru ProgramFilesDir v podklíči registru CurrentVersion. Příkaz používá parametr Path k zadání podklíče a parametru Name k zadání názvu hodnoty položky.
Příkaz používá zpětné zvýrazňující znak ('), znak pokračování PowerShellu, aby příkaz pokračoval na druhém řádku.
Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion -Name "ProgramFilesDir"
Příklad 5: Získání názvů hodnot a dat položek registru v klíči registru
Tento příkaz získá názvy hodnot a data položek registru v klíči registru PowerShellEngine. Výsledky se zobrazí v následujícím ukázkovém výstupu.
Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\PowerShell\1\PowerShellEngine
ApplicationBase : C:\Windows\system32\WindowsPowerShell\v1.0\
ConsoleHostAssemblyName : Microsoft.PowerShell.ConsoleHost, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, ProcessorArchitecture=msil
PowerShellVersion : 2.0
RuntimeVersion : v2.0.50727
CTPVersion : 5
PSCompatibleVersion : 1.0,2.0
Příklad 6: Získání, formátování a zobrazení výsledků hodnot registru a dat
Tento příklad ukazuje, jak formátovat výstup příkazu Get-ItemProperty v seznamu, aby bylo možné snadno zobrazit hodnoty a data registru a usnadnit tak interpretaci výsledků.
První příkaz použije rutinu Get-ItemProperty k získání položek registru v podklíči Microsoft.PowerShellu.
Tento podklíč ukládá možnosti výchozího prostředí pro PowerShell.
Výsledky se zobrazí v následujícím ukázkovém výstupu.
Výstup ukazuje, že existují dvě položky registru, "Path" a "ExecutionPolicy". Pokud klíč registru obsahuje méně než pět položek, ve výchozím nastavení se zobrazí v tabulce, ale často je jednodušší zobrazit v seznamu.
Druhý příkaz používá stejný příkaz Get-ItemProperty.
Tentokrát ale příkaz použije operátor kanálu (|) k odeslání výsledků příkazu do rutiny Format-List.
Příkaz Format-List používá parametr Property s hodnotou *(vše) k zobrazení všech vlastností objektů v seznamu.
Výsledky se zobrazí v následujícím ukázkovém výstupu.
Výsledný displej zobrazuje položky registru Path a ExecutionPolicy spolu s několika méně známými vlastnostmi objektu klíče registru. Další vlastnosti s předponou PS jsou vlastnosti vlastních objektů PowerShellu, jako jsou například objekty, které představují klíče registru.
Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell
Path ExecutionPolicy
---- ---------------
C:\Windows\system32\WindowsPowerShell\v1.0\powershell.exe RemoteSigned
Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell | Format-List -Property *
PSPath : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\Software\Microsoft\PowerShell\1\ShellIds\Micro
soft.PowerShell
PSParentPath : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\Software\Microsoft\PowerShell\1\ShellIds
PSChildName : Microsoft.PowerShell
PSDrive : HKLM
PSProvider : Microsoft.PowerShell.Core\Registry
Path : C:\Windows\system32\WindowsPowerShell\v1.0\powershell.exe
ExecutionPolicy : RemoteSigned
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é tato rutina z operace vylučuje. Hodnota tohoto parametru kvalifikuje parametr Path. Zadejte prvek cesty nebo vzor, například "*.txt". Jsou povoleny zástupné znaky.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| 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 |
-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 |
-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.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| 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 |
-LiteralPath
Určuje cestu k aktuálnímu umístění vlastnosti. 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 |
-Name
Určuje název vlastnosti nebo vlastností, které se mají načíst.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | PSProperty |
Sady parametrů
(All)
| Position: | 1 |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Path
Určuje cestu k položce nebo položkách.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| 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 |
-UseTransaction
Zahrnuje příkaz v aktivní transakci. Tento parametr je platný pouze v případě, že probíhá transakce. Další informace naleznete v tématu Zahrnutí příkazu do aktivní transakce. 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 k Get-ItemProperty, můžete pipetovat .
Výstupy
System.Boolean, System.String, System.DateTime
Get-ItemProperty vrátí objekt pro každou vlastnost položky, kterou získá.
Typ objektu závisí na objektu, který se načte.
Například na jednotce systému souborů může vrátit soubor nebo složku.
Poznámky
Rutina Get-ItemProperty je navržená tak, aby fungovala s daty vystavenými jakýmkoli poskytovatelem. Pokud chcete zobrazit seznam poskytovatelů dostupných ve vaší relaci, zadejte "Get-PSProvider". Další informace najdete v tématu about_Providers.