Get-ItemProperty
Získá vlastnosti zadané položky.
Syntax
Get-ItemProperty
[-Path] <String[]>
[[-Name] <String[]>]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
Get-ItemProperty
-LiteralPath <String[]>
[[-Name] <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 C:\Test\Weather.xls
souboru. 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: 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 ProgramFilesDir
položky registru v CurrentVersion
podklíči registru. Cesta určuje podklíč a parametr Name určuje název hodnoty položky.
Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion -Name "ProgramFilesDir"
Poznámka:
Tento příkaz vyžaduje, aby se namapovala jednotka HKLM:
PowerShellu HKEY_LOCAL_MACHINE
na podregistr 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:
Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion
.
Příklad 4: 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 PowerShellEngine
klíči registru. 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
Parametry
-Credential
Poznámka:
Tento parametr nejsou podporovány žádnými poskytovateli nainstalovanými ve Windows PowerShellu. Pokud chcete zosobnit jiného uživatele nebo zvýšit úroveň přihlašovacích údajů při spuštění této rutiny, použijte Invoke-Command.
Type: | PSCredential |
Position: | Named |
Default value: | Current user |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 element nebo vzor cesty, například *.txt
. Jsou povoleny zástupné znaky. Parametr Exclude je účinný pouze v případě, že příkaz obsahuje obsah položky, například C:\Windows\*
, kde zástupný znak určuje obsah C:\Windows
adresáře.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Filter
Určuje filtr, který má kvalifikovat parametr 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-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 element nebo vzor cesty, 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 C:\Windows
adresáře.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-LiteralPath
Určuje cestu k aktuálnímu umístění vlastnosti. 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.
Type: | String[] |
Aliases: | PSPath |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Určuje název vlastnosti nebo vlastností, které se mají načíst.
Type: | String[] |
Aliases: | PSProperty |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Určuje cestu k položce nebo položkách.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Aliases: | usetx |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Vstupy
Řetězec, který obsahuje cestu k této rutině, můžete převést.
Výstupy
Tato rutina 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
Windows PowerShell obsahuje následující aliasy pro Get-ItemProperty
:
gp
Rutina Get-ItemProperty
je navržená tak, aby fungovala s daty vystavenými libovolným poskytovatelem. Pokud chcete zobrazit seznam poskytovatelů dostupných v relaci, zadejte Get-PSProvider
. Další informace najdete v tématu about_Providers.
Související odkazy
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro