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>]
   [<CommonParameters>]
Get-ItemProperty
   -LiteralPath <String[]>
   [[-Name] <String[]>]
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Credential <PSCredential>]
   [<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 v 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.

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

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

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

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 jednomu nebo více umístěním. 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.

Typ:String[]
Aliasy:PSPath, LP
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. Jsou povoleny zástupné znaky.

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

-Path

Určuje cestu k položce nebo položkách. Jsou povoleny zástupné znaky.

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

Vstupy

String

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

Výstupy

Boolean

String

DateTime

FileInfo

DirectoryInfo

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

PowerShell obsahuje následující aliasy pro Get-ItemProperty:

  • Všechny platformy:
    • 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.