Get-ItemPropertyValue

  • Reference
Modul:
Microsoft.PowerShell.Management

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

Syntax

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

Description

Získá Get-ItemPropertyValue aktuální hodnotu vlastnosti, kterou zadáte při použití parametru Name , umístěné 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 ProductID vlastnost objektu \SOFTWARE\Microsoft\WindowsNT\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 nebo při poslední změně souboru nebo složky ze C:\Program Files\WindowsPowerShell složky, která pracuje v zprostředkovateli FileSystem.

Get-ItemPropertyValue -Path 'C:\Program Files\WindowsPowerShell' -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, CreationTime a 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\WindowsPowerShell' -Name LastWriteTime,CreationTime,Root

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

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

Parametry

-Credential

Určuje uživatelský účet, který má oprávnění k provedení této akce. Ve výchozím nastavení je to aktuální uživatel.

Zadejte uživatelské jméno, například User01 nebo Domain01\User01, nebo zadejte objekt PSCredential , například objekt vygenerovaný rutinou Get-Credential . Pokud zadáte uživatelské jméno, zobrazí se výzva k zadání hesla.

Upozorňující

Tento parametr nejsou podporovány žádnými poskytovateli nainstalovanými ve Windows PowerShellu.

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

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

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

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 prvek cesty nebo vzor, například "*.txt". Jsou povoleny zástupné znaky.

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

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:True
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:False
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

String

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

Výstupy

PSObject

Tato rutina vrátí objekt pro každou hodnotu vlastnosti položky, kterou získá. Typ objektu závisí na hodnotě vlastnosti, která se načte.

Poznámky

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

  • gpv

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