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

Type:PSCredential
Position:Named
Default value:Current user
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-Name

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

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

-Path

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

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

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

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

  • Alla plattformar:
    • 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.