Udostępnij za pośrednictwem

about_Properties

Krótki opis

Opisuje sposób używania właściwości obiektu w programie PowerShell.

Długi opis

Program PowerShell używa strukturalnych kolekcji informacji nazywanych obiektami do reprezentowania elementów w magazynach danych lub stanu komputera. Zazwyczaj pracujesz z obiektami, które są częścią programu Microsoft .NET Framework, ale można również tworzyć obiekty niestandardowe w programie PowerShell.

Skojarzenie między elementem a jego obiektem jest bardzo bliskie. Podczas zmiany obiektu zwykle zmienia się element, który reprezentuje. Na przykład po pobraniu pliku w programie PowerShell nie uzyskasz rzeczywistego pliku. Zamiast tego uzyskasz obiekt FileInfo reprezentujący plik. Zmiana obiektu FileInfo spowoduje również zmianę pliku.

Większość obiektów ma właściwości. Właściwości to dane skojarzone z obiektem. Różne typy obiektów mają różne właściwości. Na przykład obiekt FileInfo, który reprezentuje plik, ma właściwość IsReadOnly zawierającą $true, jeśli plik ma atrybut tylko do odczytu i $false, jeśli nie. Obiekt DirectoryInfo reprezentujący katalog systemu plików ma właściwość nadrzędną zawierającą ścieżkę do katalogu nadrzędnego.

Właściwości obiektu

Aby uzyskać właściwości obiektu, użyj polecenia cmdlet Get-Member. Aby na przykład uzyskać właściwości obiektu FileInfo, użyj polecenia cmdlet Get-ChildItem, aby uzyskać obiekt FileInfo reprezentujący plik. Następnie użyj operatora potoku (|), aby wysłać obiekt FileInfo do Get-Member. Następujące polecenie pobiera plik pwsh.exe i wysyła go do Get-Member. Zmienna automatyczna $PSHOME zawiera ścieżkę katalogu instalacyjnego programu PowerShell.

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

Dane wyjściowe polecenia zawierają listę elementów członkowskich obiektu FileInfo. Elementy członkowskie obejmują zarówno właściwości, jak i metody. Podczas pracy w programie PowerShell masz dostęp do wszystkich elementów członkowskich obiektów.

Aby uzyskać tylko właściwości obiektu, a nie metody, użyj parametru MemberType polecenia cmdlet Get-Member z wartością Property, jak pokazano w poniższym przykładzie.

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;}

Po znalezieniu właściwości można ich używać w poleceniach programu PowerShell.

Wartości właściwości

Mimo że każdy obiekt określonego typu ma te same właściwości, wartości tych właściwości opisują określony obiekt. Na przykład każdy obiekt FileInfo ma właściwość CreationTime, ale wartość tej właściwości różni się dla każdego pliku.

Najczęstszym sposobem uzyskania wartości właściwości obiektu jest użycie operatora dostępu do elementu członkowskiego (.). Wpisz odwołanie do obiektu, takie jak zmienna zawierająca obiekt lub polecenie, które pobiera obiekt. Następnie wpisz operator (.), a następnie nazwę właściwości.

Na przykład następujące polecenie wyświetla wartość właściwości CreationTime pliku pwsh.exe. Polecenie Get-ChildItem zwraca obiekt FileInfo reprezentujący pwsh.exe file. Polecenie jest ujęte w nawiasy, aby upewnić się, że jest wykonywane przed uzyskaniem dostępu do jakichkolwiek właściwości.

(Get-ChildItem $PSHOME\pwsh.exe).CreationTime

Tuesday, June 14, 2022 5:17:14 PM

Możesz również zapisać obiekt w zmiennej, a następnie pobrać jego właściwości przy użyciu metody dostępu do elementu członkowskiego (.), jak pokazano w poniższym przykładzie:

$a = Get-ChildItem $PSHOME\pwsh.exe
$a.CreationTime

Wednesday, November 13, 2024 10:12:26 PM

Możesz również użyć poleceń cmdlet Select-Object i Format-List, aby wyświetlić wartości właściwości obiektu. Select-Object i Format-List każdy ma parametr właściwości . Możesz użyć parametru właściwości, aby określić co najmniej jedną właściwość i ich wartości. Możesz też użyć symbolu wieloznakowego (*), aby reprezentować wszystkie właściwości.

Na przykład następujące polecenie wyświetla wartości wszystkich właściwości pliku 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.5.0.101
                      FileDescription:  PowerShell 7
                      Product:          PowerShell
                      ProductVersion:   7.5.0-rc.1 SHA: c0142dde17137e436e302b3c4e93e2d6dc50c5c4+c0142dde17137e436e302b3c4e93e2d6dc50c5c4
                      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            :
Name                : pwsh.exe
Length              : 284704
DirectoryName       : C:\Program Files\PowerShell\7-preview
Directory           : C:\Program Files\PowerShell\7-preview
IsReadOnly          : False
Exists              : True
FullName            : C:\Program Files\PowerShell\7-preview\pwsh.exe
Extension           : .exe
CreationTime        : 11/13/2024 10:12:26 PM
CreationTimeUtc     : 11/14/2024 4:12:26 AM
LastAccessTime      : 1/3/2025 1:38:13 PM
LastAccessTimeUtc   : 1/3/2025 7:38:13 PM
LastWriteTime       : 11/13/2024 10:12:26 PM
LastWriteTimeUtc    : 11/14/2024 4:12:26 AM
LinkTarget          :
UnixFileMode        : -1
Attributes          : Archive

Właściwości statyczne

Właściwości statycznych klas platformy .NET można używać w programie PowerShell. Właściwości statyczne to właściwości klasy, w przeciwieństwie do właściwości standardowych, które są właściwościami obiektu.

Aby uzyskać właściwości statyczne klasy, użyj parametru Static polecenia cmdlet Get-Member. Na przykład następujące polecenie pobiera właściwości statyczne klasy System.DateTime.

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;}

Aby uzyskać wartość właściwości statycznej, użyj następującej składni.

[<ClassName>]::<Property>

Na przykład następujące polecenie pobiera wartość właściwości statycznej UtcNow klasy System.DateTime.

[System.DateTime]::UtcNow

Wyliczenie dostępu do składowych

Począwszy od programu PowerShell 3.0, gdy używasz operatora dostępu do składowej (.) w celu uzyskania dostępu do właściwości, która nie istnieje, program PowerShell automatycznie wylicza elementy w kolekcji i zwraca wartość właściwości dla każdego elementu.

To polecenie zwraca wartość właściwości DisplayName każdej usługi, która Get-Service zwraca.

(Get-Service).DisplayName

Application Experience
Application Layer Gateway Service
Windows All-User Install Agent
Application Identity
Application Information
...

Większość kolekcji w programie PowerShell ma właściwość Count zwracającą liczbę elementów w kolekcji.

(Get-Service).Count

176

Jeśli właściwość istnieje na poszczególnych obiektach i w kolekcji, zwracana jest tylko właściwość kolekcji.

PS> $collection = @(
     [pscustomobject]@{Length = "foo"}
     [pscustomobject]@{Length = "bar"}
)

# PowerShell returns the collection's Length.
$collection.Length
2

# Get the Length property of each item in the collection.
PS> $collection.GetEnumerator().Length
foo
bar

Aby uzyskać więcej informacji, zobacz about_Member-Access_Enumeration.

Zobacz także

  • Last updated on