Sdílet prostřednictvím

Get-ItemPropertyValue

  • Reference
Modul:
Microsoft.PowerShell.Management

Získá hodnotu pro jednu nebo více vlastností zadané položky.

Syntaxe

Get-ItemPropertyValue
   [[-Path] <String[]>]
   [-Name] <String[]>
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-ItemPropertyValue
   -LiteralPath <String[]>
   [-Name] <String[]>
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Description

Get-ItemPropertyValue získá aktuální hodnotu vlastnosti, kterou zadáte při použití parametru Name, který se nachází v cestě, kterou zadáte pomocí parametrů Path nebo LiteralPath.

Příklady

Příklad 1: Získání hodnoty vlastnosti ProductID

Tento příkaz získá hodnotu vlastnosti ProductID objektu \SOFTWARE\Microsoft\Windows NT\CurrentVersion ve zprostředkovateli registru systému Windows.

Get-ItemPropertyValue 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion' -Name ProductID

94253-50000-11141-AA785

Příklad 2: Získání času posledního zápisu souboru nebo složky

Tento příkaz získá hodnotu vlastnosti LastWriteTime, tedy čas poslední změny souboru nebo složky, ze složky C:\Program Files\PowerShell, přičemž pracuje ve zprostředkovateli souborového systému (FileSystem).

Get-ItemPropertyValue -Path 'C:\Program Files\PowerShell' -Name LastWriteTime

Wednesday, September 3, 2014 2:53:22 PM

Příklad 3: Získání více hodnot vlastností souboru nebo složky

Tento příkaz získá hodnoty LastWriteTime, CreationTimea Root vlastnosti složky. Hodnoty vlastností se vrátí v pořadí, ve kterém jste zadali názvy vlastností.

Get-ItemPropertyValue -Path 'C:\Program Files\PowerShell' -Name LastWriteTime, CreationTime, Root

Tuesday, March 23, 2021 6:53:13 AM
Monday, August 14, 2017 1:42:40 PM

Parent              :
Root                : C:\
FullName            : C:\
Extension           :
Name                : C:\
Exists              : True
CreationTime        : 10/30/2015 1:28:30 AM
CreationTimeUtc     : 10/30/2015 6:28:30 AM
LastAccessTime      : 5/26/2021 9:22:24 AM
LastAccessTimeUtc   : 5/26/2021 2:22:24 PM
LastWriteTime       : 5/25/2021 7:25:08 AM
LastWriteTimeUtc    : 5/25/2021 12:25:08 PM
Attributes          : Hidden, System, Directory
Mode                : d--hs
ModeWithoutHardLink : d--hs
BaseName            : C:\
Target              :
LinkType            :

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 oprávnění při spuštění této rutiny, použijte Invoke-Command.

Typ:PSCredential
Position:Named
Default value:None
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é tento cmdlet vylučuje v operaci. Hodnota tohoto parametru kvalifikuje parametr Path. Zadejte prvek cesty nebo vzor, například *.txt. Jsou povoleny zástupné znaky. Parametr Exclude je efektivní pouze v případě, že příkaz obsahuje obsah položky, například C:\Windows\*, kde zástupný znak určuje obsah adresáře C:\Windows.

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 pro kvalifikaci parametru 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 položku nebo položky, které tento cmdlet zahrnuje v operaci, jako pole řetězců. Hodnota tohoto parametru kvalifikuje parametr Path. Zadejte prvek cesty nebo vzor, 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 adresáře C:\Windows.

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 escape sekvence, uzavřete ji do jednoduchých uvozovek. Jednoduché uvozovky signalizují PowerShellu, aby neinterpretuje žádné znaky jako escape 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.

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

-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:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:True

Vstupy

String

Můžete přeposlat řetězec, který obsahuje cestu, tomuto cmdletu.

Výstupy

PSObject

Tato příkazová rutina vrací objekt pro každou hodnotu vlastnosti položky, kterou obdrží. Typ objektu závisí na hodnotě vlastnosti, která se načte.

Poznámky

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

  • Všechny platformy:
    • gpv

Tato rutina je navržená tak, aby fungovala s daty vystavenými jakýmkoli poskytovatelem. Pokud chcete zobrazit seznam poskytovatelů dostupných ve vaší relaci, spusťte rutinu Get-PSProvider. Další informace naleznete v tématu about_Providers.