Dela via

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 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: Visa värdenamnet och data för registerposter i en registerundernyckel

Det här kommandot visar värdenamnet och data för var och en av registerposterna i registerundernyckeln "CurrentVersion". Observera att kommandot kräver att det finns en PowerShell-enhet med namnet HKLM: som mappas till registreringsdatafilen "HKEY_LOCAL_MACHINE". 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:

"Register::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion".

Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion

Exempel 4: 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 registerposten "ProgramFilesDir" i registerundernyckeln "CurrentVersion". Kommandot använder parametern Path för att ange undernyckeln och parametern Namn för att ange värdenamnet för posten.

Kommandot använder en fästing eller grav accent ('), PowerShell-fortsättningstecknet, för att fortsätta kommandot på den andra raden.

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

Exempel 5: 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

Exempel 6: Hämta, formatera och visa resultatet av registervärden och data

Det här exemplet visar hur du formaterar utdata från ett Get-ItemProperty-kommando i en lista för att göra det enkelt att se registervärdena och data och göra det enkelt att tolka resultaten.

Det första kommandot använder cmdleten Get-ItemProperty för att hämta registerposterna i undernyckeln Microsoft.PowerShell. Den här undernyckeln lagrar alternativ för standardgränssnittet för PowerShell. Resultaten visas i följande exempelutdata.

Utdata visar att det finns två registerposter, "Path" och "ExecutionPolicy". När en registernyckel innehåller färre än fem poster visas den som standard i en tabell, men det är ofta lättare att visa i en lista.

Det andra kommandot använder samma Get-ItemProperty kommando. Men den här gången använder kommandot en pipelineoperator (|) för att skicka resultatet av kommandot till cmdleten Format-List. Kommandot Format-List använder parametern Egenskap med värdet *( alla) för att visa alla egenskaper för objekten i en lista. Resultaten visas i följande exempelutdata.

Den resulterande visningen visar registerposterna "Path" och "ExecutionPolicy", tillsammans med flera mindre bekanta egenskaper för registernyckelobjektet. De andra egenskaperna, som är prefix med PS, är egenskaper för anpassade PowerShell-objekt, till exempel de objekt som representerar registernycklarna.

Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell

Path                                                        ExecutionPolicy
----                                                        ---------------
C:\Windows\system32\WindowsPowerShell\v1.0\powershell.exe   RemoteSigned

Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell | Format-List -Property *

PSPath          : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\Software\Microsoft\PowerShell\1\ShellIds\Micro
soft.PowerShell
PSParentPath    : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\Software\Microsoft\PowerShell\1\ShellIds
PSChildName     : Microsoft.PowerShell
PSDrive         : HKLM
PSProvider      : Microsoft.PowerShell.Core\Registry
Path            : C:\Windows\system32\WindowsPowerShell\v1.0\powershell.exe
ExecutionPolicy : RemoteSigned

Parametrar

-Credential

Anger ett användarkonto som har behörighet att utföra den här åtgärden. Standardvärdet är den aktuella användaren.

Ange ett användarnamn, till exempel "User01" eller "Domain01\User01", eller ange ett PSCredential- objekt, till exempel ett som genereras av Get-Credential cmdlet. Om du skriver ett användarnamn uppmanas du att ange ett lösenord.

Varning

Den här parametern stöds inte av några leverantörer som är installerade med Windows PowerShell.

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 denna cmdlet exkluderar från å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.

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

-Filter

Anger ett filter i providerns format eller språk. Värdet för den här parametern kvalificerar parametern Path.

Syntaxen för filtret, inklusive användningen av jokertecken, beror på providern. 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.

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

-LiteralPath

Anger sökvägen till den aktuella platsen för egenskapen. Till skillnad från parametern Path används värdet för LiteralPath precis 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.

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