Sdílet prostřednictvím

Get-ItemProperty

  • Reference
Modul:
Microsoft.PowerShell.Management

Získá vlastnosti zadané položky.

Syntaxe

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

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 z operace vylučuje. Hodnota tohoto parametru kvalifikuje parametr Path. Zadejte prvek cesty nebo vzor, například "*.txt". Jsou povoleny zástupné znaky.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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 prvek cesty nebo vzor, například "*.txt". Jsou povoleny zástupné znaky.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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é 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

-Name

Určuje název vlastnosti nebo vlastností, které se mají načíst.

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

-Path

Určuje cestu k položce nebo položkách.

Typ:String[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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.

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