Get-ItemProperty

Získá vlastnosti zadané položky.

Syntax

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. Pomocí této rutiny můžete například získat hodnotu 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í konkrétní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 podklíči CurrentVersion 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 byla k dispozici jednotka PowerShellu s názvem HKLM: , která je namapovaná na HKEY_LOCAL_MACHINE podregistr registru.

Jednotka s tímto názvem a mapováním je ve výchozím nastavení dostupná v PowerShellu. Alternativně lze 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ů a dat hodnot položek registru v klíči registru

Tento příkaz získá názvy hodnot a data položek registru v klíči PowerShellEngine registru. Výsledky jsou uvedeny 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 nepodporují žádné zprostředkovatele nainstalované s PowerShellem. Pokud chcete zosobnit jiného uživatele nebo zvýšit úroveň svých 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
Accept pipeline input:True
Accept wildcard characters:False

-Exclude

Určuje jako pole řetězců položku nebo položky, které tato rutina v operaci vylučuje. Hodnota tohoto parametru kvalifikuje parametr Path . Zadejte element nebo vzor cesty, například *.txt. Zástupné znaky jsou povoleny. 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
Accept pipeline input:False
Accept wildcard characters:True

-Filter

Určuje filtr pro kvalifikaci parametru Path . Zprostředkovatel fileSystem je jediným nainstalovaným zprostředkovatelem PowerShellu, který podporuje použití filtrů. Syntaxi jazyka filtru FileSystem najdete v about_Wildcards. Filtry jsou efektivnější než jiné parametry, protože je zprostředkovatel použije, když rutina získá objekty, místo aby objekty po načtení vyfiltroval PowerShell.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-Include

Určuje jako pole řetězců položku nebo položky, které tato rutina zahrnuje do operace. Hodnota tohoto parametru kvalifikuje parametr Path . Zadejte element nebo vzor cesty, například *.txt. Zástupné znaky jsou povoleny. Parametr Include 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
Accept pipeline input:False
Accept wildcard characters: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, že nemá interpretovat žádné znaky jako řídicí sekvence.

Další informace najdete v tématu about_Quoting_Rules.

Type:String[]
Aliases:PSPath, LP
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Name

Určuje název vlastnosti nebo vlastností, které se mají načíst. Zástupné znaky jsou povoleny.

Type:String[]
Aliases:PSProperty
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-Path

Určuje cestu k položce nebo položkám. Zástupné znaky jsou povoleny.

Type:String[]
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:True

Vstupy

String

Můžete vytvořit kanál pro řetězec, který obsahuje cestu k Get-ItemProperty.

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ý je načten. 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 je navržená Get-ItemProperty tak, aby fungovala s daty vystavenými libovolným zprostředkovatelem. Pokud chcete zobrazit seznam poskytovatelů dostupných v relaci, zadejte Get-PSProvider. Další informace najdete v tématu about_Providers.