about_Properties
Kurze Beschreibung
Beschreibt die Verwendung von Objekteigenschaften in PowerShell.
Lange Beschreibung
PowerShell verwendet strukturierte Auflistungen von Informationen, die als Objekte bezeichnet werden, um die Elemente in Datenspeichern oder den Zustand des Computers darzustellen. In der Regel arbeiten Sie mit Objekten, die Teil der Microsoft .NET Framework sind, aber Sie können auch benutzerdefinierte Objekte in PowerShell erstellen.
Die Zuordnung zwischen einem Element und seinem Objekt ist sehr nah. Wenn Sie ein Objekt ändern, ändern Sie in der Regel das Element, das es darstellt. Wenn Sie beispielsweise eine Datei in PowerShell abrufen, erhalten Sie nicht die eigentliche Datei. Stattdessen erhalten Sie ein FileInfo-Objekt , das die Datei darstellt. Wenn Sie das FileInfo-Objekt ändern, ändert sich auch die Datei.
Die meisten Objekte verfügen über Eigenschaften. Eigenschaften sind die Daten, die einem -Objekt zugeordnet sind. Verschiedene Objekttypen weisen unterschiedliche Eigenschaften auf. Ein FileInfo-Objekt , das eine Datei darstellt, verfügt beispielsweise über eine IsReadOnly-Eigenschaft , die enthält $True
, ob die Datei über das schreibgeschützte Attribut verfügt und $False
wenn dies nicht der Fall ist. Ein DirectoryInfo-Objekt , das ein Dateisystemverzeichnis darstellt, verfügt über eine Parent-Eigenschaft , die den Pfad zum übergeordneten Verzeichnis enthält.
Objekteigenschaften
Verwenden Sie das Cmdlet, um die Get-Member
Eigenschaften eines Objekts abzurufen. Um beispielsweise die Eigenschaften eines FileInfo-Objekts abzurufen, verwenden Sie das Get-ChildItem
Cmdlet, um das FileInfo-Objekt abzurufen, das eine Datei darstellt. Verwenden Sie dann einen Pipelineoperator (|
), um das FileInfo-Objekt an zu Get-Member
senden. Der folgende Befehl ruft die pwsh.exe
Datei ab und sendet sie an Get-Member
. Die $PSHOME
automatische Variable enthält den Pfad des PowerShell-Installationsverzeichnisses.
Get-ChildItem $PSHOME\pwsh.exe | Get-Member
Die Ausgabe des Befehls listet die Member des FileInfo-Objekts auf. Member umfassen sowohl Eigenschaften als auch Methoden. Wenn Sie in PowerShell arbeiten, haben Sie Zugriff auf alle Member der Objekte.
Um nur die Eigenschaften eines Objekts und nicht die Methoden abzurufen, verwenden Sie den MemberType-Parameter des Get-Member
Cmdlets mit dem Wert von Property
, wie im folgenden Beispiel gezeigt.
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;}
Nachdem Sie die Eigenschaften gefunden haben, können Sie sie in Ihren PowerShell-Befehlen verwenden.
Eigenschaftswerte
Obwohl jedes Objekt eines bestimmten Typs über dieselben Eigenschaften verfügt, beschreiben die Werte dieser Eigenschaften das jeweilige Objekt. Beispielsweise verfügt jedes FileInfo-Objekt über eine CreationTime-Eigenschaft , aber der Wert dieser Eigenschaft unterscheidet sich für jede Datei.
Die gängigste Methode zum Abrufen der Werte der Eigenschaften eines Objekts ist die Verwendung des Memberzugriffsoperators (.
). Geben Sie einen Verweis auf das Objekt ein, z. B. eine Variable, die das -Objekt enthält, oder einen Befehl, der das Objekt abruft. Geben Sie dann den Operator (.
) gefolgt vom Eigenschaftennamen ein.
Der folgende Befehl zeigt beispielsweise den Wert der CreationTime-Eigenschaft der pwsh.exe
Datei an. Der Get-ChildItem
Befehl gibt ein FileInfo-Objekt zurück, das das pwsh.exe file
darstellt. Der Befehl wird in Klammern eingeschlossen, um sicherzustellen, dass er ausgeführt wird, bevor auf Eigenschaften zugegriffen wird.
(Get-ChildItem $PSHOME\pwsh.exe).CreationTime
Tuesday, June 14, 2022 5:17:14 PM
Sie können ein Objekt auch in einer Variablen speichern und dann seine Eigenschaften mithilfe der Memberzugriffsmethode (.
) abrufen, wie im folgenden Beispiel gezeigt:
$a = Get-ChildItem $PSHOME\pwsh.exe
$a.CreationTime
Tuesday, June 14, 2022 5:17:14 PM
Sie können auch die Select-Object
Cmdlets und Format-List
verwenden, um die Eigenschaftswerte eines Objekts anzuzeigen. Select-Object
und Format-List
verfügen jeweils über einen Property-Parameter . Sie können den Property-Parameter verwenden, um eine oder mehrere Eigenschaften und deren Werte anzugeben. Alternativ können Sie das Wildcardzeichen (*
) verwenden, um alle Eigenschaften darzustellen.
Der folgende Befehl zeigt beispielsweise die Werte aller Eigenschaften der pwsh.exe-Datei an.
Get-ChildItem $PSHOME\pwsh.exe | Format-List -Property *
PSPath : Microsoft.PowerShell.Core\FileSystem::C:\Program Files\PowerShell\7\pwsh.exe
PSParentPath : Microsoft.PowerShell.Core\FileSystem::C:\Program Files\PowerShell\7
PSChildName : pwsh.exe
PSDrive : C
PSProvider : Microsoft.PowerShell.Core\FileSystem
PSIsContainer : False
Mode : -a---
ModeWithoutHardLink : -a---
VersionInfo : File: C:\Program Files\PowerShell\7\pwsh.exe
InternalName: pwsh.dll
OriginalFilename: pwsh.dll
FileVersion: 7.3.9.500
FileDescription: pwsh
Product: PowerShell
ProductVersion: 7.3.9 SHA: 116d193ed28dcc6914653c799846bbf379cea0fb
Debug: False
Patched: False
PreRelease: False
PrivateBuild: False
SpecialBuild: False
Language: Language Neutral
BaseName : pwsh
ResolvedTarget : C:\Program Files\PowerShell\7\pwsh.exe
Target :
LinkType :
Length : 293312
DirectoryName : C:\Program Files\PowerShell\7
Directory : C:\Program Files\PowerShell\7
IsReadOnly : False
FullName : C:\Program Files\PowerShell\7\pwsh.exe
Extension : .exe
Name : pwsh.exe
Exists : True
CreationTime : 10/25/2023 7:00:18 PM
CreationTimeUtc : 10/26/2023 12:00:18 AM
LastAccessTime : 11/14/2023 5:14:36 PM
LastAccessTimeUtc : 11/14/2023 11:14:36 PM
LastWriteTime : 10/25/2023 7:00:18 PM
LastWriteTimeUtc : 10/26/2023 12:00:18 AM
LinkTarget :
UnixFileMode : -1
Attributes : Archive
Statische Eigenschaften
Sie können die statischen Eigenschaften von .NET-Klassen in PowerShell verwenden. Statische Eigenschaften sind Eigenschaften der -Klasse, im Gegensatz zu Standardeigenschaften, die Eigenschaften eines Objekts sind.
Verwenden Sie den Static-Parameter des Get-Member
Cmdlets, um die statischen Eigenschaften einer Klasse abzurufen. Mit dem folgenden Befehl werden beispielsweise die statischen Eigenschaften der System.DateTime
-Klasse abgerufen.
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;}
Verwenden Sie die folgende Syntax, um den Wert einer statischen Eigenschaft abzurufen.
[<ClassName>]::<Property>
Der folgende Befehl ruft beispielsweise den Wert der statischen UtcNow-Eigenschaft der System.DateTime
-Klasse ab.
[System.DateTime]::UtcNow
Memberzugriffsenumeration
Wenn Sie ab PowerShell 3.0 den Memberzugriffsoperator (.
) verwenden, um auf eine Eigenschaft zuzugreifen, die in einer Listensammlung nicht vorhanden ist, listet PowerShell automatisch die Elemente in der Auflistung auf und gibt den Wert der Eigenschaft für jedes Element zurück. Weitere Informationen finden Sie unter about_Member-Access_Enumeration.
Beispiele
Dieser Befehl gibt den Wert der DisplayName-Eigenschaft jedes zurückgegebenen Get-Service
Diensts zurück.
(Get-Service).DisplayName
Application Experience
Application Layer Gateway Service
Windows All-User Install Agent
Application Identity
Application Information
...
Alle Auflistungen verfügen über eine Count-Eigenschaft , die die Anzahl der Objekte in der Auflistung zurückgibt.
(Get-Service).Count
176
Ab PowerShell 3.0 können Sie die Count - oder Length-Eigenschaft von Singletonobjekten abrufen, die keine Sammlungen sind.
(Get-Service Audiosrv).Count
1
Einige Objekte verfügen jedoch über eine Length-Eigenschaft . Beispielsweise ist die Länge einer Zeichenfolge die Anzahl der Zeichen in der Zeichenfolge. Die Count-Eigenschaft ist die Anzahl der Instanzen des -Objekts.
PS> $str = 'string'
PS> $str.Length
6
PS> $str.Count
1
Wenn eine -Eigenschaft für die einzelnen Objekte und für die Auflistung vorhanden ist, wird nur die -Eigenschaft der Auflistung zurückgegeben.
$collection = @(
[pscustomobject]@{length = "foo"}
[pscustomobject]@{length = "bar"}
)
# PowerShell returns the collection's Length.
$collection.length
2