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>]
   [<CommonParameters>]
Get-ItemProperty
   -LiteralPath <String[]>
   [[-Name] <String[]>]
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Credential <PSCredential>]
   [<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 katalogen C:\Windows.

Get-ItemProperty C:\Windows

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

Det här kommandot hämtar egenskaperna för filen C:\Test\Weather.xls. 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 CurrentVersion registerundernyckel. Path anger undernyckeln och parametern Name anger värdet för posten.

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

Not

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

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

Not

Den här parametern stöds inte av några leverantörer som är installerade med 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 Exclude gäller endast när kommandot innehåller innehållet i ett objekt, till exempel C:\Windows\*, där jokertecknet anger innehållet i katalogen C:\Windows.

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 Path. FileSystem-providern är den enda installerade PowerShell-providern som stöder användning av filter. Du hittar syntaxen för FileSystem filterspråk 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 gäller endast när kommandot innehåller innehållet i ett objekt, till exempel C:\Windows\*, där jokertecknet anger innehållet i katalogen C:\Windows.

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

-LiteralPath

Anger en sökväg till en eller flera platser. 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, LP
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. Jokertecken tillåts.

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

-Path

Anger sökvägen till objektet eller objekten. Jokertecken tillåts.

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

Indata

String

Du kan skicka en sträng som innehåller en sökväg till Get-ItemProperty.

Utdata

System.Boolean, System.String, System.DateTime

Get-ItemProperty 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

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.