Get-ItemProperty

  • Referens
Modul:
Microsoft.PowerShell.Management

Hämtar egenskaperna för ett angivet objekt.

Syntax

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

Cmdleten Get-ItemProperty hämtar egenskaperna för de angivna objekten. Du kan till exempel använda den här cmdleten för att hämta värdet för egenskapen LastAccessTime för ett filobjekt. Du kan också använda den här cmdleten för att visa registerposter och deras värden.

Exempel

Exempel 1: Hämta information om en specifik katalog

Det här kommandot hämtar information om C:\Windows katalogen.

Get-ItemProperty C:\Windows

Exempel 2: Hämta egenskaperna för en specifik fil

Det här kommandot hämtar filens C:\Test\Weather.xls egenskaper. Resultatet skickas till cmdleten Format-List för att visa utdata som en lista.

Get-ItemProperty C:\Test\Weather.xls | Format-List

Exempel 3: Hämta värdenamnet och data för en registerpost i en registerundernyckel

Det här kommandot hämtar värdenamnet och data för ProgramFilesDir registerposten i registerundernyckeln CurrentVersion . Sökvägen anger undernyckeln och parametern Namn anger värdenamnet för posten.

Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion -Name "ProgramFilesDir"

Kommentar

Det här kommandot kräver att det finns en PowerShell-enhet med namnet HKLM: som är mappad till HKEY_LOCAL_MACHINE registreringsdatafilen i registret.

En enhet med det namnet och mappningen är tillgänglig i PowerShell som standard. Alternativt kan sökvägen till den här registerundernyckeln anges med hjälp av följande alternativa sökväg som börjar med providernamnet följt av två kolon:

Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion.

Exempel 4: Hämta värdenamn och data för registerposter i en registernyckel

Det här kommandot hämtar värdenamnen och data för registerposterna i registernyckeln PowerShellEngine . Resultaten visas i följande exempelutdata.

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

Parametrar

-Credential

Kommentar

Den här parametern stöds inte av några leverantörer som är installerade med Windows PowerShell. Om du vill personifiera en annan användare eller höja dina autentiseringsuppgifter när du kör den här cmdleten använder du Invoke-Command.

Typ:PSCredential
Position:Named
Standardvärde:Current user
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Exclude

Anger, som en strängmatris, ett objekt eller objekt som den här cmdleten exkluderar i åtgärden. Värdet för den här parametern kvalificerar parametern Path . Ange ett sökvägselement eller mönster, till exempel *.txt. Jokertecken tillåts. Parametern Exkludera gäller endast när kommandot innehåller innehållet i ett objekt, till exempel C:\Windows\*, där jokertecknet anger innehållet i C:\Windows katalogen.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:True

-Filter

Anger ett filter för att kvalificera parametern Sökväg . FileSystem-providern är den enda installerade PowerShell-providern som stöder användning av filter. Du hittar syntaxen för filterspråket FileSystem i about_Wildcards. Filter är effektivare än andra parametrar eftersom providern tillämpar dem när cmdleten hämtar objekten i stället för att Låta PowerShell filtrera objekten när de har hämtats.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:True

-Include

Anger, som en strängmatris, ett objekt eller objekt som den här cmdleten innehåller i åtgärden. Värdet för den här parametern kvalificerar parametern Path . Ange ett sökvägselement eller mönster, till exempel *.txt. Jokertecken tillåts. Parametern Include är endast effektiv när kommandot innehåller innehållet i ett objekt, till exempel C:\Windows\*, där jokertecknet anger innehållet i C:\Windows katalogen.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:True

-LiteralPath

Anger sökvägen till den aktuella platsen för egenskapen. Värdet för LiteralPath används exakt som det skrivs. Inga tecken tolkas som jokertecken. Om sökvägen innehåller escape-tecken omger du den med enkla citattecken ('). Enkla citattecken gör att PowerShell inte tolkar några tecken som escape-sekvenser.

Mer information finns i about_Quoting_Rules.

Typ:String[]
Alias:PSPath
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Name

Anger namnet på den egenskap eller de egenskaper som ska hämtas.

Typ:String[]
Alias:PSProperty
Position:1
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Path

Anger sökvägen till objektet eller objekten.

Typ:String[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-UseTransaction

Innehåller kommandot i den aktiva transaktionen. Den här parametern är endast giltig när en transaktion pågår. Mer information finns i about_Transactions.

Typ:SwitchParameter
Alias:usetx
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

String

Du kan skicka en sträng som innehåller en sökväg till den här cmdleten.

Utdata

Boolean

String

DateTime

FileInfo

DirectoryInfo

Den här cmdleten returnerar ett objekt för varje objektegenskap som den får. Objekttypen beror på vilket objekt som hämtas. I en filsystemenhet kan den till exempel returnera en fil eller mapp.

Kommentarer

Windows PowerShell innehåller följande alias för Get-ItemProperty:

  • gp

Cmdleten Get-ItemProperty är utformad för att fungera med data som exponeras av alla leverantörer. Om du vill visa en lista över tillgängliga leverantörer i sessionen skriver du Get-PSProvider. Mer information finns i about_Providers.