Dela via


about_Properties

Kort beskrivning

Beskriver hur du använder objektegenskaper i PowerShell.

Lång beskrivning

PowerShell använder strukturerade samlingar med information som kallas objekt för att representera objekten i datalager eller datorns tillstånd. Vanligtvis arbetar du med objekt som ingår i Microsoft .NET Framework, men du kan också skapa anpassade objekt i PowerShell.

Associationen mellan ett objekt och dess objekt är mycket nära. När du ändrar ett objekt ändrar du vanligtvis det objekt som det representerar. När du till exempel hämtar en fil i PowerShell får du inte den faktiska filen. I stället får du ett FileInfo-objekt som representerar filen. När du ändrar FileInfo-objektet ändras även filen.

De flesta objekt har egenskaper. Egenskaper är de data som är associerade med ett objekt. Olika typer av objekt har olika egenskaper. Till exempel har ett FileInfo-objekt, som representerar en fil, en IsReadOnly-egenskap som innehåller $True om filen har det skrivskyddade attributet och $False om det inte gör det. Ett DirectoryInfo-objekt , som representerar en filsystemkatalog, har en överordnad egenskap som innehåller sökvägen till den överordnade katalogen.

Objektegenskaper

Om du vill hämta egenskaperna för ett objekt använder du cmdleten Get-Member . Om du till exempel vill hämta egenskaperna för ett FileInfo-objekt använder du cmdleten Get-ChildItem för att hämta FileInfo-objektet som representerar en fil. Använd sedan en pipelineoperator (|) för att skicka FileInfo-objektet till Get-Member. Följande kommando hämtar pwsh.exe filen och skickar den till Get-Member. Den $PSHOME automatiska variabeln innehåller sökvägen till PowerShell-installationskatalogen.

Get-ChildItem $PSHOME\pwsh.exe | Get-Member

Utdata från kommandot visar medlemmarna i FileInfo-objektet . Medlemmar innehåller både egenskaper och metoder. När du arbetar i PowerShell har du åtkomst till alla objektmedlemmar.

Om du bara vill hämta egenskaperna för ett objekt och inte metoderna använder du parametern MemberType för cmdleten Get-Member med värdet Property, enligt följande exempel.

Get-ChildItem $PSHOME\pwsh.exe | Get-Member -MemberType Property
TypeName: System.IO.FileInfo

Name              MemberType Definition
----              ---------- ----------
Attributes        Property   System.IO.FileAttributes Attributes {get;set;}
CreationTime      Property   System.DateTime CreationTime {get;set;}
CreationTimeUtc   Property   System.DateTime CreationTimeUtc {get;set;}
Directory         Property   System.IO.DirectoryInfo Directory {get;}
DirectoryName     Property   System.String DirectoryName {get;}
Exists            Property   System.Boolean Exists {get;}
Extension         Property   System.String Extension {get;}
FullName          Property   System.String FullName {get;}
IsReadOnly        Property   System.Boolean IsReadOnly {get;set;}
LastAccessTime    Property   System.DateTime LastAccessTime {get;set;}
LastAccessTimeUtc Property   System.DateTime LastAccessTimeUtc {get;set;}
LastWriteTime     Property   System.DateTime LastWriteTime {get;set;}
LastWriteTimeUtc  Property   System.DateTime LastWriteTimeUtc {get;set;}
Length            Property   System.Int64 Length {get;}
Name              Property   System.String Name {get;}

När du har hittat egenskaperna kan du använda dem i dina PowerShell-kommandon.

Egenskapsvärden

Även om varje objekt av en viss typ har samma egenskaper, beskriver värdena för dessa egenskaper det specifika objektet. Till exempel har varje FileInfo-objekt en CreationTime-egenskap , men värdet för den egenskapen skiljer sig åt för varje fil.

Det vanligaste sättet att hämta värdena för egenskaperna för ett objekt är att använda medlemsåtkomstoperatorn (.). Skriv en referens till objektet, till exempel en variabel som innehåller objektet, eller ett kommando som hämtar objektet. Skriv sedan operatorn (.) följt av egenskapsnamnet.

Följande kommando visar till exempel värdet för egenskapen CreationTime för pwsh.exe filen. Kommandot Get-ChildItem returnerar ett FileInfo-objekt som representerar pwsh.exe file. Kommandot omges av parenteser för att se till att det körs innan några egenskaper används.

(Get-ChildItem $PSHOME\pwsh.exe).CreationTime
Tuesday, June 14, 2022 5:17:14 PM

Du kan också spara ett objekt i en variabel och sedan hämta dess egenskaper med hjälp av metoden medlemsåtkomst (.), som du ser i följande exempel:

$a = Get-ChildItem $PSHOME\pwsh.exe
$a.CreationTime
Tuesday, June 14, 2022 5:17:14 PM

Du kan också använda Select-Object cmdletarna och Format-List för att visa egenskapsvärdena för ett objekt. Select-Object och var och Format-List en har en egenskapsparameter . Du kan använda egenskapsparametern för att ange en eller flera egenskaper och deras värden. Du kan också använda jokertecknet (*) för att representera alla egenskaper.

Följande kommando visar till exempel värdena för alla egenskaper för filen pwsh.exe.

Get-ChildItem $PSHOME\pwsh.exe | Format-List -Property *
PSPath              : Microsoft.PowerShell.Core\FileSystem::C:\Program Files\PowerShell\7-preview\pwsh.exe
PSParentPath        : Microsoft.PowerShell.Core\FileSystem::C:\Program Files\PowerShell\7-preview
PSChildName         : pwsh.exe
PSDrive             : C
PSProvider          : Microsoft.PowerShell.Core\FileSystem
PSIsContainer       : False
Mode                : -a---
ModeWithoutHardLink : -a---
VersionInfo         : File:             C:\Program Files\PowerShell\7-preview\pwsh.exe
                      InternalName:     pwsh.dll
                      OriginalFilename: pwsh.dll
                      FileVersion:      7.3.0.5
                      FileDescription:  pwsh
                      Product:          PowerShell
                      ProductVersion:   7.3.0-preview.5 SHA: cfc237ac85cf24fa760923ace568201c8f3256aa
                      Debug:            False
                      Patched:          False
                      PreRelease:       False
                      PrivateBuild:     False
                      SpecialBuild:     False
                      Language:         Language Neutral

BaseName            : pwsh
ResolvedTarget      : C:\Program Files\PowerShell\7-preview\pwsh.exe
Target              :
LinkType            :
Length              : 285088
DirectoryName       : C:\Program Files\PowerShell\7-preview
Directory           : C:\Program Files\PowerShell\7-preview
IsReadOnly          : False
FullName            : C:\Program Files\PowerShell\7-preview\pwsh.exe
Extension           : .exe
Name                : pwsh.exe
Exists              : True
CreationTime        : 6/14/2022 5:17:14 PM
CreationTimeUtc     : 6/14/2022 10:17:14 PM
LastAccessTime      : 7/18/2022 11:32:06 AM
LastAccessTimeUtc   : 7/18/2022 4:32:06 PM
LastWriteTime       : 6/14/2022 5:17:14 PM
LastWriteTimeUtc    : 6/14/2022 10:17:14 PM
LinkTarget          :
Attributes          : Archive

Statiska egenskaper

Du kan använda statiska egenskaper för .NET-klasser i PowerShell. Statiska egenskaper är egenskaper för klassen, till skillnad från standardegenskaper, som är egenskaper för ett objekt.

Om du vill hämta statiska egenskaper för en klass använder du parametern Static för cmdleten Get-Member . Följande kommando hämtar till exempel klassens System.DateTime statiska egenskaper.

Get-Date | Get-Member -MemberType Property -Static
TypeName: System.DateTime

Name     MemberType Definition
----     ---------- ----------
MaxValue Property   static datetime MaxValue {get;}
MinValue Property   static datetime MinValue {get;}
Now      Property   datetime Now {get;}
Today    Property   datetime Today {get;}
UtcNow   Property   datetime UtcNow {get;}

Använd följande syntax för att hämta värdet för en statisk egenskap.

[<ClassName>]::<Property>

Följande kommando hämtar till exempel värdet för den statiska utcNow-egenskapen för System.DateTime klassen.

[System.DateTime]::UtcNow

Uppräkning av medlemsåtkomst

Från och med PowerShell 3.0, när du använder operatorn för medlemsåtkomst (.) för att komma åt en egenskap som inte finns i en listsamling, räknar PowerShell automatiskt upp objekten i samlingen och returnerar värdet för egenskapen för varje objekt. Mer information finns i about_Member-Access_Enumeration.

Exempel

Det här kommandot returnerar värdet för egenskapen DisplayName för varje tjänst som Get-Service returneras.

(Get-Service).DisplayName
Application Experience
Application Layer Gateway Service
Windows All-User Install Agent
Application Identity
Application Information
...

Alla samlingar har egenskapen Count som returnerar antalet objekt i samlingen.

(Get-Service).Count
176

Från och med PowerShell 3.0 kan du hämta egenskapen Antal eller Längd för singleton-objekt som inte är samlingar.

(Get-Service Audiosrv).Count
1

Vissa objekt har dock egenskapen Längd . Till exempel är längdenen sträng antalet tecken i strängen. Egenskapen Count är antalet instanser av objektet.

PS> $str = 'string'
PS> $str.Length
6
PS> $str.Count
1

Om det finns en egenskap för de enskilda objekten och i samlingen returneras endast samlingens egenskap.

$collection = @(
    [pscustomobject]@{length = "foo"}
    [pscustomobject]@{length = "bar"}
)
# PowerShell returns the collection's Length.
$collection.length
2

Se även